DeviceMapper 컴포넌트

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

개요

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

기본 설정

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

• Auto Fetch Devices List: 활성화하면 DeviceMapper가 시작 시 http 요청을 사용하여 연결된 디바이스 목록을 자동으로 가져옵니다.
• Auto Assign: 활성화하면 DeviceMapper가 연결된 디바이스를 씬의 Device Controllers에 자동으로 매핑합니다.
• Auto Connect: 활성화하면 DeviceMapper가 디바이스와의 websocket 연결을 자동으로 엽니다.

고급 설정

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

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

통계

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

Ready 이벤트

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

Device Controllers 목록

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

고급 사용법

스크립트에서 DeviceMapper 컴포넌트를 사용하여 디바이스를 수동으로 나열, 매핑, 연결하는 방법은 단계별 안내를 담은 Device Mapping 튜토리얼을 참고하십시오.