Zum Hauptinhalt springen

Migration auf 3.5

Diese Seite ist der konsolidierte Upgrade-Leitfaden für Inverse Service 3.5. Sie behandelt alle Deprecations, die der Dienst noch enthält: das veraltete Wire-Format 3.0, dessen Entfernung für 4.0 vorgesehen ist, die veralteten HTTP-Endpunkte sowie die veralteten Simulationsbefehle für den Session-Kanal.

Alle hier aufgeführten Deprecations werden aus Gründen der Abwärtskompatibilität protokollseitig weiterhin akzeptiert. Beim Upgrade bricht nichts. Planen Sie die Migration zu einem Zeitpunkt, der Ihnen passt.

API-Versionen 3.0 vs. 3.x​

Der Dienst stellt zwei parallele JSON-Formate bereit: das Legacy-Format 3.0 auf Port 10000 und das aktuelle Format 3.x auf Port 10001. Beide bleiben aus Gründen der Abwärtskompatibilität verfügbar. 3.0-Integrationen laufen nach dem Upgrade unverändert weiter.

warnung

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

  • 3.0 API

  • 3.x API

    • Vollständig in den 3.x-Dokumentationsseiten beschrieben.
    • HTTP unter http://localhost:10001/.
    • Websockets auf Port 10001.
    • Verbesserte Funktionalität und schnellere Integration mit Game-Engines.

Planen Sie das Upgrade, wann es Ihnen passt. Bestehende Workflows sind davon nicht betroffen.

Veraltete HTTP-Endpunkte​

Die folgenden Endpunkte werden weiterhin akzeptiert, lösen aber eine Deprecation-Warnung aus. Sie werden in 4.0 entfernt. Verwenden Sie stattdessen die Ersatzrouten.

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 veraltete Route löst ein http-route-deprecated-Ereignis im Ereigniskanal aus, das sowohl die alte Route als auch deren Ersatz enthält.

Veraltete Befehle für Session-Kanäle​

Die beiden folgenden Simulationsbefehle auf Session-Ebene sind als veraltet markiert und werden in einer künftigen Hauptversion entfernt. Sie werden protokollseitig weiterhin akzeptiert. Neue Integrationen sollten stattdessen die in der Ersatzspalte aufgeführten configure-Einträge verwenden.

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

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

Wertezuordnung:

Alter coordinate_originNeues Preset
device_basearm_front (oder defaults)
workspace_centerarm_front_centered

Presets werden pro Gerät über inverse3[*].configure.preset angewendet (oder configure.preset bei Geräteeinträgen für verse grip bzw. wireless verse grip), nicht als sitzungsweiter Schalter. Die vollständige Liste der Preset-Namen finden Sie im Configure-Abschnitt in der Simulationsreferenz.

session.set_basis → session.configure.basis​

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

// New — canonical
{ "session": { "configure": { "basis": { "permutation": "XZ-Y" } } } }
Vorzeichenkonvention der Achsen geändert

Referenz​