Migration vers la version 3.5

Cette page constitue un guide complet de mise à niveau vers Inverse Service 3.5. Elle recense l'ensemble des éléments obsolètes qui sont encore pris en charge par le service : il est prévu de 4.0 Ancienne version supprimée 3.0 Formats de transmission, points de terminaison HTTP obsolètes et commandes obsolètes de simulation de canal de session.

Tous les éléments obsolètes répertoriés ici continueront d'être acceptés au niveau de la couche de transport à des fins de compatibilité ascendante. La mise à niveau n'entraînera aucune interruption de service ; veuillez planifier la migration au moment qui vous convient le mieux.

---

3.0 et 3.x Version de l'API

Le service propose simultanément deux formats JSON parallèles : le port 10000 Ancienne version 3.0 le format, ainsi que le port 10001 Actuellement sur 3.x Format. Les deux seront conservés à des fins de compatibilité ascendante,3.0 Les intégrations continueront de fonctionner sans modification après la mise à jour.

Remarque

3.0 La prise en charge des versions de l'API prendra fin le 4.0 La fourniture a été suspendue.

• 3.0 API

  • Pour consulter le document complet, veuillez vous rendre sur 3.0.x Page de documentation。
  • HTTP Situé à http://localhost:10000/3.0/。
  • Websockets Situé au port 10000。

• 3.x API

  • Pour consulter le document complet, veuillez vous rendre sur 3.x Page de documentation。
  • HTTP Situé à http://localhost:10001/。
  • Websockets Situé au port 10001。
  • Il offre des fonctionnalités plus complètes et s'intègre plus rapidement au moteur de jeu.

Veuillez effectuer la mise à jour au moment qui vous convient le mieux ; cela n'aura aucune incidence sur vos processus de travail actuels.

---

Points de terminaison HTTP obsolètes

Les points de terminaison suivants sont toujours acceptés, mais un avertissement d'obsolescence s'affiche. Ils seront supprimés le 4.0 Supprimer cette partie ; veuillez utiliser un itinéraire alternatif.

Chemin obsolète	Parcours alternatifs
POST /force_scale	POST /settings/devices/force_scale
POST /gravity_compensation	POST /{type}/{id}/config/gravity_compensation
POST /torque_scaling	POST /{type}/{id}/config/torque_scaling
POST /device_handedness	POST /{type}/{id}/config/handedness
POST /serial_enable	POST /settings/system/serial_enable
POST /experimental/features/grip_dropped_simulation_stopper	POST /settings/features/grip_hook/enabled
POST /experimental/features/screensaver_enable	POST /settings/features/screensaver/enabled

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

---

Commandes de canal de session obsolètes

Les deux commandes de simulation au niveau de la session suivantes sont obsolètes et seront supprimées dans une prochaine version majeure. Elles continueront d'être acceptées au niveau de la couche de transport ; les nouvelles intégrations doivent utiliser les commandes indiquées dans la colonne « Remplacement ». configure Entrée.

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

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" } } } ] }

Mappage des valeurs :

ancien coordinate_origin	Nouveaux préréglages
device_base	arm_front(ou defaults)
workspace_center	arm_front_centered

Préréglage accepté inverse3[*].configure.preset(ou « verse grip » / « verse grip sans fil » dans la rubrique consacrée à cet équipement) configure.preset) À appliquer individuellement par appareil, et non comme un commutateur global au niveau de la session. Pour consulter la liste complète des noms de préréglages, reportez-vous à la section « Référence de simulation » dans le Chapitre « Configurer »。

session.set_basis → session.configure.basis

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

// New — canonical
{ "session": { "configure": { "basis": { "permutation": "XZ-Y" } } } }

Les conventions relatives aux symboles des axes de coordonnées ont été modifiées

---

Références

• Guide de configuration
• Protocole WebSocket — Aperçu complet et structure des trames en flux continu.
• Documentation AsyncAPI — Architecture lisible par machine pour toutes les charges utiles v3.1.
• Documentation de l'API HTTP — Permet de consulter les routages HTTP actuels, ainsi que les routages de remplacement des points de terminaison obsolètes mentionnés ci-dessus, via l'interface Swagger UI.