Skip to main content
Version : 3.5.x

Note de dépréciation

Le service prend actuellement en charge deux types de services différents JSON formats : 3.0 et 3.x. Les deux versions sont disponibles simultanément, ce qui garantit une compatibilité ascendante. Si vous utilisez la version 3.0 dans vos simulations, aucune modification n'est nécessaire - le système continuera à fonctionner comme avant. Cependant, nous vous encourageons à mettre à jour le format 3.x pour profiter de ses améliorations et de ses performances accrues pour l'intégration des moteurs de jeu. de jeu.

avertissement

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

  • 3.0 Version API

    • Entièrement documenté dans le 3.0.x pages de documentation.
    • HTTP accessible par défaut sur ****http://localhost:10000/3.0/..
    • Websockets accessible par défaut sur port 10000.

  • 3.x Version API

    • Entièrement documenté dans le 3.x pages de documentation.
    • HTTP accessible par défaut sur http://localhost:10001/.
    • Websockets accessible par défaut sur port 10001.
    • Amélioration des fonctionnalités et intégration plus rapide avec les moteurs de jeu.

N'hésitez pas à passer au dernier format à votre convenance pour profiter de ses avantages sans perturber vos flux de travail existants.

Remplacements de commandes dans le canal de simulation (3.x)​

Les deux commandes de niveau session ci-dessous sont obsolètes et seront supprimées dans une prochaine version majeure. Elles sont toujours acceptées au niveau de la communication pour des raisons de compatibilité ascendante, mais les nouvelles intégrations devraient utiliser la configure les entrées répertoriées dans la colonne « Remplacement ».

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

L'interprétation des axes et des signes diffère entre les deux commandes. Une permutation qui produisait le mappage correct sous session.set_basis peut produire un transformation inverse sous session.configure.basis — vous devrez peut-être inverser le signe sur un ou plusieurs axes lors de la migration.

Exemple : une session qui s'est déroulée correctement avec session.set_basis + "permutation": "X-ZY" aura généralement besoin de "permutation": "XZ-Y" sous session.configure.basis. Vérifiez toujours à nouveau la transformation obtenue avant de déployer une migration.