DeviceMapper 컴포넌트

Haply Inverse Unity 플러그인의 DeviceMapper 컴포넌트는 Inverse3 및 VerseGrip과 같은 Haply 장치를 탐색, 매핑, 연결하여 씬의 GameObject 및 Device Controllers와함께 관리할 수 있도록 설계되었습니다. 이 컴포넌트는 해당 장치와 상호작용하기 위한 통합 인터페이스를 제공하며, 런타임 조건에 따라 동적인 제어와 구성을 가능하게 합니다.

개요

DeviceMapper의주요 기능은 연결된 디바이스 목록을 표시하고, 이를 씬의 Device Controllers에 매핑하는 것입니다.

기본 설정

DeviceMapper 컴포넌트에는 다음과 같은 기본 설정이 포함되어 있습니다:

• 장치 목록 자동 가져오기: 이 기능을 활성화하면 DeviceMapper가 시작 시 HTTP 요청을 사용하여 연결된 장치 목록을 자동으로 가져옵니다.
• 자동 할당: 이 기능을 활성화하면 DeviceMapper가 연결된 디바이스를 씬의 디바이스 컨트롤러에 자동으로 매핑합니다.
• 자동 연결: 이 기능을 활성화하면 DeviceMapper가 장치와의 웹소켓 연결을 자동으로 설정합니다.

고급 설정

Show Advanced Settings 버튼을 클릭하면 디바이스맵퍼 컴포넌트의 추가 설정을 확인할 수 있습니다:

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

통계

Statistics 폴드아웃을 펼치면 디바이스맵퍼연결 속도와 JSON 페이로드 내용에 대한 통계를 제공합니다. 이를 통해 개발자는 기기를 모니터링하고 관리할 수 있으며, 개발 과정에서 발생하는 문제 해결을 더 쉽게 수행할 수 있습니다.

Ready 이벤트

DeviceMapper 컴포넌트는 연결된 모든 기기가 매핑되고 연결되면 Ready 이벤트를 발생시킵니다. 이 이벤트는 GetInverse3Controller 또는 GetVerseGripController와 같은 디바이스 게터 메서드를 안전하게 사용할 수 있는 시점을 알려주며, 이후 상호작용을 위해 씬의 디바이스 컨트롤러를 가져올 수 있습니다.

장치 컨트롤러 목록

Unity 에디터에서 DeviceMapper는 연결된 디바이스와 관련된 씬의 디바이스 컨트롤러 목록을 동적으로 제공합니다. 이 목록에는 디바이스 유형, ID, 연결 상태 등의 세부 정보가 포함됩니다.

고급 사용법

스크립트에서 DeviceMapper 컴포넌트를 사용하여 장치를 수동으로 나열, 매핑 및 연결하는 방법은 단계별 안내가 포함된 ‘Device Mapping’ 튜토리얼을 참조하십시오.