플레이어 이동

플레이어를 순간이동시키거나, 씬 내의 새 위치로 걸어가게 합니다

장면에서 플레이어의 위치를 변경하려면 movePlayerTo() 함수를 사용하세요. 플레이어를 다시 생성하거나, 체크포인트를 설정하거나, 컷신의 일부로 플레이어가 특정 지점까지 걸어가게 할 때 사용할 수 있습니다.

💡 팁: 플레이어를 이동시키는 가장 쉬운 방법은 Creator Hub의 Scene Editor. 노코드 플레이어 이동 또는 여기로 플레이어 이동 Actions는 다음을 참조하세요 모든 항목을 스마트 아이템으로 만들기.

이 함수는 다음 속성을 가진 객체를 인자로 받습니다:

• newRelativePosition: 플레이어를 배치할 위치로, Vector3로 표현됩니다.

• cameraTarget: (선택 사항) 카메라가 바라볼 방향으로, 바라볼 공간의 한 지점 좌표를 나타내는 Vector3로 표현됩니다. 값이 제공되지 않으면 카메라는 이동 전과 동일한 회전을 유지합니다.

• avatarTarget: (선택 사항) 아바타가 바라볼 방향으로, 바라볼 공간의 한 지점 좌표를 나타내는 Vector3로 표현됩니다. 값이 제공되지 않으면 아바타는 이동 전과 동일한 회전을 유지합니다. 플레이어가 1인칭 카메라 모드인 경우 카메라와 아바타의 회전은 같습니다.

• 지속 시간: (선택 사항) 전환에 걸릴 시간(초)입니다. 값이 제공되지 않으면 전환은 즉시 발생합니다. 지속 시간이 제공되면 아바타는 이 새 위치로 걸어가거나 달려갑니다.

📔 참고: 전환 중에는 아바타가 충돌체의 영향을 받지 않으므로 객체를 통과할 수 있습니다.

import { movePlayerTo } from '~system/RestrictedActions'

// 엔티티 생성
const myEntity = engine.addEntity()
MeshRenderer.setBox(myEntity)
MeshCollider.setBox(myEntity)

Transform.create(myEntity, {
	position: { x: 4, y: 1, z: 4 },
})

// 엔티티에 동작 부여
pointerEventsSystem.onPointerDown(
	{
		entity: myEntity,
		opts: { button: InputAction.IA_POINTER, hoverText: '클릭' },
	},
	function () {
		// 플레이어 다시 생성
		movePlayerTo({
			newRelativePosition: Vector3.create(1, 0, 1),
			cameraTarget: Vector3.create(8, 1, 8),
			avatarTarget: Vector3.create(8, 1, 8),
		})
	}
)

플레이어의 이동은 확인 화면이나 카메라 전환 없이 즉시 발생합니다.

📔 참고: 플레이어는 이미 장면의 경계 안에 서 있는 경우에만 이동할 수 있으며, 장면 경계의 한계 안에 있는 위치로만 이동할 수 있습니다. 다음은 사용할 수 없습니다 movePlayerTo() 플레이어를 다른 장면으로 이동시키는 데. 플레이어를 다른 장면으로 이동시키려면 다음을 참조하세요 텔레포트.

이 movePlayerTo() 함수는 await 가능하므로, 이동에 지속 시간이 있다면 await 플레이어가 목적지에 도착할 때까지 기다리는 데 사용할 수 있습니다.

import { movePlayerTo } from '~system/RestrictedActions'

pointerEventsSystem.onPointerDown(
	{
		entity: myEntity,
		opts: { button: InputAction.IA_POINTER, hoverText: '클릭' },
	},
	async function () {
		await movePlayerTo({
			newRelativePosition: Vector3.create(1, 0, 1),
			cameraTarget: Vector3.create(8, 1, 8),
			avatarTarget: Vector3.create(8, 1, 8),
			duration: 2,
		})
	}
)

플레이어가 전환 중에 이동을 시도하면 전환이 중단되고 movePlayerTo 함수는 절대 resolve되지 않습니다. 전환이 진행되는 동안 InputModifier 컴포넌트를 사용해 모든 입력을 비활성화하면 이 동작을 방지할 수 있습니다. 다음을 참조하세요 이동 제한.

import { movePlayerTo } from '~system/RestrictedActions'
import {InputModifier, engine} from '@dcl/sdk/ecs'

pointerEventsSystem.onPointerDown(
	{
		entity: myEntity,
		opts: { button: InputAction.IA_POINTER, hoverText: '클릭' },
	},
	async function () {

		// 모든 입력 비활성화
		InputModifier.create(engine.PlayerEntity, {
			mode: InputModifier.Mode.Standard({
				disableAll: true,
			}),
		})

		// 플레이어 이동
		await movePlayerTo({
			newRelativePosition: Vector3.create(1, 0, 1),
			cameraTarget: Vector3.create(8, 1, 8),
			avatarTarget: Vector3.create(8, 1, 8),
			duration: 2,
		})

		// 모든 입력 활성화
		InputModifier.deleteFrom(engine.PlayerEntity)
	}
)

📔 참고: 또한 await의 결과를 저장하여 해당 결과의 성공 프로퍼티를 통해 이동이 중단되었는지(예: 입력으로 인한 이동) 또는 성공적으로 완료되었는지 알 수 있습니다.

💡 팁: 플레이어를 다른 장면으로 또는 Genesis City 맵의 다른 좌표로 이동시키려면 다음을 참조하세요 텔레포트.