Skip to main content
Version : 3.5.x

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 — les anciennes 3.0 format de transmission qui devrait être supprimé en 4.0, les points de terminaison HTTP obsolètes, et les commandes de simulation de canal de session obsolètes.

Toutes les fonctionnalités obsolètes répertoriées ici sont toujours acceptées pour des raisons de compatibilité ascendante. La mise à niveau ne provoque aucune rupture de compatibilité — prévoyez de migrer lorsque cela vous convient.

3.0 contre 3.x Versions de l'API​

Le service propose deux formats JSON parallèles : l'ancien 3.0 format sur le port 10000 et le courant 3.x format sur le port 10001. Les deux restent disponibles pour des raisons de compatibilité ascendante — 3.0 Les intégrations continuent de fonctionner sans changement après la mise à niveau.

avertissement

3.0 La prise en charge de la version de l'API sera abandonnée pour les 4.0.

  • 3.0 API

  • 3.x API

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

Effectuez la mise à niveau quand cela 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 génèrent un avertissement de dépréciation. Ils seront supprimés dans 4.0. Utilisez plutôt les itinéraires de remplacement.

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 itinéraire obsolète déclenche un http-route-deprecated événement sur la chaîne des événements, diffusant à la fois l'ancien itinéraire et son remplaçant.

Commandes obsolètes relatives aux canaux de session​

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 sur le réseau ; les nouvelles intégrations devraient utiliser la configure les entrées répertoriées dans la colonne « Remplacement ».

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

Cartographie des valeurs :

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

Les préréglages sont appliqués à chaque appareil via inverse3[*].configure.preset (ou configure.preset (concernant les entrées relatives à la poignée Verse / au dispositif sans fil Verse), et non comme un commutateur valable pour toute la session. Voir la Section « Configurer » Consultez le guide de simulation pour obtenir 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" } } } }
Modification de la convention de signe des axes

Référence​