Zum Hauptinhalt springen

DeviceMapper-Komponente

Die Komponente DeviceMapper im Plugin Haply Inverse Unity dient der Erkennung, Zuordnung und Verbindung von Haply-Geräten wie Inverse3 und VerseGrip mit den GameObjects der Szene und den Device Controllers. Sie bietet eine einheitliche Schnittstelle für die Interaktion mit diesen Geräten und ermöglicht eine dynamische Steuerung und Konfiguration auf Basis von Laufzeitbedingungen.

Überblick​

Die Hauptfunktion des DeviceMapper besteht darin, verbundene Geräte aufzulisten und den Device Controllern der Szene zuzuordnen.

DeviceMapper-Komponente

Grundeinstellungen​

Die Komponente DeviceMapper umfasst folgende Grundeinstellungen:

  • Auto Fetch Devices List: Wenn aktiviert, ruft der DeviceMapper beim Start die Liste der verbundenen Geräte automatisch per HTTP-Anfrage ab.
  • Auto Assign: Wenn aktiviert, ordnet der DeviceMapper verbundene Geräte automatisch den Device Controllern der Szene zu.
  • Auto Connect: Wenn aktiviert, öffnet der DeviceMapper automatisch eine WebSocket-Verbindung zu den Geräten.

Erweiterte Einstellungen​

DeviceMapper, erweiterte Einstellungen

Durch Klick auf die Schaltfläche Show Advanced Settings erhalten Sie Zugriff auf zusätzliche Einstellungen der Komponente DeviceMapper:

  • Device List URI: Der URI zum Abrufen der Liste der verbundenen Geräte. Der Standardwert ist http://localhost:10000/3.1/devices.
  • Fetch Retry Delay: Die Wartezeit in Sekunden, bevor erneut versucht wird, die Geräteliste abzurufen, falls die erste Anfrage fehlschlägt. Der Standardwert ist 5.
  • Server URI: Der URI für die Verbindung zum Geräteserver. Der Standardwert ist ws://localhost:10001.

Statistiken​

Sobald der Bereich Statistics erweitert ist, stellt der DeviceMapper Statistiken zur Verbindungsrate und zum Payload-Inhalt von JSON bereit. Diese unterstützen Entwickler bei der Überwachung und Verwaltung von Geräten sowie bei der Fehlersuche während der Entwicklung.

Ready-Ereignis​

Die Komponente DeviceMapper löst ein Ready-Ereignis aus, sobald alle verbundenen Geräte zugeordnet und verbunden sind. Dieses Ereignis signalisiert, dass die Geräte-Getter-Methoden, etwa GetInverse3Controller oder GetVerseGripController, sicher verwendet werden können, um die Device Controller der Szene für weitere Interaktionen abzurufen.

Liste der Device Controller​

Im Unity-Editor stellt der DeviceMapper eine dynamische Liste der Device Controller der Szene bereit, die mit verbundenen Geräten verknüpft sind. Diese Liste enthält Details wie Gerätetyp, ID und Verbindungsstatus.

Geräteliste

Erweiterte Verwendung​

Eine Schritt-für-Schritt-Anleitung zur Verwendung der Komponente DeviceMapper in einem Skript, um Geräte manuell aufzulisten, zuzuordnen und zu verbinden, finden Sie im Tutorial Device Mapping.