本文へスキップ
バージョン: 3.5.x

バージョン3.5への移行

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

ここに記載されている非推奨機能は、下位互換性を確保するため、引き続きネットワーク上で受け入れられます。 アップグレードによって機能に支障が生じることはありません。ご都合の良いタイミングで移行してください。

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

このサービスは、2つの並行するJSON形式を提供しています：レガシー 3.0 フォーマット ポート上で 10000 そして現在の 3.x ポート上のフォーマット 10001. これらは両方とも 下位互換性のために引き続き利用可能です — 3.0 アップグレード後も 統合機能は変更なく動作し続けます。

警告

3.0 APIバージョンのサポートは 4.0.

  • 3.0 API

    • に完全収録されている。 3.0.x ドキュメントページ.
    • HTTP オン http://localhost:10000/3.0/.
    • Websockets ポート上で 10000.

  • 3.x API

    • に完全収録されている。 3.x ドキュメントページ.
    • HTTP オン http://localhost:10001/.
    • Websockets ポート上で 10001.
    • 機能の向上と、ゲームエンジンとの連携の高速化。

ご都合の良いタイミングでアップグレード可能 — 既存のワークフローに支障をきたすことはありません。

非推奨のHTTPエンドポイント​

以下のエンドポイントは引き続き使用可能ですが、非推奨の警告が表示されます。 これらは 4.0代わりに代替ルートをご利用ください。

非推奨のパス交換
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

非推奨のルートがトリガーされると、 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" } } } ] }

値のマッピング：

古い coordinate_origin新しいプリセット
device_basearm_front （または defaults)
workspace_centerarm_front_centered

プリセットは、各デバイスごとに以下を通じて適用されます inverse3[*].configure.preset （または configure.preset （Verse Grip / ワイヤレス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" } } } }
軸の符号の規則が変更されました

参考​