개요

xr-spatial-tracking 지시어는 WebXR Device API의 공간 추적(위치·방향, 6DoF) 기능 사용 여부를 제어합니다. navigator.xr.requestSession()으로 AR/VR 세션을 시작하고 사용자·환경의 공간 정보를 추적하는 것을 다루며, 기본 허용 목록은 self입니다.

자세히

`xr-spatial-tracking=(self)`는 자기 오리진, `xr-spatial-tracking=()`는 전면 차단, `xr-spatial-tracking=(self "https://xr.example.com")`는 지정 오리진에 위임합니다. WebXR 콘텐츠를 iframe으로 임베드하려면 `<iframe allow="xr-spatial-tracking">`가 필요합니다. 정책이 거부하면 navigator.xr.requestSession()이 반환하는 Promise가 거부되거나 추적이 제한됩니다.

공간 추적은 사용자의 물리 환경·움직임을 상세히 노출할 수 있어 프라이버시 민감도가 높습니다. WebXR은 보안 컨텍스트에서만 동작하고 몰입형 세션에는 사용자 동의가 요구됩니다. 실무에서는 accelerometer·gyroscope·magnetometer 같은 모션 센서 지시어와 함께 위임되는 경우가 많습니다. 구형 Feature-Policy의 xr-spatial-tracking을 대체합니다.

문법

Permissions-Policy: xr-spatial-tracking=(self)

실무 참고

• 공간 추적은 사용자의 방·움직임 정보를 노출할 수 있어 민감하니, WebXR이 필요한 오리진에만 허용하세요.
• WebXR 임베드는 xr-spatial-tracking과 함께 gyroscope·accelerometer·magnetometer도 위임해야 원활할 수 있습니다.

관련 지시어