Zum Hauptinhalt springen

Umstellung auf 3.5

Diese Seite ist eine umfassende Upgrade-Anleitung für Inverse Service 3.5. Sie behandelt alle veralteten Funktionen, die im Dienst weiterhin vorhanden sind: Geplant ist, 4.0 Die alte Version wurde entfernt 3.0 Übertragungsformate, veraltete HTTP-Endpunkte sowie veraltete Befehle zur Simulation von Sitzungskanälen.

Alle hier aufgeführten veralteten Elemente werden aus Gründen der Abwärtskompatibilität auf der Transportschicht weiterhin akzeptiert. Das Upgrade führt zu keinen Ausfällen; bitte planen Sie die Migration zu einem für Sie passenden Zeitpunkt.

3.0 und 3.x API-Version​

Der Dienst bietet gleichzeitig zwei parallele JSON-Formate an: Port 10000 die alte Version 3.0 Format sowie Port 10001 Aktuell auf 3.x Format. Beide werden aus Gründen der Abwärtskompatibilität beibehalten,3.0 Die Integration wird nach dem Upgrade weiterhin ohne Änderungen funktionieren.

Hinweis

3.0 Die Unterstützung für API-Versionen wird in 4.0 Die Bereitstellung wurde eingestellt.

  • 3.0 API

    • Die vollständige Dokumentation finden Sie unter 3.0.x Dokumentseite。
    • HTTP gelegen in http://localhost:10000/3.0/。
    • Websockets am Hafen gelegen 10000。

  • 3.x API

    • Die vollständige Dokumentation finden Sie unter 3.x Dokumentseite。
    • HTTP gelegen in http://localhost:10001/。
    • Websockets am Hafen gelegen 10001。
    • Es bietet umfangreichere Funktionen und lässt sich schneller in die Spiel-Engine integrieren.

Bitte führen Sie das Upgrade zu einem für Sie passenden Zeitpunkt durch; der bestehende Arbeitsablauf wird dadurch nicht beeinträchtigt.

Veraltete HTTP-Endpunkte​

Die folgenden Endpunkte werden weiterhin akzeptiert, es wird jedoch eine Verwendungswarnung ausgegeben. Sie werden 4.0 Entfernen Sie dies und verwenden Sie stattdessen eine alternative Route.

Veraltete PfadeAlternativer Weg
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 Ereignis auf dem Ereigniskanal aus. http-route-deprecated Ereignis, das sowohl die alte Route als auch deren Ersatzroute enthält.

Veraltete Befehle für Sitzungskanäle​

Die folgenden beiden Befehle zur Simulation auf Sitzungsebene sind veraltet und werden in zukünftigen Hauptversionen entfernt. Sie werden auf der Transportschicht weiterhin akzeptiert; bei neuen Integrationen sollten stattdessen die in der Spalte „Ersatz“ aufgeführten Befehle verwendet werden. configure Eintrag.

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

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:

alt coordinate_originNeue Voreinstellungen
device_basearm_front(oder defaults)
workspace_centerarm_front_centered

Voreinstellung: „Durch“ inverse3[*].configure.preset(oder „Verse Grip“ / „Wireless Verse Grip“ im Eintrag zu diesem Gerät) configure.preset) Diese werden geräteweise angewendet und nicht als globaler Schalter auf Sitzungsebene. Eine vollständige Liste der Voreinstellungsnamen finden Sie in der Simulationsreferenz unter Kapitel „Konfigurieren“。

session.set_basis → session.configure.basis​

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

// New — canonical
{ "session": { "configure": { "basis": { "permutation": "XZ-Y" } } } }
Die Konventionen für die Beschriftung der Koordinatenachsen wurden geändert

Quellenangaben​