Aller au contenu principal

Migration vers la version 3.5

Cette page est le guide de mise à niveau consolidé pour Inverse Service 3.5. Elle couvre toutes les dépréciations 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 dépréciés, et les commandes de simulation de canal de session dépréciées.

Toutes les dépréciations listées ici sont toujours acceptées par le service afin d'assurer la rétrocompatibilité. Rien 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 expose deux formats JSON simultanés : l'ancien format 3.0 sur le port 10000 et le format actuel 3.x sur le port 10001. Les deux restent disponibles pour assurer la rétrocompatibilité — les intégrations 3.0 continuent de fonctionner sans modification lors de la mise à niveau.

attention

Le support de la version d'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.
    • Fonctionnalités améliorées et intégration plus rapide avec les moteurs de jeu.

Effectuez la mise à niveau au moment qui vous convient — aucune perturbation pour vos flux de travail existants.

Points de terminaison HTTP dépréciés​

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. Utilisez plutôt les routes de remplacement.

Chemin dépréciéRemplacement
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épréciée déclenche un événement http-route-deprecated sur le canal des événements, qui contient à la fois l'ancienne route et son remplacement.

Commandes de canal de session dépréciées​

Les deux commandes de simulation au niveau de la session ci-dessous sont dépréciées et seront supprimées dans une future 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 de remplacement.

Chaque commande dépréciée déclenche un événement command-deprecated sur le canal 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 par appareil au moyen de inverse3[*].configure.preset (ou configure.preset sur les entrées d'appareil verse grip / wireless verse grip), et non comme un paramètre global de session. Consultez la section Configure dans la référence de simulation pour 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​