迁移至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 应用程序接口

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

3.x 应用程序接口

完全记录在 3.x.x 文档页面.
HTTP 关于 http://localhost:10001/.
Websockets 在港口 10001.
功能得到增强，并与游戏引擎的集成速度更快.

随时升级——现有工作流程不受影响。

警告

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

已弃用的 HTTP 端点

以下 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 /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 路由及其替代方案，以取代上文列出的已弃用端点。