WebXR 디바이스 API

몰입형 XR 디바이스 목록이 변경될 때마다 유저 에이전트는 다음 단계를 실행하여 몰입형 XR 디바이스를 선택해야 합니다:

1. oldDevice를 몰입형 XR 디바이스로 둡니다.

2. 몰입형 XR 디바이스 목록이 빈 리스트라면, 몰입형 XR 디바이스를 null로 설정합니다.

3. 몰입형 XR 디바이스 목록의 크기가 1이라면, 몰입형 XR 디바이스를 몰입형 XR 디바이스 목록[0]으로 설정합니다.

4. 몰입형 XR 디바이스를 다음과 같이 설정합니다:

   활성화된 XRSession이 있고 몰입형 XR 디바이스 목록에 oldDevice가 포함되어 있으면:

   몰입형 XR 디바이스를 oldDevice로 설정합니다.

   그 외:

   몰입형 XR 디바이스를 유저 에이전트가 선택한 디바이스로 설정합니다.

5. 필요하다면 인라인 XR 디바이스를 몰입형 XR 디바이스로 갱신하거나, 그렇지 않으면 기본 인라인 XR 디바이스로 갱신할 수 있습니다.

6. 기기가 처음 열거된 경우 또는 oldDevice가 몰입형 XR 디바이스와 같다면, 이 단계를 중단합니다.

7. 활성 XRSession을 종료합니다.

8. 작업을 큐에 추가하여 XR compatible 불리언 값을 모든 WebGLRenderingContextBase 인스턴스에 대해 false로 설정합니다.

9. 작업을 큐에 추가하여 이벤트를 발생시키는데, devicechange라는 이름의 이벤트를 관련 전역 객체의 navigator의 xr에 발생시킵니다.

10. 작업을 큐에 추가하여 몰입형 XR 디바이스 또는 인라인 XR 디바이스의 변경에 영향을 받는 모든 XRPermissionStatus 객체에 대해 적절한 change 이벤트를 발생시킵니다.

참고: 이 단계들은 반드시 병렬로 실행되어야 합니다.

유저 에이전트는 다음 단계를 실행하여 몰입형 XR 디바이스가 선택되었는지 확인할 수 있습니다:

1. 몰입형 XR 디바이스가 null이 아니면 몰입형 XR 디바이스를 반환하고, 이 단계를 중단합니다.

2. 몰입형 XR 디바이스를 열거합니다.

3. 몰입형 XR 디바이스를 선택합니다.

4. 몰입형 XR 디바이스를 반환합니다.

참고: 이 단계들은 반드시 병렬로 실행되어야 합니다.

이 메서드가 호출되면 다음 단계를 실행해야 합니다:

1. promise를 이 XRSystem의 관련 realm에서 새 Promise로 둡니다.

2. mode가 "inline"이면, resolve promise를 true로 하고 반환합니다.

3. 요청하는 문서의 origin이 "xr-spatial-tracking" permissions policy를 사용할 수 없다면, reject promise를 "SecurityError" DOMException 으로 하고 반환합니다.

4. 세션 mode가 지원되는지 다음과 같이 확인합니다:

   유저 에이전트와 시스템이 절대 지원하지 않는 mode 세션이라면

   resolve promise를 false로 합니다.

   유저 에이전트와 시스템이 보통 지원하는 mode 세션이라면

   여기서 유저 에이전트 문자열로 구별할 수 없는 모든 인스턴스가 동일한 결과를 내는 경우에 한해 promise를 resolve true로 할 수 있습니다.

   그 외의 경우

   다음 단계를 병렬로 실행합니다:

   1. device를 몰입형 XR 디바이스가 선택되었는지 확인의 결과로 설정합니다.

   2. device가 null이면, resolve promise를 false로 하고 이 단계를 중단합니다.

   3. device의 지원 모드 목록에 mode가 없다면, 작업을 큐에 추가하여 resolve promise를 false로 하고 이 단계를 중단합니다.

   4. 권한 요청을 강력한 기능 "xr-session-supported"에 대해 XRSessionSupportedPermissionDescriptor 및 mode 값을 mode로 하여 요청합니다. 결과가 "denied"라면, 작업을 큐에 추가하여 resolve promise를 false로 하고 이 단계를 중단합니다. 자세한 정보는 핑거프린팅 고려사항을 참고하세요.

   5. 작업을 큐에 추가하여 resolve promise를 true로 합니다.

5. promise를 반환합니다.

requestSession(mode, options) 메서드는 가능한 경우 주어진 mode에 대한 XRSession을 초기화하려 시도하며, 필요하다면 몰입형 모드로 진입합니다.

이 메서드가 호출되면 유저 에이전트는 다음 단계를 실행해야 합니다:

1. promise를 이 XRSystem의 관련 realm에서 새 Promise로 둡니다.

2. mode가 몰입형 세션 모드라면 immersive를 true로, 아니면 false로 둡니다.

3. global object를 이 메서드가 호출된 XRSystem의 관련 전역 객체로 둡니다.

4. 세션 요청이 허용되는지 다음과 같이 확인합니다:

   immersive가 true인 경우:

   1. 몰입형 세션 요청이 허용되는지 global object에 대해 확인하고, 허용되지 않으면 reject promise를 "SecurityError" DOMException 으로 하고 반환합니다.

   2. 대기 중인 몰입형 세션이 true이거나 활성 몰입형 세션이 null이 아니면, reject promise를 "InvalidStateError" DOMException 으로 하고 반환합니다.

   3. 대기 중인 몰입형 세션을 true로 설정합니다.

   그 외:

   인라인 세션 요청이 허용되는지 global object에 대해 확인하고, 허용되지 않으면 reject promise를 "SecurityError" DOMException 으로 하고 반환합니다.

5. 다음 단계를 병렬로 실행합니다:

   1. requiredFeatures를 options의 requiredFeatures로 둡니다.

   2. optionalFeatures를 options의 optionalFeatures로 둡니다.

   3. device를 현재 디바이스 얻기의 결과로 mode, requiredFeatures, optionalFeatures를 전달하여 설정합니다.

   4. 작업을 큐에 추가하여 다음 단계를 실행합니다:

      1. device가 null이거나 device의 지원 모드 목록에 mode가 없다면, 다음 단계를 실행합니다:

         1. reject promise를 "NotSupportedError" DOMException으로 합니다.

         2. immersive가 true라면 대기 중인 몰입형 세션을 false로 설정합니다.

         3. 이 단계를 중단합니다.

      2. descriptor를 XRPermissionDescriptor로 초기화하며, mode, requiredFeatures, optionalFeatures로 초기화합니다.

      3. status를 XRPermissionStatus로, 초기값 null로 둡니다.

      4. xr 권한 요청을 descriptor, status로 실행합니다.

      5. status의 state가 "denied"라면, 다음 단계를 실행합니다:

         1. reject promise를 "NotSupportedError" DOMException으로 합니다.

         2. immersive가 true라면 대기 중인 몰입형 세션을 false로 설정합니다.

         3. 이 단계를 중단합니다.

      6. granted를 status의 granted에서 얻은 집합으로 둡니다.

      7. session을 이 XRSystem의 관련 realm에서 새 XRSession 객체로 둡니다.

      8. 세션 초기화를 session, mode, granted, device로 실행합니다.

      9. 활성 몰입형 세션을 필요에 따라 다음과 같이 설정합니다:

         immersive가 true인 경우:

         활성 몰입형 세션을 session으로, 대기 중인 몰입형 세션을 false로 설정합니다.

         그 외:

         session을 인라인 세션 목록에 추가합니다.

      10. resolve promise를 session으로 합니다.

      11. 작업을 큐에 추가하여 다음 단계를 실행합니다:

          참고: 이 단계는 초기 inputsourceschange 이벤트가 초기 세션 resolve 이후 발생하도록 보장합니다.

          1. session의 promise resolved 플래그를 true로 설정합니다.

          2. sources를 session에 연결된 기존 입력 소스로 둡니다.

          3. sources가 비어있지 않으면 다음 단계를 실행합니다:

             1. session의 활성 XR 입력 소스 목록을 sources로 설정합니다.

             2. XRInputSourcesChangeEvent의 inputsourceschange 이벤트를 session에 대해 added를 sources로 하여 발생시킵니다.

6. promise를 반환합니다.

현재 디바이스 얻기는 XRSessionMode mode, requiredFeatures, optionalFeatures에 대해 유저 에이전트가 다음 단계를 실행해야 합니다:

1. 다음 중 하나로 device를 선택합니다:

   mode가 몰입형 세션 모드인 경우:

   device를 몰입형 XR 디바이스가 선택되었는지 확인의 결과로 설정합니다.

   requiredFeatures 또는 optionalFeatures가 비어 있지 않다면:

   device를 인라인 XR 디바이스로 설정합니다.

   그 외:

   device를 기본 인라인 XR 디바이스로 설정합니다.

2. device를 반환합니다.

참고: 이 단계들은 반드시 병렬로 실행되어야 합니다.

세션 초기화를 위해 session, mode, granted, device를 받아 다음 단계를 유저 에이전트가 실행해야 합니다:

1. session의 mode를 mode로 설정합니다.

2. session의 XR 디바이스를 device로 설정합니다.

3. session의 허용된 기능 집합을 granted로 설정합니다.

4. 렌더 상태 초기화를 실행합니다.

5. 유저 에이전트의 다른 기능에서 이미 초기화하지 않았다면, 플랫폼 특화 단계(트래킹 및 렌더링 초기화, 필요한 경우 사용자를 위한 안내 포함)를 수행합니다.

참고: 일부 기기는 활성화를 위해 추가 사용자 안내가 필요할 수 있습니다. 예를 들어, 휴대폰 기반 헤드셋에서 몰입형 모드로 진입하려면 폰을 헤드셋에 꽂아야 하고, 데스크톱 브라우저에서 외부 헤드셋에 연결되어 있다면 헤드셋을 착용해야 합니다. 이러한 안내를 표시하는 책임은 저자가 아니라 유저 에이전트에 있습니다.

XRSession session이 종료되면 다음 단계를 실행합니다:

1. session의 ended 값을 true로 설정합니다.

2. 활성 몰입형 세션이 session과 같으면, 활성 몰입형 세션을 null로 설정합니다.

3. session을 인라인 세션 목록에서 제거합니다.

4. session이 반환한 미해결 promise를 InvalidStateError로 Reject합니다(end()가 반환한 promise 제외).

5. 유저 에이전트의 다른 기능이 더 이상 사용하지 않는다면, 디바이스의 트래킹 및 렌더링 기능을 종료하기 위한 플랫폼 특화 단계를 반드시 수행해야 합니다. 이 단계에는 반드시 다음이 포함됩니다:

   • session이 몰입형 세션인 경우, XR 디바이스에 대한 독점 액세스를 해제합니다.

   • session이 XR 디바이스에 표시를 위해 획득한 그래픽 리소스를 해제합니다.

   • session이 몰입형 세션일 경우, XR 디바이스가 다른 소스가 동일 디바이스로 세션을 시작할 수 있는 상태로 만듭니다.

6. 작업 큐에 추가하여 XRSessionEvent 타입의 end 이벤트를 session에 발생시킵니다.

end() 메서드는 세션을 수동으로 종료할 수 있는 방법을 제공합니다. 호출되면 다음 단계를 반드시 실행해야 합니다:

1. promise를 이 XRSession의 관련 realm에서 새 Promise로 둡니다.

2. ended 값이 true이면, reject promise를 "InvalidStateError" DOMException 으로 하고 반환합니다.

3. 세션 종료 단계를 this에 대해 실행합니다.

4. 작업 큐에 추가하여 다음 단계를 실행합니다:

   1. 세션 종료와 관련된 모든 플랫폼 특화 단계가 완료될 때까지 대기합니다.

   2. resolve promise.

5. promise를 반환합니다.

유저 에이전트가 XRSession session과 XRRenderStateInit newState로 대기 중 레이어 상태 업데이트를 할 때 다음 단계를 실행해야 합니다:

1. newState의 layers 값이 null이 아니면, NotSupportedError를 throw 합니다.

참고: WebXR layers module에서 이 알고리즘에 대한 새로운 의미를 도입할 예정입니다.

유저 에이전트가 XRSession session에 rate로 기본 프레임률 적용을 하고자 할 때 다음 단계를 반드시 실행해야 합니다:

1. rate가 session의 내부 기본 프레임률과 같으면 이 단계를 중단합니다.

2. session의 ended 값이 true이면 이 단계를 중단합니다.

3. session의 내부 기본 프레임률을 rate로 설정합니다.

4. XRSessionEvent 타입의 frameratechange 이벤트를 session에 발생시킵니다.

updateTargetFrameRate(rate) 메서드는 목표 프레임률 rate를 XRSession에 전달합니다.

이 메서드가 호출되면 유저 에이전트는 다음 단계를 실행해야 합니다:

1. session을 this로 둡니다.

2. promise를 session의 관련 realm에서 새 Promise로 둡니다.

3. session에 내부 기본 프레임률이 없으면, reject promise를 "InvalidStateError" DOMException 으로 하고 반환합니다.

4. session의 ended 값이 true이면, reject promise를 "InvalidStateError" DOMException 으로 하고 반환합니다.

5. rate가 supportedFrameRates 에 포함되지 않으면, reject promise를 "TypeError" DOMException 으로 하고 반환합니다.

6. session의 내부 목표 프레임률을 rate로 설정합니다.

7. 작업 큐에 추가하여 다음 단계를 실행합니다:

   1. XR 컴포지터는 rate를 사용해 새로운 디스플레이 프레임률 및/또는 기본 프레임률을 계산할 수 있습니다.

   2. newrate를 새 기본 프레임률로 둡니다.

   3. 작업 큐에 추가하여 다음 단계를 실행합니다:

      1. XRSystem의 기본 프레임률을 newrate로 갱신하는 작업이 완료될 때까지 대기합니다.

      2. 기본 프레임률 적용을 newrate, session으로 실행합니다.

      3. resolve promise.

8. promise를 반환합니다.

updateRenderState(newState) 메서드는 활성 렌더 상태에 다음 프레임에 적용될 업데이트를 큐에 올립니다. 이 메서드에 전달된 XRRenderStateInit newState의 설정되지 않은 필드는 변경되지 않습니다.

이 메서드가 호출되면 유저 에이전트는 다음 단계를 실행해야 합니다:

1. session을 this로 둡니다.

2. session의 ended 값이 true이면, InvalidStateError를 throw 하고 단계를 중단합니다.

3. newState의 baseLayer 가 session이 아닌 XRSession으로 생성됐다면 InvalidStateError를 throw 하고 단계를 중단합니다.

4. newState의 inlineVerticalFieldOfView 가 설정되어 있고 session이 몰입형 세션이면, InvalidStateError를 throw 하고 단계를 중단합니다.

5. newState의 depthNear, depthFar, inlineVerticalFieldOfView, baseLayer, layers 중 어떤 것도 설정되어 있지 않다면, 단계를 중단합니다.

6. 대기 중 레이어 상태 업데이트를 session, newState로 실행합니다.

7. activeState를 session의 활성 렌더 상태로 둡니다.

8. session의 대기 중 렌더 상태가 null이면, activeState의 복사본으로 설정합니다.

9. newState의 passthroughFullyObscured 값이 설정되어 있으면, session의 대기 중 렌더 상태의 passthroughFullyObscured 를 newState의 해당 값으로 설정합니다.

10. newState의 depthNear 값이 설정되어 있으면 session의 대기 중 렌더 상태의 depthNear 를 newState의 해당 값으로 설정합니다.

11. newState의 depthFar 값이 설정되어 있으면 session의 대기 중 렌더 상태의 depthFar 를 newState의 해당 값으로 설정합니다.

12. newState의 inlineVerticalFieldOfView 값이 설정되어 있으면 session의 대기 중 렌더 상태의 inlineVerticalFieldOfView 를 newState의 해당 값으로 설정합니다.

13. newState의 baseLayer 값이 설정되어 있으면 session의 대기 중 렌더 상태의 baseLayer 를 newState의 해당 값으로 설정합니다.

요청 시, XRSession session은 반드시 다음 단계를 실행하여 대기 중 렌더 상태를 적용해야 합니다:

1. activeState를 session의 활성 렌더 상태로 둡니다.

2. newState를 session의 대기 중 렌더 상태로 둡니다.

3. session의 대기 중 렌더 상태를 null로 설정합니다.

4. oldBaseLayer를 activeState의 baseLayer로 둡니다.

5. oldLayers를 activeState의 layers로 둡니다.

6. 작업을 큐에 추가하여 다음 단계를 실행합니다:

   1. activeState를 newState로 설정합니다.

   2. oldBaseLayer가 activeState의 baseLayer와 다르거나, oldLayers가 activeState의 layers와 다르거나, 또는 어떤 레이어의 크기가 변경되었다면, 뷰포트 업데이트를 session에 대해 실행합니다.

   3. activeState의 inlineVerticalFieldOfView 가 session의 최소 인라인 시야각보다 작으면, activeState의 inlineVerticalFieldOfView 를 session의 최소 인라인 시야각으로 설정합니다.

   4. activeState의 inlineVerticalFieldOfView 가 session의 최대 인라인 시야각보다 크면, activeState의 inlineVerticalFieldOfView 를 session의 최대 인라인 시야각으로 설정합니다.

   5. activeState의 depthNear 가 session의 최소 근거리 클리핑 평면보다 작으면, activeState의 depthNear 를 session의 최소 근거리 클리핑 평면으로 설정합니다.

   6. activeState의 depthFar 가 session의 최대 원거리 클리핑 평면보다 크면, activeState의 depthFar 를 session의 최대 원거리 클리핑 평면으로 설정합니다.

   7. baseLayer를 activeState의 baseLayer로 둡니다.

   8. activeState의 composition enabled와 output canvas를 다음과 같이 설정합니다:

      session의 mode가 "inline" 이고, baseLayer가 XRWebGLLayer의 인스턴스이며 composition enabled가 false인 경우:

      activeState의 composition enabled 불리언을 false로 설정합니다.

      activeState의 output canvas를 baseLayer의 context의 canvas로 설정합니다.

      그 외의 경우:

      activeState의 composition enabled 불리언을 true로 설정합니다.

      activeState의 output canvas를 null로 설정합니다.

이 메서드가 호출되면, 유저 에이전트는 다음 단계를 실행해야 합니다:

1. promise를 이 XRSession의 관련 realm에서 새 Promise로 둡니다.

2. 다음 단계를 병렬로 실행합니다:

   1. reference space is supported를 type과 session에 대해 실행한 결과가 false이면, 작업을 큐에 추가하여 reject promise를 NotSupportedError로 하고 이 단계를 중단합니다.

   2. type 타입의 reference space를 트래킹하기 위해 필요한 플랫폼 리소스를 셋업합니다.

      유저 에이전트는 해당 reference space의 트래킹이 설정될 때까지 기다릴 필요 없이 requestReferenceSpace() 를 resolve할 수 있습니다. 세션이 초기 트래킹을 시도하는 동안 getViewerPose() 가 null을 반환해도 괜찮으며, 콘텐츠는 이 시간을 스플래시 화면 등으로 활용할 수 있습니다. type이 "bounded-floor" 이고 경계가 아직 설정되지 않았다면, 유저 에이전트는 경계를 작은 초기 영역으로 두고 나중에 reset 이벤트로 갱신할 수 있습니다.

   3. 작업을 큐에 추가하여 다음 단계를 실행합니다:

   4. reference space 생성을 type, session으로 하여 referenceSpace로 둡니다.

   5. resolve promise를 referenceSpace로 합니다.

3. promise를 반환합니다.

새로운 XR 입력 소스가 사용 가능해질 때 XRSession session에 대해 유저 에이전트는 다음 단계를 실행해야 합니다:

1. session의 promise resolved 플래그가 설정되지 않았다면, 이 단계를 중단합니다.

2. added primary sources를 새로운 리스트로 둡니다.

3. added tracked sources를 새로운 리스트로 둡니다.

4. 각 새로운 XR 입력 소스에 대해:

   1. inputSource를 이 XRSession의 관련 realm에서 새 XRInputSource로 두고, 다음 단계를 실행합니다:

      inputSource가 기본 입력 소스인 경우:

      inputSource를 added primary sources에 추가합니다.

      그 외의 경우:

      inputSource를 added tracked sources에 추가합니다.

5. 작업을 큐에 추가하여 다음 단계를 실행합니다:

   1. 확장 session의 활성 XR 입력 소스 목록 에 added primary sources를 추가합니다.

   2. added primary sources가 비어있지 않으면, XRInputSourcesChangeEvent 타입의 inputsourceschange 이벤트를 session에 대해 added 를 added primary sources로 하여 발생시킵니다.

   3. 확장 session의 활성 XR 추적 소스 목록에 added tracked sources를 추가합니다.

   4. added tracked sources가 비어있지 않으면, XRInputSourcesChangeEvent 타입의 trackedsourceschange 이벤트를 session에 대해 added 를 added tracked sources로 하여 발생시킵니다.

이전에 추가된 XR 입력 소스가 더 이상 사용 가능하지 않을 때 XRSession session에 대해, 유저 에이전트는 반드시 다음 단계를 실행해야 합니다:

1. session의 promise resolved 플래그가 설정되어 있지 않으면, 이 단계를 중단합니다.

2. removed primary sources를 새로운 리스트로 둡니다.

3. removed tracked sources를 새로운 리스트로 둡니다.

4. 더 이상 사용 가능하지 않은 각 XR 입력 소스에 대해:

   1. inputSource를 session의 활성 XR 입력 소스 목록에 연결된 XR 입력 소스의 XRInputSource로 둔 뒤, 다음 단계를 수행합니다:

      inputSource가 기본 입력 소스인 경우:

      inputSource를 removed primary sources에 추가합니다.

      그 외의 경우:

      inputSource를 removed tracked sources에 추가합니다.

5. 작업을 큐에 추가하여 다음 단계를 실행합니다:

   1. 제거 removed primary sources에 있는 각 XRInputSource를 session의 활성 XR 입력 소스 목록에서 제거합니다.

   2. removed primary sources가 비어있지 않으면, XRInputSourcesChangeEvent 타입의 inputsourceschange 이벤트를 session에 대해 removed 를 removed primary sources로 하여 발생시킵니다.

   3. 제거 removed tracked sources에 있는 각 XRInputSource를 session의 활성 XR 추적 소스 목록에서 제거합니다.

   4. removed tracked sources가 비어있지 않으면, XRInputSourcesChangeEvent 타입의 trackedsourceschange 이벤트를 session에 대해 removed 를 removed tracked sources로 하여 발생시킵니다.

참고: 유저 에이전트는 입력 소스가 위치와 방향 트래킹을 모두 일시적으로 잃을 때 이 이벤트를 발생시킬 수 있습니다. 이는 물리적 핸드헬드 컨트롤러 입력 소스에만 권장되며, 트래킹 손 입력 소스의 경우 자주 발생하므로 이 이벤트를 발생시키는 것은 권장되지 않고, 트래커 오브젝트 입력 소스의 경우도 애플리케이션이 신원 개념을 유지하기 어렵게 하므로 권장되지 않습니다.

handedness, targetRayMode, profiles, gripSpace 의 존재, 그리고 기본 입력 소스 또는 트래킹 입력 소스로서의 상태가 XR 입력 소스에서 변경되었을 때 XRSession session에 대해, 유저 에이전트는 반드시 다음 단계를 실행해야 합니다:

1. session의 promise resolved 플래그가 설정되어 있지 않으면, 이 단계를 중단합니다.

2. added primary sources를 새로운 리스트로 둡니다.

3. removed primary sources를 새로운 리스트로 둡니다.

4. added tracked sources를 새로운 리스트로 둡니다.

5. removed tracked sources를 새로운 리스트로 둡니다.

6. 변경된 각 XR 입력 소스에 대해:

   1. oldInputSource를 session의 활성 XR 입력 소스 목록에 연결된 이전 XR 입력 소스의 XRInputSource로 두고, 다음 단계를 수행합니다:

      oldInputSource가 기본 입력 소스이거나, 상태가 기본 입력 소스에서 트래킹 입력 소스로 바뀐 경우:

      oldInputSource를 removed primary sources에 추가합니다.

      그 외의 경우:

      oldInputSource를 removed tracked sources에 추가합니다.

   2. newInputSource를 session의 관련 realm에서 새 XRInputSource로 두고, 다음 단계를 수행합니다:

      newInputSource가 기본 입력 소스이거나, 상태가 트래킹 입력 소스에서 기본 입력 소스로 바뀐 경우:

      newInputSource를 added primary sources에 추가합니다.

      그 외의 경우:

      newInputSource를 added tracked sources에 추가합니다.

7. 작업을 큐에 추가하여 다음 단계를 실행합니다:

   1. 제거 removed primary sources에 있는 각 XRInputSource를 session의 활성 XR 입력 소스 목록에서 제거합니다.

   2. 확장 session의 활성 XR 입력 소스 목록에 added primary sources를 추가합니다.

   3. added primary sources 또는 removed primary sources가 비어있지 않으면, XRInputSourcesChangeEvent 타입의 inputsourceschange 이벤트를 session에 대해 added 를 added primary sources로 하고, removed 를 removed primary sources로 하여 발생시킵니다.

   4. 제거 removed tracked sources에 있는 각 XRInputSource를 session의 활성 XR 추적 소스 목록에서 제거합니다.

   5. 확장 session의 활성 XR 입력 소스 목록에 added tracked sources를 추가합니다.

   6. added tracked sources 또는 removed tracked sources가 비어있지 않으면, XRInputSourcesChangeEvent 타입의 trackedsourceschange 이벤트를 session에 대해 added 를 added tracked sources로 하고, removed 를 removed tracked sources로 하여 발생시킵니다.

XRRenderState 객체가 XRSession session에 대해 생성될 때, 유저 에이전트는 반드시 다음 단계를 실행하여 렌더 상태를 초기화해야 합니다:

1. state를 session의 관련 realm에서 새 XRRenderState 객체로 둡니다.

2. state의 depthNear 를 0.1로 초기화합니다.

3. state의 depthFar 를 1000.0으로 초기화합니다.

4. state의 passthroughFullyObscured 를 false로 초기화합니다.

5. state의 inlineVerticalFieldOfView 는 다음과 같이 초기화합니다:

   session이 인라인 세션인 경우:

   state의 inlineVerticalFieldOfView 를 PI * 0.5로 초기화합니다.

   그 외의 경우:

   state의 inlineVerticalFieldOfView 를 null로 초기화합니다.

6. state의 baseLayer 를 null로 초기화합니다.

requestAnimationFrame(callback) 메서드는 다음 번 유저 에이전트가 디바이스의 애니메이션 프레임을 실행하고자 할 때 callback을 실행하도록 큐에 올립니다.

이 메서드가 호출되면, 유저 에이전트는 반드시 다음 단계를 실행해야 합니다:

1. session을 this로 둡니다.

2. session의 ended 값이 true이면, 0을 반환하고 단계를 중단합니다.

3. session의 애니메이션 프레임 콜백 식별자를 1 증가시킵니다.

4. callback을 session의 애니메이션 프레임 콜백 목록에, session의 애니메이션 프레임 콜백 식별자 현재 값과 연결하여 추가합니다.

5. session의 애니메이션 프레임 콜백 식별자의 현재 값을 반환합니다.

cancelAnimationFrame(handle) 메서드는 애니메이션 프레임 콜백 식별자 handle에 해당하는 기존 애니메이션 프레임 콜백을 취소합니다.

이 메서드가 호출되면, 유저 에이전트는 반드시 다음 단계를 실행해야 합니다:

1. session을 this로 둡니다.

2. session의 애니메이션 프레임 콜백 목록 또는 session의 현재 실행 중인 애니메이션 프레임 콜백 목록 중 handle과 연결된 항목을 찾습니다.

3. 해당 항목이 있으면, 그 항목의 cancelled 불리언을 true로 설정하고 session의 애니메이션 프레임 콜백 목록에서 제거합니다.

1. state의 baseLayer 가 null이면 false를 반환합니다.

2. true를 반환합니다.

참고: WebXR layers module에서 이 알고리즘의 새로운 의미가 도입될 예정입니다.

1. 레이어 상태 확인을 session의 renderState로 실행한 결과가 false이면 false를 반환합니다.

2. session의 mode가 "inline"이고, session의 renderState의 output canvas가 null이면 false를 반환합니다.

3. true를 반환합니다.

XRSession session이 viewer 상태를 타임스탬프 frameTime으로 XR 디바이스에서 갱신받았을 때, XR 애니메이션 프레임을 실행하며, 애니메이션 프레임 콜백 목록이 비어 있든 아니든 반드시 다음 단계를 실행해야 합니다:

1. 작업을 큐에 추가하여 다음 단계를 수행합니다:

   1. now를 현재 고해상도 시간으로 둡니다.

   2. frame을 session의 애니메이션 프레임으로 둡니다.

   3. frame의 time을 frameTime으로 설정합니다.

   4. frame의 predictedDisplayTime 을 frameTime으로 설정합니다.

   5. session의 mode가 "inline"이 아니면, frame의 predictedDisplayTime 을 XR 컴포지터가 이 XR 애니메이션 프레임을 표시할 것으로 예상되는 평균 타임스탬프로 설정합니다.

   6. 뷰 목록의 각 view에 대해, view의 viewport modifiable 플래그를 true로 설정합니다.

   7. 만약 뷰 목록 내 어떤 view의 active 플래그가 이전 XR 애니메이션 프레임 이후로 변경되었으면, 뷰포트 업데이트를 실행합니다.

   8. 프레임이 렌더링되어야 한다면 session에 대해:

      1. session의 현재 실행 중인 애니메이션 프레임 콜백 목록을 session의 애니메이션 프레임 콜백 목록으로 설정합니다.

      2. session의 애니메이션 프레임 콜백 목록을 빈 배열로 설정합니다.

      3. frame의 active 불리언을 true로 설정합니다.

      4. 프레임 업데이트 적용을 frame에 대해 실행합니다.

      5. session의 현재 실행 중인 애니메이션 프레임 콜백 목록의 각 entry에 대해 순서대로:

      6. entry의 cancelled 불리언이 true면 다음 entry로 넘어갑니다.

      7. 콜백 함수 호출을 entry에 대해 « now, frame » 및 "report"로 실행합니다.

      8. session의 현재 실행 중인 애니메이션 프레임 콜백 목록을 빈 리스트로 설정합니다.

      9. frame의 active 불리언을 false로 설정합니다.

   9. session의 대기 중 렌더 상태가 null이 아니면, 대기 중 렌더 상태 적용을 실행합니다.

getViewerPose(referenceSpace) 메서드는 XRFrame의 time 시점에 referenceSpace를 기준으로 viewer의 pose를 XRViewerPose로 제공합니다.

이 메서드가 호출되면 유저 에이전트는 반드시 다음 단계를 실행해야 합니다:

1. frame을 this로 둡니다.

2. session을 frame의 session 객체로 둡니다.

3. frame의 animationFrame 불리언이 false면, InvalidStateError를 throw 하고 단계를 중단합니다.

4. pose를 session의 관련 realm에서 새 XRViewerPose 객체로 둡니다.

5. session의 viewer reference space의 pose를 referenceSpace 기준에서 frame이 나타내는 시점에 pose에 populate하고, force emulation을 true로 설정합니다.

6. pose가 null이면 null을 반환합니다.

7. xrviews를 빈 리스트로 둡니다.

8. offset를 0으로 설정한다.

9. 활성 뷰(view) view마다 session의 뷰 목록(list of views)에서 다음 단계를 수행한다:

   1. xrview를 session의 relevant realm에서 새로운 XRView 객체로 생성한다.

   2. xrview의 underlying view를 view로 초기화한다.

   3. xrview의 eye를 view의 eye로 초기화한다.

   4. xrview의 index를 offset으로 초기화한다.

   5. xrview의 frame을 frame으로 초기화한다.

   6. xrview의 session을 session으로 초기화한다.

   7. xrview의 reference space를 referenceSpace로 초기화한다.

   8. viewtransform을 view offset과 동일한 session의 relevant realm에서 new XRRigidTransform 객체로 생성한다.

   9. xrview의 transform 속성을 곱셈(multiplying)의 결과값, 즉 XRViewerPose의 transform과 viewtransform 변환을 session의 relevant realm에서 곱한 결과로 설정한다.

   10. xrviews에 xrview를 추가한다.

   11. offset을 1만큼 증가시킨다.

10. pose의 views를 xrviews로 설정합니다.

11. pose를 반환합니다.

getPose(space, baseSpace) 메서드는 XRFrame이 나타내는 시점의 baseSpace 기준으로 space의 pose를 XRPose로 제공합니다.

이 메서드가 호출되면 유저 에이전트는 반드시 다음 단계를 실행해야 합니다:

1. frame을 this로 둡니다.

2. pose를 frame의 관련 realm에서 새 XRPose 객체로 둡니다.

3. frame이 나타내는 시점의 space를 baseSpace 기준으로 pose에 populate합니다.

4. pose를 반환합니다.

프레임 업데이트 적용은 XRFrame frame에 대해 다음 단계를 반드시 실행해야 합니다:

1. frame의 session의 프레임 업데이트 목록의 각 frame update에 대해:

   1. frame update를 frame으로 실행합니다.

포즈를 채우기(populate the pose) 위해, XRSpace인 space와 XRSpace인 baseSpace를, XRFrame frame이 나타내는 시점에서 XRPose pose에 대해, 선택적 force emulation 플래그와 함께, 사용자 에이전트는 반드시 다음 단계를 실행해야 한다:

1. frame의 active 불리언이 false이면 InvalidStateError를 throw 하고 단계를 중단합니다.

2. session을 frame의 session 객체로 둡니다.

3. space의 session이 session과 다르면, InvalidStateError를 throw 하고 단계를 중단합니다.

4. baseSpace의 session이 session과 다르면, InvalidStateError를 throw 하고 단계를 중단합니다.

5. poses may be reported 조건을 확인하고, 만족하지 않으면 SecurityError를 throw 하고 단계를 중단합니다.

6. session의 visibilityState 가 "visible-blurred"이고, space 또는 baseSpace가 XRInputSource에 연관되어 있다면, pose를 null로 하고 단계를 중단합니다.

7. limit을 space와 baseSpace 사이에서 poses must be limited 결과로 둡니다.

8. transform을 pose의 transform으로 둡니다.

9. XR 디바이스의 트래킹 시스템에 frame의 time 시점의 space의 pose를 baseSpace 기준으로 질의한 다음, 다음 단계를 실행합니다:

   limit이 false이고, 트래킹 시스템이 space의 pose에 대해 baseSpace 기준으로 actively tracked 또는 statically known한 6DoF pose를 제공하는 경우:

   transform의 orientation을 view의 유효 원점이 baseSpace의 좌표계에서 갖는 orientation으로 설정합니다.

   transform의 position을 view의 유효 원점이 baseSpace의 좌표계에서 갖는 position으로 설정합니다.

   지원된다면, pose의 linearVelocity를 space의 유효 원점이 baseSpace의 좌표계에서 갖는 선속도로 설정합니다.

   지원된다면, pose의 angularVelocity를 space의 유효 원점이 baseSpace의 좌표계에서 갖는 각속도로 설정합니다.

   pose의 emulatedPosition을 false로 설정합니다.

   그 외 limit이 false이고, 트래킹 시스템이 3DoF pose 또는 위치가 actively tracked/static하지 않은 6DoF pose만 제공하는 경우:

   transform의 orientation을 space의 유효 원점이 baseSpace의 좌표계에서 갖는 orientation으로 설정합니다.

   transform의 position을 트래킹 시스템이 추정한 space의 유효 원점이 baseSpace의 좌표계에서 갖는 위치로 설정합니다. 이 값에는 목/팔 모델 등 계산된 오프셋이 포함될 수 있습니다. 위치 추정이 불가능하면 마지막으로 알려진 위치를 사용해야 합니다.

   pose의 linearVelocity를 null로 설정합니다.

   pose의 angularVelocity를 null로 설정합니다.

   pose의 emulatedPosition을 true로 설정합니다.

   또는, space의 pose가 과거에 baseSpace 기준으로 확인된 적이 있고, force emulation이 true인 경우:

   transform의 position을 space의 유효 원점이 baseSpace의 좌표계에서 마지막으로 알려진 위치로 설정합니다.

   transform의 orientation을 space의 유효 원점이 baseSpace의 좌표계에서 마지막으로 알려진 orientation으로 설정합니다.

   pose의 linearVelocity를 null로 설정합니다.

   pose의 angularVelocity를 null로 설정합니다.

   pose의 emulatedPosition 불리언을 true로 설정합니다.

   그 외의 경우:

   pose를 null로 설정합니다.

참고: XRPose의 emulatedPosition 불리언은 baseSpace의 위치가 에뮬레이션되는지 여부가 아니라, space의 위치를 baseSpace 기준으로 평가할 때 에뮬레이션이 필요한지를 나타냅니다. 예를 들어, 3DoF 트래킹 컨트롤러는 targetRaySpace 또는 gripSpace를 XRReferenceSpace에 대해 쿼리할 때는 emulatedPosition이 true로 보고되지만, targetRaySpace의 pose를 gripSpace 기준으로 쿼리하면 정확하게 관계가 알려져 있으므로 emulatedPosition이 false로 보고됩니다.

XRReferenceSpace 가 XRReferenceSpaceType type 및 XRSession session으로 요청될 때, 유저 에이전트는 반드시 다음 단계를 실행해서 reference space 생성을 해야 합니다:

1. referenceSpace를 다음과 같이 초기화합니다:

   type이 bounded-floor인 경우:

   referenceSpace를 새 XRBoundedReferenceSpace 로 session의 관련 realm에서 생성합니다.

   그 외의 경우:

   referenceSpace를 새 XRReferenceSpace 로 session의 관련 realm에서 생성합니다.

2. referenceSpace의 type을 type으로 초기화합니다.

3. referenceSpace의 session을 session으로 초기화합니다.

4. referenceSpace를 반환합니다.

1. type이 session의 허용된 기능 집합에 포함되어 있지 않으면 false를 반환합니다.

2. type이 viewer이면 true를 반환합니다.

3. type이 local 또는 local-floor이고, session이 몰입형 세션이면 true를 반환합니다.

4. type이 local 또는 local-floor이고, XR 디바이스가 방향 데이터를 지원하면 true를 반환합니다.

5. type이 bounded-floor이고, session이 몰입형 세션이면 bounded reference space 지원 여부를 XR 디바이스에 대해 확인한 결과를 반환합니다.

6. type이 unbounded이고, session이 몰입형 세션이며, XR 디바이스가 사용자 근처에서 무제한 거리까지 안정적인 트래킹을 지원하면 true를 반환합니다.

7. false를 반환합니다.

1. base를 이 메서드를 호출한 XRReferenceSpace로 둡니다.

2. offsetSpace를 다음과 같이 초기화합니다:

   base가 XRBoundedReferenceSpace의 인스턴스인 경우:

   offsetSpace를 새 XRBoundedReferenceSpace 로 base의 관련 realm에서 생성하고, offsetSpace의 boundsGeometry 를 base의 boundsGeometry로 설정하되, 각 점에 originOffset의 inverse를 곱합니다.

   그 외의 경우:

   offsetSpace를 새 XRReferenceSpace 로 base의 관련 realm에서 생성합니다.

3. offsetSpace의 type을 base의 type으로 설정합니다.

4. offsetSpace의 원점 오프셋(origin offset)을 base의 원점 오프셋과 originOffset을 곱한 값으로 base의 관련 realm에서 설정합니다.

5. offsetSpace를 반환합니다.

1. XR 디바이스가 경계를 보고할 수 없다면 false를 반환합니다.

2. XR 디바이스가 사용자의 물리적 바닥 높이를 식별할 수 없다면 false를 반환합니다.

3. true를 반환합니다.

투영 행렬 얻기(obtain the projection matrix)를 XRViewGeometry view geometry 에 대해 실행할 때:

1. view geometry의 내부 투영 행렬이 null이 아니면 다음을 수행합니다:

   1. IsDetachedBuffer 연산을 내부 투영 행렬에 대해 실행한 결과가 false이면, view geometry의 내부 투영 행렬을 반환합니다.

2. view geometry의 내부 투영 행렬을 새 행렬로 관련 realm에서 생성하고, view geometry의 projection matrix와 동일하게 만듭니다.

3. view geometry의 내부 투영 행렬을 반환합니다.

requestViewportScale(scale) 메서드는 이 뷰포트의 requested viewport scale을 지정한 값으로 설정하도록 유저 에이전트에 요청합니다.

이 메서드를 XRView xrview에 대해 호출하면, 유저 에이전트는 반드시 다음 단계를 실행해야 합니다:

1. scale이 null 또는 undefined이면 단계를 중단합니다.

2. scale이 0.0 이하이면 단계를 중단합니다.

3. scale이 1.0보다 크면 scale을 1.0으로 설정합니다.

4. view를 xrview의 underlying view로 둡니다.

5. view의 requested viewport scale 값을 scale로 설정합니다.

참고: 이 메서드는 null 또는 undefined인 scale 값을 무시하므로, 시스템에서 권장값을 제공하지 않더라도 view.requestViewportScale(view.recommendedViewportScale)를 안전하게 사용할 수 있습니다.

active 플래그가 뷰 목록의 어떤 뷰에서든 변경되면, XRSession session에 대해 다음 단계를 실행하여 뷰포트 업데이트를 할 수 있습니다:

1. layer를 renderState의 baseLayer로 둡니다.

2. layer가 null이면 단계를 중단합니다.

3. layer의 viewport 객체 목록을 빈 리스트로 설정합니다.

4. 뷰 목록의 각 active 뷰 view에 대해:

   1. viewport를 XRViewport로 두고, 스케일된 뷰포트 얻기를 view와 session에 연관된 전체 크기 뷰포트 목록에서 수행한 결과로 설정한다.

   2. Append viewport를 layer의 뷰포트 객체 목록에 추가한다.

XRView view와 XRSession session에 대해 스케일링된 뷰포트 획득(obtain a scaled viewport) 알고리즘은 다음과 같습니다:

1. glFullSizedViewport를 전체 크기 뷰포트 목록에서 view에 연관된 WebGL viewport로 둡니다.

2. scale을 view의 current viewport scale로 둡니다.

3. 유저 에이전트는 scale에 대해 최소 viewport scale factor를 적용해 clamp할 수 있습니다.

4. glViewport를 WebGL viewport의 새 인스턴스로 둡니다.

5. glViewport의 width를 glFullSizedViewport의 width에 scale을 곱한 값 이하의 정수로 설정합니다.

6. glViewport의 width가 1보다 작으면 1로 설정합니다.

7. glViewport의 height를 glFullSizedViewport의 height에 scale을 곱한 값 이하의 정수로 설정합니다.

8. glViewport의 height가 1보다 작으면 1로 설정합니다.

9. glViewport의 x를 glFullSizedViewport의 x(포함)~glFullSizedViewport의 x + width - glViewport의 width(포함) 사이의 정수로 설정합니다.

10. glViewport의 y를 glFullSizedViewport의 y(포함)~glFullSizedViewport의 y + height - glViewport의 height(포함) 사이의 정수로 설정합니다.

11. viewport를 새 XRViewport로 session의 관련 realm에서 생성합니다.

12. viewport의 x를 glViewport의 x로 초기화합니다.

13. viewport의 y를 glViewport의 y로 초기화합니다.

14. viewport의 width를 glViewport의 width로 초기화합니다.

15. viewport의 height를 glViewport의 height로 초기화합니다.

16. viewport를 반환합니다.

참고: 구체적인 정수 계산은 UA(유저 에이전트)에 위임됩니다. 단순히 width/height를 내림하고 x/y 오프셋을 그대로 적용하는 것도 유효하지만, 효율을 위해 2의 거듭제곱 픽셀 그리드에 맞추는 등 약간 조정할 수 있습니다. 스케일링된 뷰포트는 반드시 전체 크기 뷰포트 내에 완전히 포함되어야 하며, 위치·크기 계산은 세션 내에서 입력값이 동일하면 항상 동일한 결과를 반환해야 합니다.

정규화(normalize)를 컴포넌트 리스트에 적용할 때 UA는 다음 단계를 실행해야 합니다:

1. length를 각 컴포넌트 제곱의 합의 제곱근으로 둡니다.

2. length가 0이면 InvalidStateError 를 throw하고 단계를 중단합니다.

3. 각 컴포넌트를 length로 나눈 값으로 설정합니다.

XRRigidTransform(position, orientation) 생성자가 호출될 때 반드시 다음 단계를 실행해야 합니다:

1. transform을 새 XRRigidTransform 객체로 현재 realm에서 생성합니다.

2. transform의 position 을 새 DOMPointReadOnly 객체로 현재 realm에서 생성합니다.

3. position의 w 값이 1.0이 아니면 TypeError를 throw하고 단계를 중단합니다.

4. position 또는 orientation의 값 중 하나라도 NaN 또는 infinity 등 비유한수이면 TypeError를 throw하고 단계를 중단합니다.

5. transform의 position의 x 값에 position의 x dictionary 값, y 값에 y dictionary 값, z 값에 z dictionary 값, w 값에 w dictionary 값을 설정합니다.

6. transform의 orientation 을 새 DOMPointReadOnly 객체로 현재 realm에서 생성합니다.

7. transform의 orientation의 x 값에 orientation의 x dictionary 값, y 값에 y dictionary 값, z 값에 z dictionary 값, w 값에 w dictionary 값을 설정합니다.

8. transform의 내부 행렬을 null로 둡니다.

9. transform의 orientation의 x, y, z, w 컴포넌트를 정규화합니다.

10. transform을 반환합니다.

XRRigidTransform transform에 대해 행렬 얻기(obtain the matrix) 알고리즘은 다음과 같습니다:

1. transform의 내부 행렬이 null이 아니면 다음을 수행합니다:

   1. IsDetachedBuffer 연산을 내부 행렬에 대해 실행한 결과가 false이면 transform의 내부 행렬을 반환합니다.

2. translation을 행렬로, position에 해당하는 컬럼 벡터 평행이동 행렬로 둡니다. 수학적으로 position이 (x, y, z)이면 이 행렬은 다음과 같습니다:

   

3. rotation을 행렬로, orientation에 해당하는 컬럼 벡터 회전 행렬로 둡니다. 수학적으로 orientation 이 단위 쿼터니언 (qx, qy, qz, qw)일 때 이 행렬은 다음과 같습니다:

   

4. transform의 내부 행렬을 새 Float32Array 로 transform의 관련 realm에서, translation과 rotation을 translation이 왼쪽(translation * rotation)이 되도록 곱한 결과로 설정합니다. 수학적으로 이 행렬은 다음과 같습니다:

   

5. transform의 내부 행렬을 반환합니다.

XRRigidTransform B와 A를 Realm realm에서 곱하기 알고리즘은 다음과 같습니다:

1. result를 새 XRRigidTransform 객체로 realm에서 생성합니다.

2. result의 matrix 에 새 Float32Array 를 realm에서 생성, B의 matrix 를 왼쪽에서 A의 matrix에 곱한 결과로 설정합니다.

3. result의 orientation 에 새 DOMPointReadOnly 를 realm에서 생성, result의 matrix의 좌상단 3x3 부분행렬이 나타내는 쿼터니언으로 설정합니다.

4. result의 position 에 새 DOMPointReadOnly 를 realm에서 생성, result의 matrix의 4번째 컬럼에 해당하는 벡터로 설정합니다.

5. result를 반환합니다.

result는 A의 소스 공간에서 B의 목적지 공간으로의 변환입니다.

참고: 이것은 XRRigidTransform 을 구성하는 것과 같으며, orientation 은 A와 B의 orientation 합성, position 은 A의 position을 B의 orientation으로 회전시킨 뒤 B의 position을 더한 값과 같습니다.

XR 입력 소스 source가 XRSession session에서 기본 동작을 시작할 때, UA는 반드시 다음 단계를 실행해야 합니다:

1. frame을 새 XRFrame 으로 session의 관련 realm에서 생성, session session, time을 동작 발생 시간으로 설정합니다.

2. 태스크 큐에 입력 소스 이벤트 발생 (이름: selectstart, frame frame, source source)를 추가합니다.

XR 입력 소스 source가 XRSession session에서 기본 동작을 끝낼 때 UA는 반드시 다음 단계를 실행해야 합니다:

1. frame을 새 XRFrame 으로 session의 관련 realm에서 생성, session session, time을 동작 발생 시간으로 설정합니다.

2. 태스크 큐에 다음 단계를 추가합니다:

   1. 입력 소스 이벤트 발생 (이름: select, frame frame, source source)

   2. 입력 소스 이벤트 발생 (이름: selectend, frame frame, source source)

XR 입력 소스 source가 XRSession session에서 기본 스퀴즈 동작을 시작할 때 UA는 반드시 다음 단계를 실행해야 합니다:

1. frame을 새 XRFrame 으로 session의 관련 realm에서 생성, session session, time을 동작 발생 시간으로 설정합니다.

2. 태스크 큐에 입력 소스 이벤트 발생 (이름: squeezestart, frame frame, source source)를 추가합니다.

XR 입력 소스 source가 XRSession session에서 기본 스퀴즈 동작을 끝낼 때 UA는 반드시 다음 단계를 실행해야 합니다:

1. frame을 새 XRFrame 으로 session의 관련 realm에서 생성, session session, time을 동작 발생 시간으로 설정합니다.

2. 태스크 큐에 다음 단계를 추가합니다:

   1. 입력 소스 이벤트 발생 (이름: squeeze, frame frame, source source)

   2. 입력 소스 이벤트 발생 (이름: squeezeend, frame frame, source source)

XR 입력 소스 source가 XRSession session에서 기본 동작이 취소된 경우 UA는 반드시 다음 단계를 실행해야 합니다:

1. frame을 새 XRFrame 으로 session의 관련 realm에서 생성, session session, time을 동작 발생 시간으로 설정합니다.

2. 태스크 큐에 입력 소스 이벤트 발생 (XRInputSourceEvent, 이름: selectend, frame frame, source source)을 추가합니다.

XR 입력 소스 source가 XRSession session에서 기본 스퀴즈 동작이 취소된 경우 UA는 반드시 다음 단계를 실행해야 합니다:

1. frame을 새 XRFrame 으로 session의 관련 realm에서 생성, session session, time을 동작 발생 시간으로 설정합니다.

2. 태스크 큐에 입력 소스 이벤트 발생 (XRInputSourceEvent, 이름: squeezeend, frame frame, source source)을 추가합니다.

일시적 입력 소스 source가 XRSession session에서 일시적 동작을 시작할 때 UA는 반드시 다음 단계를 실행해야 합니다:

1. frame을 새 XRFrame 으로 session의 관련 realm에서 생성, session session, 동작 발생 시간을 기준으로 합니다.

2. 태스크 큐에 다음 단계를 추가합니다:

   1. 필요한 경우, XR 입력 소스 동작에 의해 생성된 "pointerdown" 이벤트를 발생시킵니다.

   2. XR 입력 소스 추가를 활성 XR 입력 소스 목록에 수행합니다.

   3. 일시적 동작이 기본 동작이라면, 입력 소스 이벤트 발생 (이름: selectstart, frame frame, source source)을 실행합니다.

일시적 입력 소스 source가 XRSession session에서 일시적 동작을 끝낼 때 UA는 반드시 다음 단계를 실행해야 합니다:

1. frame을 새 XRFrame 으로 session의 관련 realm에서 생성, session session, 동작 발생 시간을 기준으로 합니다.

2. 태스크 큐에 다음 단계를 추가합니다:

   1. 일시적 동작이 기본 동작이라면, 입력 소스 이벤트 발생 (이름: select, frame frame, source source)을 실행합니다.

   2. 필요한 경우, XR 입력 소스 동작에 의해 생성된 "click" 이벤트를 발생시킵니다.

   3. 일시적 동작이 기본 동작이라면, 입력 소스 이벤트 발생 (이름: selectend, frame frame, source source)을 실행합니다.

   4. XR 입력 소스 제거를 활성 XR 입력 소스 목록에서 수행합니다.

   5. 필요한 경우, XR 입력 소스 동작에 의해 생성된 "pointerup" 이벤트를 발생시킵니다.

일시적 입력 소스 source가 XRSession session에서 일시적 동작이 취소된 경우 UA는 반드시 다음 단계를 실행해야 합니다:

1. frame을 새 XRFrame 으로 session의 관련 realm에서 생성, session session, 동작 발생 시간을 기준으로 합니다.

2. 태스크 큐에 다음 단계를 추가합니다:

   1. 일시적 동작이 기본 동작이라면, 입력 소스 이벤트 발생 (이름: selectend, frame frame, source source)을 실행합니다.

   2. XR 입력 소스 제거를 활성 XR 입력 소스 목록에서 수행합니다.

   3. 필요한 경우, XR 입력 소스 동작에 의해 생성된 "pointerup" 이벤트를 발생시킵니다.

XRWebGLLayer(session, context, layerInit) 생성자가 호출될 때 반드시 다음 단계를 실행해야 합니다:

1. layer를 새 XRWebGLLayer 객체로 session의 관련 realm에서 생성합니다.

2. session의 ended 값이 true라면 InvalidStateError 를 throw하고 단계를 중단합니다.

3. context가 손실(lost)된 경우 InvalidStateError 를 throw하고 단계를 중단합니다.

4. session이 immersive session이고 context의 XR compatible 불리언이 false라면, InvalidStateError 를 throw하고 단계를 중단합니다.

5. layer의 context를 context로 초기화합니다.

6. layer의 session을 session으로 초기화합니다.

7. layer의 ignoreDepthValues 를 다음과 같이 초기화합니다:

   layerInit의 ignoreDepthValues 값이 false이고 XR Compositor가 depth 값을 사용할 경우:

   layer의 ignoreDepthValues 를 false로 초기화합니다.

   그 외의 경우:

   layer의 ignoreDepthValues 를 true로 초기화합니다.

8. layer의 composition enabled 불리언을 다음과 같이 초기화합니다:

   session이 inline session인 경우:

   layer의 composition enabled를 false로 초기화합니다.

   그 외의 경우:

   layer의 composition enabled 불리언을 true로 초기화합니다.

9. layer의 composition enabled 불리언이 true일 때:

   1. layer의 antialias 를 layerInit의 antialias 값으로 초기화합니다.

   2. scaleFactor를 layerInit의 framebufferScaleFactor로 둡니다.

   3. 여기서 user agent는 필요에 따라 scaleFactor를 조정(예: 2의 제곱수로 맞추기 등)할 수 있습니다.

   4. framebufferSize를 권장 WebGL 프레임버퍼 해상도에 각 width/height를 scaleFactor로 곱한 값으로 둡니다.

   5. layer의 framebuffer 를 새 WebGLFramebuffer 로 context의 관련 realm에서, opaque framebuffer로 framebufferSize 크기와 context, session을 session으로, layerInit의 depth, stencil, alpha 값을 사용해 생성합니다.

   6. session의 XR 디바이스에 맞는 자원(예: GPU 메모리 버퍼 등)을 할당·초기화합니다.

   7. 자원 생성에 실패하면 OperationError 를 throw하고 단계를 중단합니다.

   그 외의 경우:

   1. layer의 antialias 를 layer의 context의 실제 context 파라미터 antialias 값으로 초기화합니다.

   2. layer의 framebuffer 를 null로 초기화합니다.

10. layer를 반환합니다.

getViewport(view) 메서드가 XRWebGLLayer layer에서 호출되면, 아래 단계를 반드시 실행해야 합니다:

1. session을 view의 session으로 둡니다.

2. frame을 session의 animation frame으로 둡니다.

3. session이 layer의 session과 다르면 InvalidStateError 를 throw하고 중단합니다.

4. frame의 active 불리언이 false면 InvalidStateError 를 throw하고 중단합니다.

5. view의 frame이 frame과 다르면 InvalidStateError 를 throw하고 중단합니다.

6. viewport modifiable 플래그가 true이고, view의 requested viewport scale이 current viewport scale과 다르면:

   1. current viewport scale을 requested viewport scale로 설정합니다.

   2. 뷰포트 객체 목록에서 view와 연관된 XRViewport 를 스케일된 뷰포트 얻기 결과로 설정합니다.

7. view의 viewport modifiable 플래그를 false로 설정합니다.

8. viewport를 뷰포트 객체 목록에서 view에 해당하는 XRViewport로 둡니다.

9. viewport를 반환합니다.

참고: viewport modifiable 플래그는 current viewport scale이 변경되지 않아도 false로 설정됩니다. 이렇게 하면 getViewport(view) 호출은 해당 애니메이션 프레임 내에서 항상 일관된 값을 반환하여, 최초 조회된 값이 해당 프레임 동안 고정됩니다. requestViewportScale()을 getViewport() 이후 호출하면, 요청값은 다음 프레임에서 getViewport()가 다시 호출될 때만 적용됩니다.

XRSession session의 네이티브 WebGL 프레임버퍼 해상도는 다음 단계로 결정됩니다:

1. session의 mode가 "inline"이 아니면, 네이티브 WebGL 프레임버퍼 해상도를 세션의 모든 XRView를 담을 수 있는 프레임버퍼 픽셀과, 물리적 디스플레이 픽셀(최대 배율 영역) 간 1:1 비율로 설정하고 종료합니다. 위와 같이 네이티브 해상도를 구할 방법이 없다면, 권장 WebGL 프레임버퍼 해상도를 사용할 수 있습니다.

2. session의 mode가 "inline"이면, 네이티브 WebGL 프레임버퍼 해상도를 session의 renderState의 output canvas의 물리적 디스플레이 픽셀 크기로 설정하고, 캔버스 크기 또는 output canvas가 변경될 때마다 재평가합니다.

getNativeFramebufferScaleFactor(session) 메서드가 호출될 때 반드시 다음 단계를 실행해야 합니다:

1. session을 this로 둡니다.

2. session의 ended 값이 true이면, 0.0을 반환하고 단계를 중단합니다.

3. session의 권장 WebGL 프레임버퍼 해상도의 가로, 세로를 각각 곱하면 session의 네이티브 WebGL 프레임버퍼 해상도가 되는 값을 반환합니다.

이 메서드가 호출되면, 사용자 에이전트는 반드시 다음 단계를 실행해야 합니다:

1. 요청 문서의 origin이 "xr-spatial-tracking" permissions policy를 사용할 수 없다면, resolve promise를 반환하고 중단한다. XR 권한 정책이 비활성화된 경우, XR 디바이스가 없는 것처럼 동작해야 하며, makeXRCompatible() 은 set-and-forget 방식이어야 하기 때문이다.

2. promise를 이 WebGLRenderingContextBase의 Realm에서 생성된 새 Promise로 둔다.

3. context를 this로 둔다.

4. 아래 단계를 병렬로 실행한다:

   1. device를 ensure an immersive XR device is selected 결과로 둔다.

   2. context의 XR 호환 불리언을 아래와 같이 설정한다:

      만약 context의 WebGL 컨텍스트 손실 플래그가 설정되어 있으면:

      작업 큐에 추가하여 context의 XR 호환 불리언을 false로 설정하고, promise를 reject하며 InvalidStateError로 반환한다.

      device가 null인 경우:

      작업 큐에 추가하여 context의 XR 호환 불리언을 false로 설정하고, promise를 reject하며 InvalidStateError로 반환한다.

      context의 XR 호환 불리언이 true인 경우:

      작업 큐에 추가하여 promise를 resolve한다.

      context가 device에 대해 호환되는 그래픽 어댑터에서 생성된 경우:

      작업 큐에 추가하여 context의 XR 호환 불리언을 true로 설정하고 promise를 resolve한다.

      그 외의 경우:

      WebGL 작업 소스에 작업 큐 추가하여 아래 단계 실행:

      1. context를 강제로 손실시킨다.

      2. WebGL 명세에 따라 컨텍스트 손실 처리:

         1. canvas를 context의 canvas로 둔다.

         2. context의 WebGL 컨텍스트 손실 플래그가 설정되어 있으면, 중단한다.

         3. context의 WebGL 컨텍스트 손실 플래그를 설정한다.

         4. context에서 생성된 각 WebGLObject 인스턴스의 invalidated 플래그를 설정한다.

         5. "WEBGL_lose_context"를 제외한 모든 확장 기능을 비활성화한다.

         6. WebGL 작업 소스에 작업 큐 추가하여 아래 단계 실행:

            1. WebGL 컨텍스트 이벤트 e를 이름 "webglcontextlost"로 canvas에 발생시키고, statusMessage 는 ""로 설정한다.

            2. e의 canceled flag가 설정되지 않았다면, promise를 reject하고 AbortError로 반환하며, 중단한다.

            3. 아래 단계를 병렬로 실행한다.

               1. device에 대해 호환되는 그래픽 어댑터에서 복원 가능한 드로잉 버퍼를 대기한다.

               2. WebGL 작업 소스에 작업 큐 추가하여 아래 단계 실행:

                  1. device에 대해 호환되는 그래픽 어댑터에서 컨텍스트를 복원한다.

                  2. context의 XR 호환 불리언을 true로 설정한다.

                  3. promise를 resolve한다.

5. promise를 반환한다.

또한, WebGL 컨텍스트가 손실될 때는 "webglcontextlost" 이벤트가 발생하기 전에 아래 단계를 실행합니다:

1. 컨텍스트의 XR 호환 불리언을 false로 설정합니다.

사용자 에이전트가 name, XRFrame frame, XRInputSource source로 입력 소스 이벤트를 발생시켜야 할 때 다음 단계를 수행해야 합니다:

1. XRInputSourceEvent event를 type name, frame frame, inputSource source로 생성한다.

2. frame의 active 불리언을 true로 설정한다.

3. 프레임 업데이트를 적용한다(frame).

4. event를 frame의 session에 디스패치한다.

5. frame의 active 불리언을 false로 설정한다.