迁移至 3.5

本页面是 Inverse Service 3.5 的综合升级指南。它 涵盖了该服务中所有尚未移除的弃用功能——即旧版 3.0 计划于 4.0、已弃用的 HTTP 端点， 以及已弃用的会话通道模拟命令。

出于向后兼容性的考虑，此处列出的所有已弃用功能在实际传输中仍被接受。升级时不会导致任何功能失效——请根据您的实际情况安排迁移。

---

3.0 vs 3.x API 版本

该服务提供了两种并行的 JSON 格式：旧版 3.0 格式 在端口上 10000 以及当前的 3.x 端口上的格式 10001. 两者均保留 以保持向后兼容性 — 3.0 升级后，集成任务将继续 照常运行。

警告

3.0 将放弃对以下应用程序接口版本的支持 4.0.

• 3.0 应用程序接口

  • 完全记录在 3.0.x 文档页面.
  • HTTP 关于 http://localhost:10000/3.0/.
  • Websockets 在港口 10000.

• 3.x 应用程序接口

  • 完全记录在 3.x 文档页面.
  • HTTP 关于 http://localhost:10001/.
  • Websockets 在港口 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 活动频道上的活动，同时包含旧路线及其 替代路线。

---

已弃用的会话通道命令

以下两个会话级模拟命令已弃用，并将在 未来的重大版本中移除。它们在 网络传输中仍然被接受；新的集成应使用 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_base	arm_front （或 defaults)
workspace_center	arm_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" } } } }

坐标轴符号约定已更改

---

参考资料

• 设置参考
• WebSocket 协议— 完整快照 以及流式帧布局。
• AsyncAPI 参考文档— 适用于所有 v3.1 有效载荷的 机器可读模式。
• HTTP API 参考文档— Swagger UI，用于查看 当前的 HTTP 路由及其对上述已弃用端点的替代方案 。