塩基置換

基底は、Haply の内部座標系とアプリケーションの座標系との間をマッピングするために使用されます。

Haply デフォルトの座標系

Haply 右手座標系を使用：

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

動作原理

置換文字列は、アプリの座標系がHaply の座標系にどのようにマッピングされるかをサービスに伝えます。設定が完了すると、サービスから返される各値（位置、速度、 力、向き）はすべてアプリ側の座標系で表され、アプリから送信される各値も アプリ側の座標系に基づいて解釈されます。変換は自動的に、双方向に行われます。

この文字列は X、Y、Z の置換、必要に応じて + あるいは - 接頭辞として、特定の軸の極性を反転させるために使用されます。

例

置換	意味	代表的な用途
XYZ	恒等変換――再写像を行わない	Haply ネイティブアプリ
XZY	YとZを入れ替える → あなたの +Y が上向きになる	Y軸が上向きのエンジン
X-YZ	Yの符号を反転 → 左手座標系、Z軸を上向き	アンリアルエンジン
ZXY	3軸の循環置換	カスタム座標系

解説

"YZX" 表示：

• あなたのX軸=Haply のY（前）
• Y軸=Haply のZ（上）
• Z軸=Haply のX軸（右）

ベースの設定

WebSocket

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

HTTP

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 移行ガイド。