Chargement...

Le Service Runtime et le SDK Runtime pour les appareils Haply. Regroupés dans un programme d'installation pratique. Aussi connu sous le nom de Service « externe ».
La version 3.5.8 est une version corrective axée sur le branchement à chaud et la reconnexion ainsi que sur les préréglages de montage. L'API C publique est inchangée par rapport à la 3.5.7 et aucune route n'a été supprimée. Chaque modification qui touche un client utilisant les valeurs par défaut corrige un bogue livré dans la 3.5.7, et ajoute des diagnostics plus clairs. Le nouveau travail de ce cycle se trouve derrière les commutateurs d'étape optionnels du SDK, qui restent désactivés par défaut, et est invisible pour un client utilisant les valeurs par défaut.
Contrairement à la 3.5.7, cette version modifie ce qu'un client utilisant les valeurs par défaut observe, à huit endroits. Cinq sont généraux : un appareil est omis d'une session tant que cette session ne l'a pas enregistré, state.current_cursor_position passe dans l'espace de l'application, le verrou de force devient propre à chaque session, les écritures de montage exigent une rotation d'unité, et les préréglages centrés s'appliquent à la rotation actuelle de l'appareil et peuvent signaler custom ou defaults. Trois sont plus ciblés : sur un Minverse, arm_front et defaults réinitialisent le montage de la session et les valeurs state.body_orientation changent, et device-connection-loop peut se déclencher pour un récepteur qui ne nomme aucun appareil. Chacun est décrit sous Changements potentiellement incompatibles, avec les personnes qui le remarqueront et la façon de migrer.
Un journal des modifications technique complémentaire (__CODE_code-1__) contient le détail de l'API soumise aux étapes, les mécanismes internes derrière ces correctifs, les pointeurs vers les registres de conception et les références aux tickets.
device-safety-triggered est de nouveau livré. Dans la 3.5.7, ils étaient perdus jusqu'au redémarrage du service.device-connection-loop par épisode, et un rebranchement rétablit immédiatement la prise en main.state.body_orientation et la référence de montage de l'appareil ne subissent plus une rotation d'un quart de tour autour de Y : l'appareil lit à nouveau l'identité dans sa pose d'étalonnage.state.current_cursor_position est maintenant rapporté dans l'espace d'application de la session, comme cursor_position à côté, de sorte qu'une position commandée est renvoyée dans les coordonnées dans lesquelles elle a été envoyée.device not found, un rappel toutes les 10 s avec le nombre de commandes abandonnées, et une seule ligne device found again — au lieu d'une ligne par commande (16 939 lignes en 2,5 s sur le banc d'essai).POST /ports/{port}/reset annule aussi le recul d'un récepteur silencieux, de sorte que la prochaine tentative de réouverture soit immédiate.Branchement à chaud et reconnexion
GET /devices?session=).Unable to serialize en environ une seconde sur le banc, 11 en 3 ms lors d'un rebranchement de récepteur).Montage et préréglages
[1, 5.5]. Les deux transports appliquent maintenant la même règle : toute échelle finie qui n'est pas proche de zéro sur aucun axe.DELETE config/mount de session laissait config.preset désigner l'ancien préréglage, de sorte que le réappliquer ramenait le montage supprimé; et sur un Minverse, arm_front / defaults conservaient le montage actuel au lieu de le réinitialiser.state.body_orientation et sa référence de montage stockée étaient donc décalés d'un quart de tour autour de Y (une unité gauche signalait sa référence identité comme une rotation de +90 degrés autour de Y).Configuration de l'appareil
config.gravity_compensation (v3.0 et v3.1) et GET /{device_type}/{id}/config/gravity_compensation en moins d'un aller-retour série. Chaque session qui détient l'appareil reçoit une réponse complète à son prochain message. Dans la 3.5.7, l'avis de changement de l'appareil était ignoré, et l'ancienne valeur restait jusqu'à la reconnexion de l'appareil. Les micrologiciels antérieurs n'envoient pas cet avis; rien ne change donc pour eux.Valeurs transmises
cursor_position, cursor_velocity et current_cursor_force du même objet étaient dans l'espace de l'application. Avec une base non identité, l'écho revenait permuté (XZ-Y : envoyé (x, 0.090, 0.197), renvoyé (x, -0.197, 0.090)). Il est maintenant converti avec la base et le montage de la session dans les trames complètes et en flux de la v3.1. Présent depuis la 3.5.0.34), alors que session.session_id dans la même trame contenait le véritable identifiant. Il correspond maintenant à l'identifiant uint32 complet, conforme au schéma documenté. Présent depuis la 3.5.0.GET /devices?session=). Dans la 3.5.7, il apparaissait sans détails pendant la fenêtre de branchement à chaud. La forme JSON est inchangée, et la sortie par défaut conserve custom_verse_grip: [] lorsque chaque prise personnalisée est omise. Qui le remarque : les clients qui indexent les appareils par position dans le tableau d'une trame à l'autre, qui considèrent qu'un appareil absent d'une trame est débranché, ou qui lisent les valeurs brutes de cette première trame. Migration : indexer les appareils par device_id; considérer la première trame qui contient un appareil comme son arrivée; détecter le débranchement à partir du canal d'événements, et non de l'appartenance au tableau.cursor_position et à la cible commandée.GET/POST/DELETE /{device_type}/{id}/config/filters/force_gate et config.filters.force_gate.gain renvoient la valeur propre à la session (par défaut 0.3), et non le gain en direct de l'appareil. Qui le remarque : un client qui a défini la porte de force depuis une session d'observation ou de configuration, ou qui la relit en s'attendant à la valeur en direct de l'appareil. Migration : définir la porte de force depuis la session qui pilote; lire la session pilote pour voir la valeur effective.POST|PATCH config/mount répond 400 invalid mount transform (non-finite, non-unit rotation or ~zero scale axis) pour un quaternion dont la norme au carré s'écarte de plus de 1e-3, et WebSocket configure.mount journalise un avertissement et conserve le montage précédent; une échelle hors de [1, 5.5], refusée dans la 3.5.7, est maintenant acceptée. Qui le remarque : un client qui envoyait des quaternions non normalisés, ou qui comptait sur le service pour plafonner l'échelle. Migration : normaliser les quaternions avant l'envoi; appliquer toute plage d'échelle souhaitée dans l'interface client.arm_front_centered / led_front_centered résolvent leur position selon la rotation actuelle de l'appareil au moment de l'application; config.preset vaut custom (avec un session-updated pour config.preset) une fois que l'appareil a tourné de plus de 1 degré depuis l'application — y compris après un rebranchement ou une recalibration de l'encrier, sans écriture du client; et il vaut defaults après un DELETE config/mount au niveau de la session. Qui le remarque : un client qui fonde son comportement sur le nom config.preset. Migration : réappliquer le préréglage pour recentrer après avoir déplacé l'appareil; traiter custom comme « le préréglage ne décrit plus la pose ».arm_front_centered passe de x = -0,13 à x = -0,12 (réglée à la main sur le matériel). Qui le remarque : les utilisateurs de Minverse qui comptaient sur le maintien d'un montage personnalisé avec ces préréglages, ou qui ont calibré par rapport à l'ancien centre. Migration : revérifier les calibrations de Minverse faites par rapport à l'ancien centre.device_id est le dernier identifiant vu prêt sur le port et est vide si aucun n'a jamais été vu, attempts compte les tentatives échouées de l'épisode et window_ms correspond au temps écoulé depuis le premier échec. La forme de la charge utile est inchangée. Qui le remarque : un client qui supposait que device_id n'est jamais vide. Migration : gérer un device_id vide.Tous les téléchargements disponibles pour cette version :