--- title: ZepetoinputControl slug: world-sdk-guide-kr/zepetoinputcontrol docTags: createdAt: 2026-09-04T04:03:14.267Z --- | 형식 | 설명 | | ----------------------------------- | ----------------------------------- | | [PlayerActions](./#playeractions) | 이동, 점프, 더블 점프 등 플레이어 전용 액션을 처리합니다. | | [CameraActions](./#cameraactions) | ZEPETO World 내 카메라 관련 입력 액션을 관리합니다. | | [UIActions](./#uiactions) | UI 관련 다양한 입력 액션을 처리합니다. | | [IPlayerActions](./#iplayeractions) | 플레이어 액션 인터페이스입니다. | | [ICameraActions](./#icameraactions) | 카메라 액션 인터페이스입니다. | | [IUIActions](./#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](./#iplayeractions) | `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](./#icameraactions) | `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) | `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` | 콜백 컨텍스트. |