Zum Hauptinhalt springen

Umstellung auf Version 3.5

Diese Seite ist die konsolidierte Upgrade-Anleitung für Inverse Service 3.5. Sie behandelt alle im Dienst noch vorhandenen veralteten Funktionen – das alte Übertragungsformat 3.0, dessen Streichung in 4.0, die veralteten HTTP-Endpunkte und die veralteten Befehle zur Simulation von Sitzungskanälen.

Alle hier aufgeführten Veraltungen werden vom Dienst weiterhin akzeptiert, um die Abwärtskompatibilität zu gewährleisten. Bei der Aktualisierung bleibt alles funktionsfähig – planen Sie die Migration zu einem Zeitpunkt, der Ihnen passt.

API-Versionen 3.0 et 3.x​

Der Dienst stellt zwei JSON-Formate gleichzeitig bereit: das alte Format 3.0 am Hafen 10000 und das aktuelle Format 3.x am Hafen 10001. Beide stehen weiterhin zur Verfügung, um die Abwärtskompatibilität zu gewährleisten – die Integrationen 3.0 weiterhin funktionieren ohne Änderungen während des Upgrades.

Achtung

Unterstützung der API-Version 3.0 wird aufgegeben für 4.0.

  • API 3.0

  • API 3.x

    • Ausführlich dokumentiert in den Dokumentationsseiten 3.x.
    • HTTP sur http://localhost:10001/.
    • Websockets am Hafen 10001.
    • Verbesserte Funktionen und schnellere Integration in Spiel-Engines.

Führen Sie das Upgrade zu einem Zeitpunkt Ihrer Wahl durch – ohne Beeinträchtigung Ihrer bestehenden Arbeitsabläufe.

Veraltete HTTP-Endpunkte​

Die folgenden Endpunkte werden zwar weiterhin akzeptiert, es wird jedoch eine Warnung wegen Veralterung ausgegeben. Sie werden in 4.0. Nutzen Sie stattdessen die Ausweichstrecken.

Veralteter PfadErsatz
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

Jede als veraltet markierte Route löst ein Ereignis aus http-route-deprecated im Ereignis-Kanal, der sowohl die alte Route als auch deren Ersatz enthält.

Veraltete Befehle für Sitzungskanäle​

Die beiden unten aufgeführten Simulationsbefehle auf Sitzungsebene sind veraltet und werden in einer zukünftigen Hauptversion entfernt. Sie werden vom Dienst weiterhin akzeptiert; neue Integrationen müssen die Eingaben verwenden configure die in der Spalte „Ersatz“ angegeben sind.

Jeder veraltete Befehl löst ein Ereignis aus command-deprecated im Veranstaltungskanal.

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

Wertentsprechung:

Ehemaliger coordinate_originNeue Voreinstellung
device_basearm_front (oder defaults)
workspace_centerarm_front_centered

Die Voreinstellungen werden pro Gerät über inverse3[*].configure.preset (oder configure.preset an den Geräteeingängen (Verse Grip / Wireless Verse Grip), und nicht als globaler Sitzungsparameter. Weitere Informationen finden Sie in der Abschnitt „Konfigurieren“ In der Simulationsanleitung finden Sie eine vollständige Liste der Voreinstellungsnamen.

session.set_basis → session.configure.basis​

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

// New — canonical
{ "session": { "configure": { "basis": { "permutation": "XZ-Y" } } } }
Geänderte Konvention zur Beschriftung der Achsen

Referenz​