升级至 3.5 版

本页面是 Inverse Service 3.5 的综合升级指南。它 涵盖了该服务中仍存在的所有已弃用功能——旧的传输格式 3.0, 其中规定了删除事宜 4.0、已弃用的 HTTP 端点， 以及已弃用的会话通道模拟命令。

此处列出的所有降级处理均仍被该服务所接受，以确保 向后兼容性。升级过程中所有功能均不会中断——请在 您方便的时候规划迁移。

---

API 版本 3.0 et 3.x

该服务同时提供两种JSON格式：旧格式 3.0 在港口 10000 以及当前的格式 3.x 在港口 10001. 这两者仍 可使用，以确保向后兼容性——集成 3.0 在升级过程中 仍可继续运行，无需进行任何更改。

注意

API 版本的支持 3.0 将被弃置于 4.0.

• 应用程序接口 3.0

  • 在以下文献中已有详尽记载： 文档页面 3.0.x.
  • HTTP sur http://localhost:10000/3.0/.
  • Websockets 在港口 10000.

• 应用程序接口 3.x

  • 在以下文献中已有详尽记载： 文档页面 3.x.
  • HTTP sur 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 (ou defaults)
workspace_center	arm_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" } } } }

修改后的坐标轴标注约定

---

参考文献

• 参数参考
• WebSocket 协议——全面详解 及流媒体帧结构。
• AsyncAPI 参考文档——机器可读模式 适用于 v3.1 中的所有有效载荷。
• HTTP API 参考——Swagger UI 接口，用于 当前的 HTTP 路由及其对上述已弃用的端点的 替代方案。