ZepetoinputControl
형식 | 설명 |
|---|---|
이동, 점프, 더블 점프 등 플레이어 전용 액션을 처리합니다. | |
ZEPETO World 내 카메라 관련 입력 액션을 관리합니다. | |
UIActions | UI 관련 다양한 입력 액션을 처리합니다. |
플레이어 액션 인터페이스입니다. | |
카메라 액션 인터페이스입니다. | |
IUIActions | UI 액션 인터페이스입니다. |
PlayerActions
class
이동, 점프, 더블 점프 등 플레이어 전용 액션을 처리합니다.
속성
이름 | 형식 | 설명 |
|---|---|---|
Move | InputAction | 플레이어 이동에 대한 입력 액션을 가져옵니다. |
Jump | InputAction | 플레이어 점프에 대한 입력 액션을 가져옵니다. |
DoubleJump | InputAction | 플레이어 더블 점프에 대한 입력 액션을 가져옵니다. |
enabled | boolean | 플레이어 입력 액션의 현재 활성화 상태를 나타냅니다. |
메서드
Get
Get() → InputActionMap
플레이어 액션에 연결된 InputActionMap을 가져옵니다.
반환값: InputActionMap — 플레이어 액션의 InputActionMap입니다.
Enable
Enable() → void
플레이어 액션 맵을 활성화하여 플레이어 입력 액션을 사용할 수 있도록 합니다.
Disable
Disable() → void
플레이어 액션 맵을 비활성화하여 플레이어 입력 액션을 사용할 수 없도록 합니다.
SetCallbacks
SetCallbacks(instance: IPlayerActions) → void
instance의 콜백 메서드를 각 플레이어 액션에 연결합니다.
매개변수 | 형식 | 설명 |
|---|---|---|
instance | IPlayerActions 인터페이스를 구현한 객체입니다. |
CameraActions
class
ZEPETO World 내 카메라 관련 입력 액션을 관리합니다.
속성
이름 | 형식 | 설명 |
|---|---|---|
Scroll | InputAction | 카메라 스크롤에 대한 입력 액션을 반환합니다. |
PrimaryTouchPosition | InputAction | 첫 번째 터치의 위치를 감지하는 입력 액션을 반환합니다. |
PrimaryTouchContact | InputAction | 첫 번째 터치의 접촉을 감지하는 입력 액션을 반환합니다. |
SecondaryTouchPosition | InputAction | 두 번째 터치의 위치를 감지하는 입력 액션을 반환합니다. |
SecondaryTouchContact | InputAction | 두 번째 터치의 접촉을 감지하는 입력 액션을 반환합니다. |
TertiaryTouchPosition | InputAction | 세 번째 터치의 위치를 감지하는 입력 액션을 반환합니다. |
TertiaryTouchContact | InputAction | 세 번째 터치의 접촉을 감지하는 입력 액션을 반환합니다. |
enabled | boolean | 카메라 액션 맵 내 입력 액션의 현재 활성화 여부를 나타냅니다. |
메서드
Get
Get() → InputActionMap
ZepetoInputControl에서 카메라 액션에 연결된 InputActionMap을 가져옵니다.
반환값: InputActionMap — 카메라 관련 입력 액션의 모음인 InputActionMap 객체를 반환합니다.
Enable
Enable() → void
카메라 액션 맵 내 모든 입력 액션을 활성화합니다.
Disable
Disable() → void
카메라 액션 맵 내 모든 입력 액션을 비활성화합니다.
SetCallbacks
SetCallbacks(instance: ICameraActions) → void
카메라 액션의 콜백 인터페이스를 설정하여 액션 핸들러를 외부에서 구현할 수 있도록 합니다.
매개변수 | 형식 | 설명 |
|---|---|---|
instance | ICameraActions 인터페이스를 구현한 객체입니다. |
UIActions
class
UI 관련 다양한 입력 액션을 처리합니다.
속성
이름 | 형식 | 설명 |
|---|---|---|
Navigate | InputAction | 메뉴나 목록과 같은 UI 요소 간의 이동을 처리하는 액션입니다. 일반적으로 방향키, 조이스틱 조작, 스와이프 제스처 등 방향 입력을 사용합니다. |
Submit | InputAction | 강조 표시된 UI 요소를 확인하거나 선택하는 액션으로, 'Enter' 또는 'OK' 명령에 해당합니다. |
Cancel | InputAction | 취소 또는 '뒤로' 명령에 해당하는 액션으로, 이전 메뉴로 돌아가거나 현재 열려 있는 UI 창을 닫을 수 있습니다. |
Point | InputAction | UI의 포인팅 동작을 처리합니다. 마우스 커서를 움직이거나 터치스크린에서 손가락 접촉 지점을 옮기는 것과 유사합니다. |
Click | InputAction | UI 요소를 클릭하는 액션으로, 마우스 클릭이나 화면 탭에 해당합니다. |
ScrollWheel | InputAction | 마우스 휠이나 터치패드 제스처 등의 스크롤 입력을 받는 데 사용하는 액션입니다. |
MiddleClick | InputAction | 마우스 가운데 버튼을 누르는 액션입니다. |
RightClick | InputAction | 마우스 오른쪽 클릭에 해당하는 액션으로, 주로 컨텍스트 메뉴를 열거나 보조 동작을 실행할 때 사용합니다. |
TrackedDevicePosition | InputAction | VR 컨트롤러나 모션 트래킹 장치 등 추적 대상 기기의 위치 데이터를 가져옵니다. |
TrackedDeviceOrientation | InputAction | 기기의 방향을 추적합니다. 주로 VR 또는 AR 환경에서 기기가 가리키는 방향을 감지할 때 사용합니다. |
enabled | boolean | UI 액션이 현재 활성화되어 입력에 반응하는 상태인지 나타냅니다. |
메서드
Get
Get() → InputActionMap
UI 액션에 연결된 InputActionMap을 반환합니다.
반환값: InputActionMap — 반환된 InputActionMap에는 ZepetoInputControl 클래스에서 UI 상호작용을 위해 정의된 모든 입력 액션이 포함됩니다.
Enable
Enable() → void
UI 입력 액션을 활성화하여 사용자 입력에 반응하도록 합니다.
Disable
Disable() → void
UI 입력 액션을 비활성화하여 사용자 입력에 반응하지 않도록 합니다.
SetCallbacks
SetCallbacks(instance: IUIActions) → void
UI 액션의 콜백 메서드를 등록합니다. instance가 구현한 IUIActions 인터페이스의 정의에 따라 각 액션을 해당 이벤트 핸들러에 연결합니다.
매개변수 | 형식 | 설명 |
|---|---|---|
instance | IUIActions | IUIActions 인터페이스를 구현한 객체입니다. |
IPlayerActions
interface
플레이어 액션 인터페이스입니다.
메서드
OnMove
OnMove(context: CallbackContext) → void
이동 시 호출됩니다.
매개변수 | 형식 | 설명 |
|---|---|---|
context | CallbackContext | 콜백 컨텍스트. |
OnJump
OnJump(context: CallbackContext) → void
점프 시 호출됩니다.
매개변수 | 형식 | 설명 |
|---|---|---|
context | CallbackContext | 콜백 컨텍스트. |
OnDoubleJump
OnDoubleJump(context: CallbackContext) → void
더블 점프 시 호출됩니다.
매개변수 | 형식 | 설명 |
|---|---|---|
context | CallbackContext | 콜백 컨텍스트. |
ICameraActions
interface
카메라 액션 인터페이스입니다.
메서드
OnScroll
OnScroll(context: CallbackContext) → void
스크롤 시 호출됩니다.
매개변수 | 형식 | 설명 |
|---|---|---|
context | CallbackContext | 콜백 컨텍스트. |
OnPrimaryTouchPosition
OnPrimaryTouchPosition(context: CallbackContext) → void
첫 번째 터치 위치가 변경될 때 호출됩니다.
매개변수 | 형식 | 설명 |
|---|---|---|
context | CallbackContext | 콜백 컨텍스트. |
OnPrimaryTouchContact
OnPrimaryTouchContact(context: CallbackContext) → void
첫 번째 터치가 접촉될 때 호출됩니다.
매개변수 | 형식 | 설명 |
|---|---|---|
context | CallbackContext | 콜백 컨텍스트. |
OnSecondaryTouchPosition
OnSecondaryTouchPosition(context: CallbackContext) → void
스크롤 시 호출됩니다.
매개변수 | 형식 | 설명 |
|---|---|---|
context | CallbackContext | 콜백 컨텍스트. |
OnSecondaryTouchContact
OnSecondaryTouchContact(context: CallbackContext) → void
두 번째 터치가 접촉될 때 호출됩니다.
매개변수 | 형식 | 설명 |
|---|---|---|
context | CallbackContext | 콜백 컨텍스트. |
OnTertiaryTouchPosition
OnTertiaryTouchPosition(context: CallbackContext) → void
세 번째 터치 위치가 변경될 때 호출됩니다.
매개변수 | 형식 | 설명 |
|---|---|---|
context | CallbackContext | 콜백 컨텍스트. |
OnTertiaryTouchContact
OnTertiaryTouchContact(context: CallbackContext) → void
세 번째 터치가 접촉될 때 호출됩니다.
매개변수 | 형식 | 설명 |
|---|---|---|
context | CallbackContext | 콜백 컨텍스트. |
IUIActions
interface
UI 액션 인터페이스입니다.
메서드
OnNavigate
OnNavigate(context: CallbackContext) → void
탐색 시 호출됩니다.
매개변수 | 형식 | 설명 |
|---|---|---|
context | CallbackContext | 콜백 컨텍스트. |
OnSubmit
OnSubmit(context: CallbackContext) → void
확인 시 호출됩니다.
매개변수 | 형식 | 설명 |
|---|---|---|
context | CallbackContext | 콜백 컨텍스트. |
OnCancel
OnCancel(context: CallbackContext) → void
취소 시 호출됩니다.
매개변수 | 형식 | 설명 |
|---|---|---|
context | CallbackContext | 콜백 컨텍스트. |
OnPoint
OnPoint(context: CallbackContext) → void
포인팅 시 호출됩니다.
매개변수 | 형식 | 설명 |
|---|---|---|
context | CallbackContext | 콜백 컨텍스트. |
OnClick
OnClick(context: CallbackContext) → void
클릭 시 호출됩니다.
매개변수 | 형식 | 설명 |
|---|---|---|
context | CallbackContext | 콜백 컨텍스트. |
OnScrollWheel
OnScrollWheel(context: CallbackContext) → void
스크롤 휠 조작 시 호출됩니다.
매개변수 | 형식 | 설명 |
|---|---|---|
context | CallbackContext | 콜백 컨텍스트. |
OnMiddleClick
OnMiddleClick(context: CallbackContext) → void
가운데 클릭 시 호출됩니다.
매개변수 | 형식 | 설명 |
|---|---|---|
context | CallbackContext | 콜백 컨텍스트. |
OnRightClick
OnRightClick(context: CallbackContext) → void
오른쪽 클릭 시 호출됩니다.
매개변수 | 형식 | 설명 |
|---|---|---|
context | CallbackContext | 콜백 컨텍스트. |
OnTrackedDevicePosition
OnTrackedDevicePosition(context: CallbackContext) → void
추적 대상 기기의 위치가 변경될 때 호출됩니다.
매개변수 | 형식 | 설명 |
|---|---|---|
context | CallbackContext | 콜백 컨텍스트. |
OnTrackedDeviceOrientation
OnTrackedDeviceOrientation(context: CallbackContext) → void
추적 대상 기기의 방향이 변경될 때 호출됩니다.
매개변수 | 형식 | 설명 |
|---|---|---|
context | CallbackContext | 콜백 컨텍스트. |