Zum Haupttext springen

Migration auf Version 3.5

Diese Seite enthält eine umfassende Anleitung zum Upgrade auf Inverse Service 3.5. Sie behandelt alle noch im Dienst vorhandenen, nicht mehr unterstützten Funktionen (Deprecation). Dazu gehören 4.0Veraltete Elemente, die entfernt werden sollen 3.0 Dazu gehören Wire-Formate, veraltete HTTP-Endpunkte sowie Befehle zur Simulation veralteter Sitzungskanäle.

Alle hier aufgeführten veralteten Elemente sind aus Gründen der Abwärtskompatibilität weiterhin in Wire zulässig. Da durch ein Upgrade keine Probleme entstehen, können Sie die Migration zu einem für Sie passenden Zeitpunkt planen.

3.0 da 3.x API-Version​

Der Dienst stellt zwei JSON-Formate gleichzeitig bereit. Port 10000Das Vermächtnis von 3.0 Formate und Anschlüsse 10001Derzeit 3.x Es handelt sich um Formate. Beide Formate können aus Gründen der Abwärtskompatibilität weiterhin verwendet werden, und 3.0 Die Verknüpfung funktioniert auch nach dem Upgrade unverändert weiter.

Warnung

3.0 Die Unterstützung für API-Versionen ist 4.0endet dort.

  • 3.0 API

    • Der vollständige Inhalt lautet 3.0.x Dokumentseitedort wird dies erläutert.
    • HTTPist http://localhost:10000/3.0/wird dort angeboten.
    • Websocketsist ein Port 10000wird verwendet.

  • 3.x API

    • Der vollständige Inhalt lautet 3.x Dokumentseitedort wird dies erläutert.
    • HTTPist http://localhost:10001/wird dort angeboten.
    • Websocketsist ein Port 10001wird verwendet.
    • Die Funktionen wurden verbessert und die Anbindung an die Spiel-Engine erfolgt nun schneller.

Sie können das Upgrade zu einem für Sie passenden Zeitpunkt durchführen. Der bestehende Arbeitsablauf bleibt davon unberührt.

Veraltete HTTP-Endpunkte​

Die folgenden Endpunkte sind weiterhin zulässig, es wird jedoch eine Warnung bezüglich der Einstellung der Unterstützung ausgegeben. Diese Endpunkte sind 4.0wird entfernt. Bitte nutzen Sie stattdessen den unten angegebenen alternativen Pfad.

Nicht mehr verwendete PfadeAlternativroute
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

Wenn ein nicht mehr verwendeter Pfad aufgerufen wird, wird im Ereigniskanal http-route-deprecated Es wird ein Ereignis ausgelöst, das sowohl den bisherigen Pfad als auch den alternativen Pfad umfasst.

Veraltete Befehle für Sitzungskanäle​

Die folgenden beiden Simulationsbefehle auf Session-Ebene sind veraltet und werden in einer zukünftigen Hauptversion entfernt. Sie sind zwar weiterhin in Wire zulässig, in neuen Integrationen werden jedoch die in der Spalte „Ersatz“ aufgeführten configure Bitte nutzen Sie diesen Eintrag.

Wenn ein nicht mehr unterstützter Befehl aufgerufen wird, erscheint im Ereigniskanal command-deprecated Es wird ein Ereignis ausgelöst.

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

Wertzuordnung:

Bisher coordinate_originNeue Voreinstellung
device_basearm_front (oder defaults)
workspace_centerarm_front_centered

Ein Preset ist keine Übergangssequenz, die für die gesamte Session gilt, sondern inverse3[*].configure.preset(oder unter den Einträgen „Verse Grip“ / „Wireless Verse Grip“) configure.preset) wird gerätespezifisch angewendet. Eine vollständige Liste der Voreinstellungsnamen finden Sie in der Simulationsreferenz unter Abschnitt „Konfigurieren“Siehe dazu.

session.set_basis → session.configure.basis​

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

// New — canonical
{ "session": { "configure": { "basis": { "permutation": "XZ-Y" } } } }
Die Konvention für die Vorzeichenangabe wurde geändert.

Quellenangaben​