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

DeviceMapper コンポーネント

Haply Inverse Unity プラグインのDeviceMapperコンポーネントは、Haply デバイス（Inverse3 やVerseGripなど）の検出、マッピング、接続を管理し、それらをシーン内の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データペイロードの内容に関する統計情報を提供し、開発者が開発プロセスにおいてデバイスを監視・管理し、問題のトラブルシューティングを容易に行えるように支援します。

「レディ」事件​

接続済みのすべてのデバイスのマッピングと接続が完了したら、DeviceMapper コンポーネントがトリガーされる Ready 事件。 このイベントは、この時点でデバイスのゲッターメソッドを安全に呼び出せることを示しています（例： GetInverse3Controller あるいは GetVerseGripController），シーン内のデバイスコントローラーを取得し、その後の操作を行う。

機器コントローラ一覧​

Unity エディタでは、DeviceMapper 接続済みのデバイスに関連付けられたシーン・デバイス・コントローラーを表示する動的なリストが提供されます。 このリストには、デバイスの種類、ID、接続状態などの詳細情報が含まれています。

機器一覧

高度な使い方​

スクリプト内でDeviceMapperコンポーネントを使用して、デバイスを手動で一覧表示、マッピング、接続する手順については、「デバイスマッピング」チュートリアルを参照してください。