기저 순열(Basis Permutation)

기저(basin)는 Haply의 내부 좌표계와 사용자 애플리케이션의 좌표계 간에 매핑을 수행합니다.

Haply 기본 프레임

Haply는 오른손 좌표계를사용합니다:

축	방향
+X	오른쪽
+Y	앞쪽
+Z	위쪽

작동 원리

순열 문자열은 서비스에 애플리케이션의 좌표계가 Haply의 좌표계와 어떻게 대응되는지 알려줍니다. 이 설정을 적용하면 서비스가 반환하는 모든 값(위치, 속도, 힘, 방향)은 사용자의 기준 좌표계로 표현되며, 사용자가 전송하는 모든 값은사용자의 기준 좌표계를 기준으로 해석됩니다. 변환은 자동으로 이루어지며 양방향으로 작동합니다.

이 문자열은 X, Y, Z의 순열이며, 축을 반전하려면 선택적으로 + 또는 - 접두사를 붙일 수 있습니다.

예시

순열	의미	일반적인 용도
XYZ	항등 — 재매핑 없음	Haply 네이티브 앱
XZY	Y와 Z 교환 → 사용자의 +Y가 위쪽	Y-up 엔진
X-YZ	Y 반전 → 왼손 Z-up	언리얼 엔진
ZXY	세 축을 모두 순환	사용자 정의 프레임

해석

"YZX"는 다음을 의미합니다:

• 사용자의 X축 = Haply의 Y축 (앞쪽)
• 사용자의 Y축 = Haply의 Z축 (위쪽)
• 사용자의 Z축 = Haply의 X축 (오른쪽)

기본 설정

웹소켓

{
  "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 마이그레이션 가이드를 참조하십시오.