Passer directement au contenu principal

Passage à la version 3.5

Cette page est le guide de mise à niveau intégrée d'Inverse Service 3.5. Elle traite de tous les éléments obsolètes encore présents dans le service. Plus précisément,4.0 les éléments hérités dont la suppression est prévue 3.0 Il s'agit du format de chaîne, des points de terminaison HTTP obsolètes et des commandes de simulation de canaux de session obsolètes.

Tous les éléments déconseillés mentionnés ici continueront d'être acceptés sur le réseau par souci de rétrocompatibilité. La mise à niveau n'entraînera aucun dysfonctionnement. 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. Port 10000 l'héritage de 3.0 Format et port 10001 actuel de 3.x Il s'agit de formats. Les deux resteront disponibles pour des raisons de compatibilité ascendante.3.0 L'intégration continuera de fonctionner sans modification même après la mise à niveau.

Avertissement

4.0 Bon, alors 3.0 La prise en charge de cette version de l'API va prendre fin.

  • 3.0 API

    • Pour plus d'informations, 3.0.x Page de documentationest indiqué dans ce document.
    • HTTP は http://localhost:10000/3.0/ est disponible.
    • Websockets Port 10000 est disponible.

  • 3.x API

    • Pour plus d'informations, 3.x Page de documentationest indiqué dans ce document.
    • HTTP は http://localhost:10001/ est disponible.
    • Websockets Port 10001 est disponible.
    • Les fonctionnalités ont été améliorées et l'intégration avec le moteur de jeu est désormais plus rapide.

Veuillez effectuer la mise à niveau au moment qui vous convient le mieux. Cela n'entraînera aucune interruption de vos flux de travail existants.

Points de terminaison HTTP déconseillés​

Les points de terminaison suivants continueront d'être acceptés, mais un avertissement indiquant qu'ils sont obsolètes s'affichera.4.0 Il est prévu de le supprimer. Veuillez utiliser à la place le chemin d'accès de remplacement.

Chemin d'accès déconseillédestination de 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 itinéraire déconseillé est indiqué sur la chaîne dédiée à l'événement http-route-deprecated Déclenche un événement. Cet événement inclut à la fois l'ancien itinéraire et le nouvel itinéraire.

Commandes de canal de session non recommandées​

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 continueront toutefois d'être acceptées dans Wire. Dans la nouvelle intégration, les commandes indiquées dans la colonne « Remplacement » configure Veuillez utiliser l'entrée.

Chaque commande déconseillée est signalée sur le canal d'événements command-deprecated Déclenche un événement.

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_originNouveaux préréglages
device_basearm_front(ou defaults)
workspace_centerarm_front_centered

Les préréglages ne s'appliquent pas à l'ensemble de la session, mais à chaque périphérique individuellement. Pour les appliquer, inverse3[*].configure.preset(ou « verse grip » / « verse grip sans fil » dans la fiche produit) configure.preset) est utilisé. Pour consulter la liste complète des noms de préréglages, reportez-vous à la section « Référence de simulation » du Section « Configurer » Veuillez consulter [...].

session.set_basis → session.configure.basis​

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

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

Références​