Zum Hauptinhalt springen

Umstellung auf 3.5

Diese Seite ist eine Anleitung zum integrierten Upgrade auf Inverse Service 3.5. Sie behandelt alle im Service noch vorhandenen veralteten Elemente. Konkret sind dies:4.0 veraltete Elemente, deren Löschung geplant ist 3.0 Es handelt sich um Wire-Format-Befehle, veraltete HTTP-Endpunkte und veraltete Befehle zur Simulation von Sitzungskanälen.

Alle hier aufgeführten veralteten Elemente werden aus Gründen der Abwärtskompatibilität weiterhin über das Wire-Protokoll akzeptiert. Durch ein Upgrade entstehen keine Probleme. Planen Sie die Umstellung zu einem für Sie passenden Zeitpunkt.

3.0 und 3.x API-Version​

Der Dienst stellt zwei JSON-Formate gleichzeitig bereit. Port 10000 das alte 3.0 Format und Port 10001 der aktuelle 3.x Es handelt sich um Formate. Beide bleiben aus Gründen der Abwärtskompatibilität weiterhin verfügbar.3.0 Die Integration funktioniert auch nach dem Upgrade ohne Änderungen weiter.

Warnung

4.0 Also 3.0 Die Unterstützung für diese API-Version wird eingestellt.

  • 3.0 API

    • Weitere Informationen finden Sie unter 3.0.x Dokumentationsseiteist dort aufgeführt.
    • HTTP は http://localhost:10000/3.0/ ist verfügbar.
    • Websockets ist ein Port 10000 ist verfügbar.

  • 3.x API

    • Weitere Informationen finden Sie unter 3.x Dokumentationsseiteist dort aufgeführt.
    • HTTP は http://localhost:10001/ ist verfügbar.
    • Websockets ist ein Port 10001 ist verfügbar.
    • Die Funktionen wurden verbessert, und die Integration in die Spiel-Engine erfolgt nun schneller.

Führen Sie das Upgrade zu einem für Sie passenden Zeitpunkt durch. Der bestehende Arbeitsablauf wird dadurch nicht unterbrochen.

Veraltete HTTP-Endpunkte​

Die folgenden Endpunkte werden zwar weiterhin akzeptiert, es wird jedoch eine Warnung angezeigt, dass ihre Verwendung nicht mehr empfohlen wird.4.0 wird voraussichtlich gelöscht. Bitte verwenden Sie stattdessen den Ersatzpfad.

Nicht empfohlener PfadErsetzungsziel
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

Die einzelnen nicht empfohlenen Routen werden im Event-Kanal http-route-deprecated Löst ein Ereignis aus. Dieses Ereignis umfasst sowohl die alte Route als auch die Ersatzroute.

Nicht empfohlene Befehle für Sitzungskanäle​

Die folgenden beiden Simulationsbefehle auf Sitzungsebene sind veraltet und sollen in einer zukünftigen Hauptversion entfernt werden. Sie werden in Wire weiterhin akzeptiert. In der neuen Integration werden die in der Spalte „Ersatz“ aufgeführten configure Bitte verwenden Sie den Eintrag.

Jeder nicht empfohlene Befehl wird im Ereigniskanal command-deprecated Löst ein Ereignis 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" } } } ] }

Wertzuordnung:

alt coordinate_originNeue Voreinstellungen
device_basearm_front(oder defaults)
workspace_centerarm_front_centered

Voreinstellungen werden nicht für die gesamte Sitzung, sondern für jedes einzelne Gerät angewendet. Zur Anwendung sind inverse3[*].configure.preset(oder „Verse Grip“ / „Wireless Verse Grip“ – Geräteeintrag) configure.preset) verwenden. 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 zur Kennzeichnung der Achsen wurde geändert.

Referenz​