Aller au contenu principal

Migration vers la version 3.5

Cette page constitue le guide de mise à niveau complet pour Inverse Service 3.5. Elle couvre toutes les fonctionnalités obsolètes encore présentes dans le service — l'ancien format de transmission 3.0, dont la suppression est prévue dans 4.0, les points de terminaison HTTP obsolètes, et les commandes de simulation de canal de session obsolètes.

Toutes les dépréciations répertoriées ici sont toujours prises en charge par le service afin d'assurer la rétrocompatibilité. Aucune fonctionnalité ne cesse de fonctionner lors de la mise à niveau — planifiez la migration au moment qui vous convient.

Versions de l'API 3.0 et 3.x​

Le service propose deux formats JSON en parallèle : l'ancien format 3.0 sur le port 10000 et le format actuel 3.x sur le port 10001. Les deux restent disponibles pour garantir la rétrocompatibilité — les intégrations 3.0 continueront de fonctionner sans modification lors de la mise à niveau.

attention

Prise en charge de la version de l'API 3.0 sera abandonné pour 4.0.

  • API 3.0

  • API 3.x

    • Entièrement documentée dans les pages de documentation 3.x.
    • HTTP sur http://localhost:10001/.
    • Websockets sur le port 10001.
    • Des fonctionnalités améliorées et une intégration plus rapide avec les moteurs de jeu.

Effectuez la mise à niveau au moment qui vous convient — sans perturber vos processus de travail actuels.

Points de terminaison HTTP obsolètes​

Les points de terminaison suivants sont toujours acceptés, mais ils génèrent un avertissement de dépréciation. Ils seront supprimés dans 4.0. Empruntez plutôt les itinéraires alternatifs.

Chemin obsolèteRemplacement
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 route désactivée déclenche un événement http-route-deprecated sur le canal des événements, qui regroupe à la fois l'ancienne route et son remplaçant.

Commandes de canal de session obsolètes​

Les deux commandes de simulation au niveau de la session ci-dessous sont obsolètes et seront supprimées dans une prochaine version majeure. Elles sont toujours acceptées par le service ; les nouvelles intégrations doivent utiliser les entrées configure indiquées dans la colonne « Remplacement ».

Chaque commande obsolète déclenche un événement command-deprecated sur la chaîne des é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" } } } ] }

Correspondance des valeurs :

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

Les préréglages s'appliquent à chaque appareil via inverse3[*].configure.preset (ou configure.preset sur les entrées de l'appareil (Verse Grip / Wireless Verse Grip), et non comme un paramètre global de session. Consultez la section « Configurer » dans le guide de simulation pour consulter la liste complète des noms de préréglages.

session.set_basis → session.configure.basis​

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

// New — canonical
{ "session": { "configure": { "basis": { "permutation": "XZ-Y" } } } }
Convention de signe des axes modifiée

Référence​