Composant DeviceMapper

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

Vue d'ensemble

La fonction première du DeviceMapper est de faciliter la communication entre le logiciel et le matériel Haply connecté.

Il garantit que les périphériques sont correctement initialisés et mappés, et il maintient l'état de chaque périphérique, ce qui permet des expériences réactives et interactives dans les applications Unity.

Enquête sur l'information relative aux appareils

Afin d'équilibrer les performances et la précision des données en temps réel, le DeviceMapper utilise un mécanisme d'interrogation pour mettre à jour certaines informations relatives aux appareils, telles que l'état de l'alimentation électrique et l'orientation du corps. l'orientation du corps. Le comportement d'interrogation est contrôlé par les modes suivants :

• Modes d'interrogation:

  • Manuel: Dans ce mode, les informations relatives à l'appareil ne sont mises à jour que sur demande explicite de l'utilisateur ou du développeur. Ce mode est peu performant et convient aux scénarios dans lesquels les mises à jour en temps réel ne sont pas essentielles.
  • Une fois: ce mode déclenche une seule mise à jour des informations relatives à l'appareil immédiatement après son ouverture. Il fournit un instantané de l'état de l'appareil au moment de l'initialisation, ce qui est utile pour définir les conditions initiales.
  • En continu: Dans ce mode, le composant met continuellement à jour les informations sur le périphérique à des intervalles spécifiés par le paramètre devicesInfoPollDelay réglage. Bien que ce mode garantisse les informations les plus récentes, il est recommandé de ne l'utiliser que pendant les phases d'installation ou de débogage.

• Délai d'interrogation: Le devicesInfoPollDelay applicable en mode continu, définit l'intervalle en secondes entre les mises à jour automatiques des informations relatives à l'appareil. Le délai minimum autorisé est de 0,5 seconde, avec un minimum recommandé de 1 seconde pour minimiser le risque de secousses haptiques. Les développeurs doivent gérer ce paramètre avec soin, en équilibrant le besoin de données opportunes et l'impact potentiel sur les performances.

avertissement

L'interrogation continue peut provoquer des saccades haptiques en raison des mises à jour fréquentes, ce qui peut nuire aux performances et à la réactivité des systèmes de retour d'informations haptiques.

Événement prêt

Les DeviceMapper déclenche un Ready lorsque tous les appareils connectés sont ouverts et mappés. Cet événement signale qu'il est possible de commencer à utiliser les méthodes d'acquisition d'appareils, telles que GetInverse3 ou GetVerseGripafin de récupérer les contrôleurs des appareils de la scène en vue d'une interaction ultérieure.

Liste des appareils

Dans l'éditeur Unity, le champ DeviceMapper fournit une liste dynamique des appareils connectés, affichée dans l'inspecteur en mode lecture. Cette liste comprend des détails tels que le type d'appareil, l'identifiant et l'état de la connexion, ce qui aide les développeurs à surveiller et à gérer les appareils et facilite le dépannage pendant le développement.