基底置换

该基础将Haply 的内部坐标系映射到您应用程序的坐标系。

标准参考系来自Haply

Haply 采用右手坐标系：

轴	方向
+X	Rechts
+Y	Vorwärts
+Z	顶部

工作原理如下

置换字符串用于告知该服务，您的应用程序的坐标轴应如何映射到Haply 中的坐标轴。设置完成后，该服务返回的每个值（位置、速度、 力、方向）都将以您的坐标系为基准进行表达，而您发送的每个值 也将以您的坐标系为基准进行解释。转换过程是自动进行的，且支持双向转换。

该字符串是以下字符的排列： X, Y, Z，可选，前面可加 + oder简体中文（大陆） -，以否定一个轴。

示例

排列	含义	典型用途
XYZ	身份——不重新归类	Haply-原生应用
XZY	Y 和 Z 互换 → 您的 Y 轴朝上	Y-up-Engines
X-YZ	Y negieren → 左手Z-up	虚幻引擎
ZXY	三个轴都在旋转	用户自定义坐标系

口译

"YZX" 意思是：

• 您的X轴对应于Haply 的Y轴（向前）
• 其Y轴对应于Haply （上图）的Z轴
• 其Z轴对应于Haply （右侧）的X轴

设定基准

WebSocket

{
  "session": {
    "configure": {
      "basis": { "permutation": "XZY" }
    }
  }
}

超文本传输协定

curl -X POST "http://localhost:10001/inverse3/0/config/basis?session=:0" \
     -H "Content-Type: application/json" \
     -d '{"permutation": "XZY"}'

该基础是持久的——您只需在发送第一条消息时将其设定一次，它就会一直 保持有效，直到被修改或会话结束为止。

从……迁移 session.set_basis

在 Legacy 命令之间，坐标轴的符号约定发生了变化 session.set_basis und session.configure.basis 已更改。一个在旧命令下有效的置换， 在新命令下可能会产生反向变换。如有需要，请反转坐标轴的 正负号（例如， X-ZY zu XZ-Y). 详情请参见 3.5 版迁移指南.