メインコンテンツへスキップ

DeviceMapper コンポーネント

Haply Inverse Unity プラグインのDeviceMapperコンポーネントは、Inverse3 やVerseGripなどのHaply デバイスの検出、マッピング、接続を管理し、シーン内のGameObjectやデバイスコントローラーに関連付けるために設計されています。 これにより、これらのデバイスと対話するための統一されたインターフェースが提供され、実行時の状況に応じた動的な制御や設定が可能になります。

概要​

DeviceMapperの主な機能は、接続されているデバイスを一覧表示し、それらをシーンのデバイスコントローラーにマッピングすることです。

DeviceMapper コンポーネント

基本設定​

DeviceMapperコンポーネントには、以下の基本設定があります：

  • デバイス一覧の自動取得：有効にすると、DeviceMapper は起動時に HTTP リクエストを使用して、接続されているデバイスの一覧を自動的に取得します。
  • 自動割り当て：有効にすると、DeviceMapper は接続されたデバイスを、シーンのデバイスコントローラーに自動的にマッピングします。
  • 自動接続：有効にすると、DeviceMapper はデバイスへの WebSocket 接続を自動的に確立します。

詳細設定​

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コンポーネントを使用して、デバイスの一覧表示、マッピング、接続を手動で行う手順については、「デバイスマッピング」のチュートリアルを参照してください。