折旧说明

该服务目前支持两种不同的 JSON 格式： 3.0 和 3.x.两个版本同时提供，确保向后兼容。 兼容性。如果您正在使用 3.0 在您的模拟中使用的格式无需更改--它将继续像以前一样工作。 不过，我们鼓励您更新到 3.x 版本，以利用其增强功能和改进的游戏引擎集成性能 集成。

警告

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.
  • 改进了功能，并能更快地与游戏引擎集成。

您可以随时升级到最新格式，在不影响现有工作流程的情况下充分利用其优势。

模拟通道命令替换 (3.x)

以下两个会话级命令已弃用，并将在未来的 主要版本中移除。出于向后兼容性考虑，网络传输中仍接受这些命令， 但新的集成应使用 configure 列在 “替换”列中的条目。

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" } } } }

坐标轴符号约定已更改

这两个命令对轴-符号的解释有所不同。一种置换 在 下产生了正确的映射 session.set_basis 可以产生一个 逆变换 在……之下 session.configure.basis — 在迁移过程中，您可能需要 对一个或多个坐标轴的符号进行取反。

示例：一个运行正常的会话，其中 session.set_basis + "permutation": "X-ZY" 通常需要 "permutation": "XZ-Y" 在……之下 session.configure.basis. 在发布迁移之前，请务必重新验证生成的转换结果。