기저의 순열

기초는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(오른쪽)

기본 설정

웹소켓

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