3.5への移行

このページは、Inverse Service 3.5 の統合アップグレードガイドです。本サービスに依然として含まれているすべての非推奨機能、すなわち非推奨のワイヤ形式について解説しています。 3.0, その除去は 4.0 廃止予定となっているのは、旧式のHTTPエンドポイントおよびセッションチャネル用の旧式シミュレーションコマンドです。

ここに記載されている非推奨機能はすべて、下位互換性を確保するため、プロトコル上では引き続き受け入れられます。アップグレードによって動作に支障が生じることはありません。ご都合の良い時期にマイグレーションを実施してください。

APIのバージョン `3.0` 対 `3.x`

このサービスでは、2つの並行するJSONフォーマットが提供されています。レガシーフォーマット 3.0 auf Port 10000 そして現在のフォーマット 3.x auf Port 10001. 両者とも、下位互換性を確保するため、引き続き利用可能です。 3.0-アップグレード後も、統合はこれまで通り継続されます。

警告

APIバージョンのサポート 3.0 は、以下のために使用されます 4.0 削除されました。

3.0 API
- 完全に 3.0.x-ドキュメントページ 説明されている。
- HTTP unter http://localhost:10000/3.0/.
- Websockets auf Port 10000.
3.x API
- 完全に 3.x-ドキュメントページ 説明されている。
- HTTP unter http://localhost:10001/.
- Websockets auf Port 10001.
- 機能の向上と、ゲームエンジンとの統合の迅速化。

ご都合の良いタイミングでアップグレードをご計画ください。既存のワークフローには影響ありません。

廃止されたHTTPエンドポイント

以下のエンドポイントは引き続き受け入れられますが、非推奨の警告が表示されます。これらは 4.0 削除されました。代わりに迂回ルートをご利用ください。

古いパス	エルザッツ
`POST /force_scale`	`POST /settings/devices/force_scale`
`POST /gravity_compensation`	`POST /{type}/{id}/config/gravity_compensation`
`POST /torque_scaling`	`POST /{type}/{id}/config/torque_scaling`
`POST /device_handedness`	`POST /{type}/{id}/config/handedness`
`POST /serial_enable`	`POST /settings/system/serial_enable`
`POST /experimental/features/grip_dropped_simulation_stopper`	`POST /settings/features/grip_hook/enabled`
`POST /experimental/features/screensaver_enable`	`POST /settings/features/screensaver/enabled`

時代遅れのルートはすべて、 http-route-deprecated- イベントチャネル内の、旧ルートとその代替ルートの両方を含むイベント。

セッションチャネル用の廃止されたコマンド

以下の 2 つのセッションレベルのシミュレーションコマンドは、非推奨としてマークされており、将来のメジャーバージョンで削除される予定です。ただし、プロトコル上は引き続き受け入れられます。新しい統合では、代わりに「代替」列に記載されている configure-エントリを使用する。

古いコマンドはすべて、 command-deprecated- イベントをイベントチャネルから削除します。

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

値の割り当て：

Alter `coordinate_origin`	新しいプリセット
`device_base`	`arm_front` (または `defaults`)
`workspace_center`	`arm_front_centered`

プリセットは、デバイスごとに inverse3[*].configure.preset angewendet（または configure.preset （Verse Grip および Wireless Verse Grip のデバイスエントリの場合）、セッション全体に適用されるスイッチとしては機能しません。プリセット名の完全な一覧については、「設定」セクションシミュレーションリファレンスにて。

`session.set_basis` → `session.configure.basis`

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

// New — canonical
{ "session": { "configure": { "basis": { "permutation": "XZ-Y" } } } }

軸の符号の規則が変更されました

参考文献

採用基準
WebSocketプロトコル— 完全なスナップショットおよびストリーミングフレームの構成。
AsyncAPIリファレンス— すべてのv3.1ペイロード向けの機械可読スキーマ。
HTTP API リファレンス— 最新の HTTP ルートおよび、上記に記載された非推奨エンドポイントの代替となるものに対する Swagger UI。

APIのバージョン 3.0 対 3.x​

廃止されたHTTPエンドポイント​

セッションチャネル用の廃止されたコマンド​

session.set_coordinate_origin → inverse3[*].configure.preset​

session.set_basis → session.configure.basis​

参考文献​