メインコンテンツへ移動

バージョン3.5への移行

このページは、Inverse Service 3.5 の統合アップグレードガイドです。ここでは、 本サービスに依然として存在するすべての非推奨機能（旧形式の送信など）について解説しています。 3.0, その削除は以下で予定されている 4.0、非推奨となったHTTPエンドポイント、 および非推奨となったセッションチャネルシミュレーションコマンド。

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

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

このサービスは、2つのJSON形式を同時に公開しています。旧形式は 3.0 港で 10000 そして現在の形式 3.x 港で 10001. これら2つは、 下位互換性を確保するために引き続き利用可能です — 統合機能 3.0 アップグレード後も 変更を加えることなく動作し続けます。

ご注意

APIバージョンのサポート 3.0 ～のために放棄される 4.0.

  • API 3.0

    • 以下の資料に詳しく記載されています ドキュメントページ 3.0.x.
    • HTTP sur http://localhost:10000/3.0/.
    • Websockets 港で 10000.

  • API 3.x

    • 以下の資料に詳しく記載されています ドキュメントページ 3.x.
    • HTTP sur 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 (ou defaults)
workspace_centerarm_front_centered

プリセットは、各デバイスごとに以下の方法で適用されます。 inverse3[*].configure.preset (ou 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" } } } }
修正された軸の符号の規則

参照​