Aller au contenu principal

Migration vers la version 3.5

Cette page constitue le guide de mise à niveau consolidé pour Inverse Service 3.5. Elle traite de toutes les fonctionnalités obsolètes encore présentes dans le service : le format Wire obsolète 3.0, dont le retrait est nécessaire pour 4.0 Il est prévu de supprimer les points de terminaison HTTP obsolètes ainsi que les commandes de simulation obsolètes pour le canal de session.

Toutes les fonctionnalités obsolètes répertoriées ici continueront d'être acceptées au niveau du protocole, pour des raisons de compatibilité ascendante. La mise à niveau ne provoquera aucune interruption. Prévoyez la migration à un moment qui vous convient.

Versions de l'API 3.0 contre 3.x​

Le service propose deux formats JSON parallèles : le format hérité 3.0 à Port 10000 et le format actuel 3.x à Port 10001. Les deux restent disponibles pour des raisons de compatibilité ascendante. 3.0- Les intégrations se poursuivent sans changement après la mise à jour.

avertissement

Prise en charge de la version de l'API 3.0 est utilisé pour 4.0 supprimé.

  • 3.0 API

  • 3.x API

    • Intégralement dans les 3.x-Pages de documentation décrit.
    • HTTP unter http://localhost:10001/.
    • Websockets à Port 10001.
    • Fonctionnalités améliorées et intégration plus rapide avec les moteurs de jeu.

Planifiez la mise à niveau quand cela vous convient. Les flux de travail existants ne sont pas affectés.

Points de terminaison HTTP obsolètes​

Les points de terminaison suivants sont toujours acceptés, mais déclenchent un avertissement de dépréciation. Ils seront supprimés dans 4.0 a été supprimé. Veuillez utiliser les itinéraires de remplacement à la place.

Chemin obsolèteErsatz
POST /force_scalePOST /settings/devices/force_scale
POST /gravity_compensationPOST /{type}/{id}/config/gravity_compensation
POST /torque_scalingPOST /{type}/{id}/config/torque_scaling
POST /device_handednessPOST /{type}/{id}/config/handedness
POST /serial_enablePOST /settings/system/serial_enable
POST /experimental/features/grip_dropped_simulation_stopperPOST /settings/features/grip_hook/enabled
POST /experimental/features/screensaver_enablePOST /settings/features/screensaver/enabled

Chaque itinéraire obsolète déclenche un http-route-deprecated- Événement dans le canal d'événements, qui contient à la fois l'ancien itinéraire et son remplacement.

Commandes obsolètes pour les canaux de session​

Les deux commandes de simulation suivantes, au niveau de la session, sont marquées comme obsolètes et seront supprimées dans une prochaine version majeure. Elles continueront toutefois d'être acceptées au niveau du protocole. Les nouvelles intégrations devraient plutôt utiliser celles répertoriées dans la colonne « Remplacement » : configure- Utiliser les entrées.

Chaque commande obsolète déclenche un command-deprecated- Événement dans le canal d'événements.

session.set_coordinate_origin → inverse3[*].configure.preset​

// Old — deprecated
{ "session": { "set_coordinate_origin": { "coordinate_origin": "workspace_center" } } }

// New — canonical
{ "inverse3": [ { "device_id": "…", "configure": { "preset": { "preset": "arm_front_centered" } } } ] }

Affectation des valeurs :

Modifier coordinate_originNouveau préréglage
device_basearm_front (ou defaults)
workspace_centerarm_front_centered

Les préréglages sont définis par appareil via inverse3[*].configure.preset appliqué (ou configure.preset (pour les entrées d'appareil « Verse Grip » ou « Wireless Verse Grip »), et non comme commutateur valable pour toute la session. Vous trouverez la liste complète des noms de préréglages dans le Section « Configuration » dans le guide de simulation.

session.set_basis → session.configure.basis​

// Old — deprecated
{ "session": { "set_basis": { "basis": { "permutation": "X-ZY" } } } }

// New — canonical
{ "session": { "configure": { "basis": { "permutation": "XZ-Y" } } } }
Modification de la convention de signe des axes

Référence​