Aller au contenu principal

Composant DeviceMapper

Le composant DeviceMapper du plugin Haply Inverse Unity est conçu pour gérer la découverte, le mappage et la connexion des appareils Haply, tels que les Inverse3 et VerseGrip, avec les GameObjects de la scène et les contrôleurs d'appareils. Il fournit une interface unifiée pour interagir avec ces appareils, permettant un contrôle et une configuration dynamiques selon les conditions d'exécution.

Vue d'ensemble​

La fonction principale du DeviceMapper est de lister les appareils connectés et de les associer aux contrôleurs d'appareils de la scène.

Composant DeviceMapper

Paramètres de base​

Le composant DeviceMapper comprend les paramètres de base suivants :

  • Auto Fetch Devices List : Lorsqu'il est activé, le DeviceMapper récupère automatiquement la liste des appareils connectés au démarrage, à l'aide d'une requête HTTP.
  • Auto Assign : Lorsqu'il est activé, le DeviceMapper associe automatiquement les appareils connectés aux contrôleurs d'appareils de la scène.
  • Auto Connect : Lorsqu'il est activé, le DeviceMapper ouvre automatiquement une connexion WebSocket vers les appareils.

Paramètres avancés​

DeviceMapper avancé

En cliquant sur le bouton Show Advanced Settings, vous pouvez accéder à des paramètres supplémentaires du composant DeviceMapper :

  • Device List URI : L'URI permettant de récupérer la liste des appareils connectés. La valeur par défaut est http://localhost:10000/3.1/devices.
  • Fetch Retry Delay : Le délai, en secondes, avant de réessayer de récupérer la liste des appareils si la requête initiale échoue. La valeur par défaut est 5.
  • Server URI : L'URI de connexion au serveur d'appareils. La valeur par défaut est ws://localhost:10001.

Statistiques​

Une fois le volet Statistics déployé, le DeviceMapper fournit des statistiques sur le taux de connexion et sur le contenu des charges utiles JSON, ce qui aide les développeurs à surveiller et à gérer les appareils et facilite le dépannage pendant le développement.

Événement Ready​

Le composant DeviceMapper déclenche un événement Ready lorsque tous les appareils connectés sont mappés et connectés. Cet événement indique qu'il est sûr de commencer à utiliser les méthodes getters des appareils, telles que GetInverse3Controller ou GetVerseGripController, pour récupérer les contrôleurs d'appareils de la scène en vue d'interactions ultérieures.

Liste des contrôleurs d'appareils​

Dans l'éditeur Unity, le DeviceMapper fournit une liste dynamique des contrôleurs d'appareils de la scène associés aux appareils connectés. Cette liste comprend des détails tels que le type d'appareil, l'ID et l'état de la connexion.

Liste des appareils

Utilisation avancée​

Consultez le tutoriel Mappage des appareils pour un guide pas à pas sur l'utilisation du composant DeviceMapper dans un script afin de lister, mapper et connecter manuellement les appareils.