跳至主要内容

碱基置换

基底用于在Haply 的内部坐标系与您的应用程序坐标系之间进行映射。

Haply 默认坐标系​

Haply 使用右手坐标系：

轴方向
+X右
+Y前
+Z上

工作原理​

替换字符串用于告知服务，你的应用坐标轴如何映射到Haply 的坐标轴。设置完成后，服务返回的每个值（位置、速度、 力、方向）都将以你的坐标系表示，而你发送的每个值 都将按你的坐标系进行解释。转换是自动且双向的。

该字符串是 X、Y、Z 的置换，可选地以 + 或 - 作为前缀，用于对某个轴进行反相操作。

示例​

置换含义典型应用
XYZ恒等变换——不进行重映射Haply 原生应用
XZY交换 Y 和 Z → 你的 +Y 朝上Y 轴朝上的引擎
X-YZ对 Y 取反 → 左手坐标系、Z 轴朝上虚幻引擎
ZXY三个轴的循环置换自定义坐标系

解释​

"YZX" 表示：

  • 你的X轴 =Haply 的Y（前）
  • 你的Y轴 =Haply 的Z（上）
  • 你的Z轴 =Haply 的X 轴（右侧）

设置底层​

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

基底是持久的——在第一条消息中设置一次后，它将一直有效，直到被更改或会话结束为止。

从 session.set_basis 迁移

轴符号约定在旧版中 session.set_basis 与 session.configure.basis 之间发生了变化。在旧命令下有效的置换，在新命令下可能会产生反向的变换。必要时请对轴符号取反（例如，X-ZY 变为 XZ-Y）。 详情请参阅 3.5 迁移指南。