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

DeviceMapperコンポーネント

プラグイン「Haply Inverse Unity」に含まれるコンポーネント「DeviceMapper」は、Inverse3 やVerseGripといったHaply デバイスを検出し、シーン内のGameObjectやDevice Controllerに割り当て、接続するためのものです。 このコンポーネントは、これらのデバイスとやり取りするための統一されたインターフェースを提供し、実行時の条件に基づいた動的な制御や設定を可能にします。

概要​

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 oder GetVerseGripController, シーンのデバイスコントローラーを安全に取得し、さらなるインタラクションに活用することができます。

デバイスコントローラのリスト​

Unityエディタでは、 DeviceMapper シーン内の、接続されたデバイスに関連付けられたデバイスコントローラーの動的リストが用意されています。 このリストには、デバイスタイプ、ID、接続ステータスなどの詳細情報が含まれています。

機器一覧

高度な活用法​

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