DeviceMapper 구성 요소

Haply Inverse Unity 플러그인의 DeviceMapper 컴포넌트는 Inverse3 및 VerseGrip과 같은 Haply 기기를 인식하고, 이를 씬의 GameObject 및 Device Controller에 매핑하고 연결하는 역할을 합니다. 이 컴포넌트는 해당 기기와의 상호 작용을 위한 통일된 인터페이스를 제공하며, 런타임 조건에 기반한 동적인 제어 및 구성을 가능하게 합니다.

개요

DeviceMapper의 주요 기능은 연결된 장치를 나열하고 이를 씬의 디바이스 컨트롤러에 할당하는 것입니다.

기본 설정

DeviceMapper 구성 요소에는 다음과 같은 기본 설정이 포함되어 있습니다:

• 장치 목록 자동 가져오기: 이 옵션이 활성화되면 DeviceMapper는 시작 시 HTTP 요청을 통해 연결된 장치 목록을 자동으로 가져옵니다.
• 자동 할당: 이 기능이 활성화되면 DeviceMapper는 연결된 장치를 해당 장면의 디바이스 컨트롤러에 자동으로 할당합니다.
• 자동 연결: 이 기능이 활성화되면 DeviceMapper가 장치에 대한 WebSocket 연결을 자동으로 설정합니다.

고급 설정

버튼을 클릭하면 Show Advanced Settings 해당 구성 요소의 추가 설정에 액세스할 수 있습니다 디바이스맵퍼:

• 장치 목록 URI: 연결된 기기 목록을 가져오기 위한 URI입니다. 기본값은 http://localhost:10000/3.1/devices.
• 가져오기 재시도 지연: 첫 번째 요청이 실패할 경우, 장치 목록을 다시 불러오기까지의 대기 시간(초). 기본값은 5.
• 서버 URI: 장치 서버에 연결하기 위한 URI입니다. 기본값은 ws://localhost:10001.

통계

해당 영역이 Statistics 확장된 경우, 다음은 디바이스맵퍼 JSON의 연결률 및 페이로드 내용에 대한 통계가 제공됩니다. 이러한 통계는 개발자가 기기를 모니터링 및 관리하고, 개발 과정에서 오류를 진단하는 데 도움이 됩니다.

준비 완료 이벤트

해당 구성 요소 DeviceMapper 해결했다 Ready-연결된 모든 기기가 할당되고 연결되면 이 이벤트가 발생합니다. 이 이벤트는 다음과 같은 기기 게터 메서드들이 GetInverse3Controller 또는 GetVerseGripController, 이를 통해 장면의 디바이스 컨트롤러를 불러와 추가적인 상호작용을 수행할 수 있습니다.

장치 컨트롤러 목록

Unity 에디터에서는 DeviceMapper 씬에 연결된 기기와 연동된 디바이스 컨트롤러의 동적 목록이 준비되어 있습니다. 이 목록에는 기기 유형, ID, 연결 상태 등의 세부 정보가 포함되어 있습니다.

확장된 용도

스크립트에서 DeviceMapper 컴포넌트를 사용하여 장치를 수동으로 나열, 할당 및 연결하는 방법에 대한 단계별 안내서는 ‘장치 매핑(Device Mapping)’ 튜토리얼에서 확인할 수 있습니다.