Aller au contenu principal

Composant DeviceMapper

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

Vue d'ensemble​

La fonction principale du DeviceMapper est de répertorier 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 :

  • Récupération automatique de la liste des périphériques: lorsque cette option est activée, le DeviceMapper récupère automatiquement la liste des périphériques connectés au démarrage, à l'aide d'une requête HTTP.
  • Attribution automatique: lorsqu'elle est activée, la fonction DeviceMapper associe automatiquement les appareils connectés aux contrôleurs d'appareils de la scène.
  • Connexion automatique: lorsqu'elle est activée, DeviceMapper établit automatiquement une connexion WebSocket avec 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 :

  • Liste des appareils 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.
  • Délai de réessai d'extraction : 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.
  • URI du serveur : L'URI de connexion au serveur d'appareils. La valeur par défaut est ws://localhost:10001.

Statistiques​

Une fois le volet Statistics mis en place, 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 répertoriés et connectés. Cet événement indique qu'il est possible d'utiliser en toute sécurité les méthodes « getters » des appareils, telles que GetInverse3Controller ou GetVerseGripController, afin de récupérer les commandes des appareils présents sur 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 informations telles que le type d'appareil, son identifiant et l'état de la connexion.

Liste des appareils

Utilisation avancée​

Consultez le tutoriel « Mappage des périphériques » pour obtenir un guide étape par étape sur l'utilisation du composant DeviceMapper dans un script afin de répertorier, de mapper et de connecter manuellement les périphériques.