支持中心/SDK 与 API 文档

基底置换

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 轴(右侧)

奠定基础

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

在旧版与新版之间,坐标轴的符号约定发生了变化 session.set_basis 和 session.configure.basis. 一种在旧命令下有效的置换,在新的命令下可能会产生相反的变换。在必要时对轴的正负号进行取反(例如, X-ZY 变成 XZ-Y). 参见 3.5 迁移指南 详情请见。