Migration vers la version 3.5
Cette page constitue le guide de mise à niveau intégrée d'Inverse Service 3.5. Elle traite de tous les éléments obsolètes (deprecation) encore présents dans le service. Cela inclut notamment : 4.0Anciennes fonctionnalités qui seront supprimées 3.0 Cela inclut le format de câble, les points de terminaison HTTP obsolètes et les commandes de simulation de canaux de session obsolètes.
Tous les éléments dont l'utilisation est déconseillée et qui figurent ici sont toujours autorisés dans Wire, à des fins de rétrocompatibilité. La mise à niveau n'entraînera aucun dysfonctionnement ; vous pouvez donc planifier la migration au moment qui vous convient le mieux.
3.0 dae 3.x Version de l'API
Le service propose simultanément deux formats JSON. Port 10000Son héritage 3.0 Formats et ports 10001Actuellement 3.x Il s'agit de formats. Les deux formats resteront disponibles pour des raisons de rétrocompatibilité, et 3.0 La synchronisation continue de fonctionner sans modification, même après la mise à jour.
3.0 La prise en charge des versions de l'API est 4.0se termine à cet endroit.
-
3.0API- Le contenu complet est disponible
3.0.xPage du documentest expliqué dans [...]. HTTPest http://localhost:10000/3.0/est disponible sur.Websocketsest un port10000utilise.
- Le contenu complet est disponible
-
3.xAPI- Le contenu complet est disponible
3.xPage du documentest expliqué dans [...]. HTTPest http://localhost:10001/est disponible sur.Websocketsest un port10001utilise.- Les fonctionnalités ont été améliorées et l'intégration avec le moteur de jeu est désormais plus rapide.
- Le contenu complet est disponible
Vous pouvez effectuer la mise à niveau au moment qui vous convient le mieux. Cela n'aura aucune incidence sur vos flux de travail actuels.
Points de terminaison HTTP obsolètes
Les points de terminaison suivants sont toujours autorisés, mais génèrent un avertissement indiquant qu'ils sont en voie d'abandon. Ces points de terminaison sont les suivants : 4.0Il est prévu de le supprimer. Veuillez utiliser l'itinéraire alternatif indiqué ci-dessous à la place.
| Chemin obsolète | Itinéraire alternatif |
|---|---|
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 |
Si vous appelez une méthode dont l'utilisation a été interrompue, dans le canal d'événements, http-route-deprecated Un événement se produit ; cet événement inclut à la fois l'itinéraire initial et l'itinéraire alternatif.
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 autorisées dans Wire, mais dans les nouvelles intégrations, il convient d'utiliser les commandes de remplacement répertoriées dans le tableau ci-dessous : configure Veuillez utiliser cet élément.
Si vous appelez une commande obsolète, dans le canal d'événements, command-deprecated Un événement se produit.
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 :
Existant coordinate_origin | Nouveau préréglage |
|---|---|
device_base | arm_front (ou defaults) |
workspace_center | arm_front_centered |
Un préréglage n'est pas une transition qui s'applique à l'ensemble de la session, mais plutôt, inverse3[*].configure.preset(ou dans la rubrique « Verse Grip » / « dispositif Verse Grip sans fil » : configure.preset) et s'applique à chaque appareil. La liste complète des noms de préréglages figure dans la référence de simulation, à la section Section « Configurer »Veuillez vous reporter à [...].
session.set_basis → session.configure.basis
// Old — deprecated
{ "session": { "set_basis": { "basis": { "permutation": "X-ZY" } } } }
// New — canonical
{ "session": { "configure": { "basis": { "permutation": "XZ-Y" } } } }
Documents de référence
- Référence de configuration
- Protocole WebSocket — Aperçu complet et structure des trames de streaming.
- Référence AsyncAPI — Schéma lisible par machine pour toutes les charges utiles de la version 3.1.
- Référence de l'API HTTP — Interface utilisateur Swagger permettant de consulter les chemins HTTP actuels ainsi que les chemins de remplacement pour les points de terminaison obsolètes répertoriés ci-dessus.