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. 排队一个任务，将所有WebGLRenderingContextBase实例的XR compatible布尔值设为false。

9. 排队一个任务，在相关全局对象的navigator的xr上，派发一个名为devicechange的事件。

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" 权限策略，reject promise，异常为 "SecurityError" DOMException ，并返回。

4. 按如下方式检查会话 mode 是否受支持：

   如果用户代理和系统已知永不支持 mode 会话

   resolve promise 为 false。

   如果用户代理和系统已知通常支持 mode 会话

   只要所有 UA 字符串不可区分的实例都产生相同结果，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，并返回 promise。

   2. 若待处理沉浸式会话为 true 或活动沉浸式会话不为 null，则reject promise，异常为 "InvalidStateError" DOMException，并返回 promise。

   3. 将待处理沉浸式会话设为 true。

   否则：

   检查 global object 是否被允许请求内嵌会话，如不允许则reject promise，异常为 "SecurityError" DOMException，并返回 promise。

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 为用 mode、requiredFeatures 和 optionalFeatures 初始化的 XRPermissionDescriptor。

      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 已 resolve 标志为 true。

          2. 令 sources 为 session 已附加的所有输入源。

          3. 若 sources 非空，执行如下步骤：

             1. 设置 session 的活动 XR 输入源列表为 sources。

             2. 在 session 上派发名为 inputsourceschange 的 XRInputSourcesChangeEvent，其 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 ，但 end() 返回的 promise 除外。

5. 如用户代理没有其他功能仍在用，按平台相关步骤关闭设备的跟踪和渲染能力，必须包括：

   • 若 session 是 沉浸式会话，则释放独占访问 XR 设备。

   • 释放 session 为 XR 设备 展示所分配的所有图形资源。

   • 如果 session 是 沉浸式会话，则将 XR 设备 置于可被其他来源重新发起会话的状态。

6. 排队一个任务，在 session 上派发名为 XRSessionEvent 的 end 事件。

end() 方法用于手动关闭会话。调用时，必须执行以下步骤：

1. 令 promise 为该 XRSession 的 相关 realm 中的 新 Promise。

2. 如果 ended 为 true，reject promise，抛出 "InvalidStateError" DOMException 并返回 promise。

3. 关闭 this。

4. 排队一个任务，执行下列步骤：

   1. 等待所有与关闭会话相关的平台特定步骤完成。

   2. resolve promise。

5. 返回 promise。

当用户代理要用 XRSession session 和 XRRenderStateInit newState 更新待处理图层状态时，必须执行以下步骤：

1. 若 newState 的 layers 不为 null，则抛出 NotSupportedError。

注： WebXR 图层模块将为该算法引入新语义。

当用户代理要在 XRSession session 上 应用名义帧率 rate 时，必须执行以下步骤：

1. 如果 rate 与 session 的 内部名义帧率相同，则中止这些步骤。

2. 如果 session 的 ended 为 true，中止这些步骤。

3. 将 session 的 内部名义帧率设为 rate。

4. 在 session 上派发名为 XRSessionEvent 的 frameratechange 事件。

updateTargetFrameRate(rate) 方法将 目标帧率 rate 传递给 XRSession。

调用该方法时，用户代理必须执行以下步骤：

1. 令 session 为 this。

2. 令 promise 为 session 的 相关 realm 中的 新 Promise。

3. 如果 session 没有 内部名义帧率，则 reject promise，抛出 "InvalidStateError" DOMException 并返回 promise。

4. 如果 session 的 ended 为 true，则 reject promise，抛出 "InvalidStateError" DOMException 并返回 promise。

5. 如果 rate 不在 supportedFrameRates 中，reject promise，抛出 "TypeError" DOMException 并返回 promise。

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，中止这些步骤。

3. 如果 newState 的 baseLayer 是用非 session 创建的 XRSession，抛出 InvalidStateError，中止这些步骤。

4. 如果 newState 的 inlineVerticalFieldOfView 已设置，且 session 是 沉浸式会话，抛出 InvalidStateError，中止这些步骤。

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. 如果对 type 和 session 执行 reference space is supported 结果为 false，排队一个任务，reject promise，异常为 NotSupportedError，并中止这些步骤。

   2. 设置跟踪 type 类型参考空间所需的任何平台资源。

      用户代理不需要等待此类参考空间的跟踪建立后再 resolve requestReferenceSpace()。在会话最初尝试建立跟踪时，getViewerPose() 返回 null 是可以的，内容可在此期间显示启动画面等。注意若 type 为 "bounded-floor" 且边界尚未建立，用户代理可以将边界设为一个较小的初始区域，并在边界建立时通过 reset 事件通知。

   3. 排队一个任务，执行以下步骤：

   4. 创建参考空间 referenceSpace，参数为 type 和 session。

   5. resolve promise，值为 referenceSpace。

3. 返回 promise。

当 有新的 XR 输入源 可用 于 XRSession session 时，用户代理必须执行以下步骤：

1. 如果 session 的 promise 已 resolve 标志 未设置，则中止这些步骤。

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 非空，在 session 上派发名为 XRInputSourcesChangeEvent 的 inputsourceschange 事件，added 设为 added primary sources。

   3. 扩展session 的 活动 XR 跟踪源列表，将 added tracked sources 添加进去。

   4. 如果 added tracked sources 非空，在 session 上派发名为 XRInputSourcesChangeEvent 的 trackedsourceschange 事件，added 设为 added tracked sources。

当之前添加的XR 输入源不再可用于 XRSession session 时，用户代理必须执行以下步骤：

1. 如果 session 的 promise 已 resolve 标志 未设置，则中止这些步骤。

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 非空，在 session 上派发名为 XRInputSourcesChangeEvent 的 inputsourceschange 事件，removed 设为 removed primary sources。

   3. 移除 removed tracked sources 中的每个 XRInputSource，从 session 的 活动 XR 跟踪源列表中。

   4. 如果 removed tracked sources 非空，在 session 上派发名为 XRInputSourcesChangeEvent 的 trackedsourceschange 事件，removed 设为 removed tracked sources。

注意：当输入源暂时失去位置和朝向跟踪时，用户代理可以触发此事件。建议仅对物理手持控制器输入源这样做。对于手部跟踪输入源，由于这种情况频繁发生，不建议这样做；对于跟踪器对象输入源也不推荐这样做，因为这会让应用难以维护身份概念。

当 handedness、 targetRayMode、 profiles、 是否存在 gripSpace， 或作为主输入源或 跟踪输入源的状态 发生变化时，对于 XRSession session，用户代理必须执行以下步骤：

1. 如果 session 的 promise 已 resolve 标志 未设置，则中止这些步骤。

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 非空，在 session 上派发名为 XRInputSourcesChangeEvent 的 inputsourceschange 事件，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 非空，在 session 上派发名为 XRInputSourcesChangeEvent 的 trackedsourceschange 事件，added 设为 added tracked sources，removed 设为 removed tracked sources。

当为 XRRenderState 创建 XRSession session 时，用户代理必须 初始化渲染状态，执行以下步骤：

1. 令 state 为 session 的 新 XRRenderState 对象。

2. 将 state 的 depthNear 初始化为 0.1。

3. 将 state 的 depthFar 初始化为 1000.0。

4. 将 state 的 passthroughFullyObscured 初始化为 false。

5. 按如下方式初始化 state 的 inlineVerticalFieldOfView：

   如果 session 是 内嵌会话：

   初始化为 PI * 0.5。

   否则：

   初始化为 null。

6. 将 state 的 baseLayer 初始化为 null。

requestAnimationFrame(callback) 方法会将 callback 加入队列，以便下次用户代理要为设备运行动画帧时调用。

调用此方法时，用户代理必须执行以下步骤：

1. 令 session 为 this。

2. 如果 session 的 ended 值为 true，则返回 0，并中止这些步骤。

3. 将 session 的 动画帧回调标识符加一。

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 图层模块将为该算法引入新语义。

1. 如果用 session 的 renderState 检查图层状态 返回 false，则返回 false。

2. 如果 session 的 mode 是 "inline" 且 session 的 renderState 的 output canvas 为 null，则返回 false。

3. 返回 true。

当 XRSession session 从 XR 设备 接收到时间戳 frameTime 的 观察者状态更新时，会运行一次 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，将其 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 的 pending render state 不为 null，则应用待处理渲染状态。

getViewerPose(referenceSpace) 方法返回 观察者 相对于 referenceSpace 的姿态（XRViewerPose），其状态为 XRFrame 的 time。

调用该方法时，用户代理必须执行以下步骤：

1. 令 frame 为 this。

2. 令 session 为 frame 的 session 对象。

3. 如果 frame 的 animationFrame 为 false，抛出 InvalidStateError 并中止这些步骤。

4. 令 pose 为 session 的 新 XRViewerPose 对象。

5. 填充 session 的 观察者参考空间 在 referenceSpace 下于 frame 表示的时间的姿态到 pose，force emulation 设为 true。

6. 如果 pose 为 null，返回 null。

7. 令 xrviews 为一个空的 列表。

8. 令 offset 为 0。

9. 对于 session 上 视图列表中的每个激活的视图 view，执行以下步骤：

   1. 令 xrview 为 session 的相关领域中新建的 XRView 对象。

   2. 初始化 xrview 的底层视图为 view。

   3. 初始化 xrview 的 eye 为 view 的 眼睛。

   4. 初始化 xrview 的 index 为 offset。

   5. 初始化 xrview 的帧为 frame。

   6. 初始化 xrview 的会话为 session。

   7. 初始化 xrview 的参考空间为 referenceSpace。

   8. 令 viewtransform 为 session 的相关领域中新建、等于 view 的视图偏移的 XRRigidTransform 对象。

   9. 将 xrview 的 transform 属性设置为 将XRViewerPose 的 transform 与 viewtransform 变换在 session 的相关领域中相乘的结果。

   10. 将 xrview 添加到 xrviews。

   11. 令 offset 增加 1。

10. 将 pose 的 views 设为 xrviews

11. 返回 pose。

getPose(space, baseSpace) 方法返回 space 相对于 baseSpace 的姿态（XRPose），其状态为 XRFrame 表示的时间。

调用该方法时，用户代理必须执行以下步骤：

1. 令 frame 为 this。

2. 令 pose 为 frame 的 新 XRPose 对象。

3. 填充 space 在 baseSpace 下于 frame 表示的时间的姿态到 pose。

4. 返回 pose。

要为 XRFrame frame 应用帧更新，用户代理必须执行以下步骤：

1. 对 frame 的 session 的 帧更新列表 中每个 frame update，执行：

   1. 用 frame 运行 frame update。

要填充 姿态（pose），即在 XRSpace space 相对于 XRSpace baseSpace，在由 XRFrame frame 表示的时刻，将结果填入 XRPose pose，可选地带 force emulation 标志，用户代理必须执行以下步骤：

1. 如果 frame 的 active 为 false，抛出 InvalidStateError 并中止这些步骤。

2. 令 session 为 frame 的 session 对象。

3. 如果 space 的 session 不等于 session，抛出 InvalidStateError 并中止这些步骤。

4. 如果 baseSpace 的 session 不等于 session，抛出 InvalidStateError 并中止这些步骤。

5. 检查能否报告姿态，如不行则抛出 SecurityError 并中止这些步骤。

6. 如果 session 的 visibilityState 是 "visible-blurred" 且 space 或 baseSpace 与 XRInputSource 关联，则将 pose 设为 null 并中止这些步骤。

7. 令 limit 为 姿态是否需限制（space 与 baseSpace 之间）。

8. 令 transform 为 pose 的 transform。

9. 向 XR 设备 跟踪系统查询 space 相对于 baseSpace 在 frame 的 time 的姿态，然后按如下分支：

   如果 limit 为 false 且跟踪系统为 space 相对于 baseSpace 提供了正在主动跟踪或静态已知的 6DoF 姿态：

   将 transform 的 orientation 设为 space 的 有效原点 在 baseSpace 的 坐标系 中的朝向。

   将 transform 的 position 设为 space 的 有效原点 在 baseSpace 的 坐标系 中的位置。

   如果支持，将 pose 的 linearVelocity 设为 space 的 有效原点 相对 baseSpace 坐标系 的线速度。

   如果支持，将 pose 的 angularVelocity 设为 space 的 有效原点 相对 baseSpace 坐标系 的角速度。

   将 pose 的 emulatedPosition 设为 false。

   否则如果 limit 为 false 且跟踪系统为 space 相对于 baseSpace 提供了 3DoF 姿态或者 6DoF 但位置既未主动跟踪也非静态已知：

   将 transform 的 orientation 设为 space 的 有效原点 在 baseSpace 的 坐标系 中的朝向。

   将 transform 的 position 设为跟踪系统对 space 的 有效原点 在 baseSpace 坐标系 中位置的最佳估计。该估计可以包含如脖子或手臂模型等计算偏移。如无可用位置估计，必须使用上一个已知位置。

   将 pose 的 linearVelocity 设为 null。

   将 pose 的 angularVelocity 设为 null。

   将 pose 的 emulatedPosition 设为 true。

   否则如果 space 相对于 baseSpace 的姿态曾被确定且 force emulation 为 true：

   将 transform 的 position 设为 space 的 有效原点 在 baseSpace 坐标系 中的上一次已知位置。

   将 transform 的 orientation 设为 space 的 有效原点 在 baseSpace 坐标系 中的上一次已知朝向。

   将 pose 的 linearVelocity 设为 null。

   将 pose 的 angularVelocity 设为 null。

   将 pose 的 emulatedPosition 设为 true。

   否则：

   将 pose 设为 null。

注意：XRPose 的 emulatedPosition 布尔值并不表示 baseSpace 的位置是否为模拟，只表示在计算 space 相对于 baseSpace 的位置时是否依赖于模拟。例如，具有 3DoF 跟踪的控制器，当其 targetRaySpace 或 gripSpace 相对于 XRReferenceSpace 查询时，会报告 emulatedPosition 为 true；但如果 targetRaySpace 的姿态在 gripSpace 下查询，则会报告 emulatedPosition 为 false，因为这两个空间之间的关系应当是精确已知的。

当为 XRSession session 按 XRReferenceSpaceType type 请求 XRReferenceSpace 时，用户代理必须 创建参考空间，步骤如下：

1. 初始化 referenceSpace：

   如 type 为 bounded-floor：

   令 referenceSpace 为 session 相关 realm 中的新 XRBoundedReferenceSpace。

   否则：

   令 referenceSpace 为 session 相关 realm 中的新 XRReferenceSpace。

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 为 沉浸式会话，返回 XR 设备是否支持有界参考空间。

6. 如 type 为 unbounded，session 为 沉浸式会话，且 XR 设备 支持用户周围无限距离的稳定跟踪，则返回 true。

7. 返回 false。

1. 令 base 为该方法被调用的 XRReferenceSpace。

2. 初始化 offsetSpace：

   如 base 是 XRBoundedReferenceSpace 的实例：

   令 offsetSpace 为 base 相关 realm 中的新 XRBoundedReferenceSpace，并将 offsetSpace 的 boundsGeometry 设为 base 的 boundsGeometry，每个点都乘以 originOffset 的 inverse。

   否则：

   令 offsetSpace 为 base 相关 realm 中的新 XRReferenceSpace。

3. 将 offsetSpace 的 type 设为 base 的 type。

4. 将 offsetSpace 的 origin offset 设为 base 的 origin offset 与 originOffset 在 base 相关 realm 下 相乘的结果。

5. 返回 offsetSpace。

1. 如果 XR 设备无法报告边界，返回 false。

2. 如果 XR 设备无法识别用户物理地面的高度，返回 false。

3. 返回 true。

要为给定 XRViewGeometry view geometry 获取投影矩阵：

1. 如果 view geometry 的 内部投影矩阵 不为 null，执行：

   1. 如对 内部投影矩阵 执行 IsDetachedBuffer 操作结果为 false，则返回 view geometry 的 内部投影矩阵。

2. 将 view geometry 的 内部投影矩阵 设为 view geometry 的 投影矩阵，在其相关 realm中新建 矩阵。

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 缩放值，以便应用可安全地写 view.requestViewportScale(view.recommendedViewportScale)，即使系统未提供推荐值。

当 视图列表中任一视图的active标志发生变化时，可以为 XRSession session 更新视口，步骤如下：

1. 令 layer 为 renderState 的 baseLayer。

2. 如果 layer 为 null，中止这些步骤。

3. 将 layer 的 视口对象列表 设为空列表。

4. 对 视图列表中每个active的视图 view：

   1. 令 viewport 为 获取缩放视口的结果，使用与 view 相关的 全尺寸视口列表和 session。

   2. 追加 viewport 到 layer 的 视口对象列表。

要为指定的 XRView view 和 XRSession session 获取缩放视口，请执行以下步骤：

1. 令 glFullSizedViewport 为与 view 关联的 WebGL 视口，取自 全尺寸视口列表。

2. 令 scale 为 view 的 当前视口缩放。

3. 用户代理可以选择对 scale 进行限制，以施加最小视口缩放因子。

4. 令 glViewport 为新的 WebGL 视口。

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 分量加 glFullSizedViewport 的 width 减 glViewport 的 width（含）之间的整数值。

10. 将 glViewport 的 y 分量设为 glFullSizedViewport 的 y 分量（含）到 glFullSizedViewport 的 y 分量加 glFullSizedViewport 的 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 偏移的方法是有效的，但 UA 也可以在约束范围内选取稍作调整的值，例如为了效率将视口对齐到 2 的幂像素网格。缩放视口必须完全包含在全尺寸视口内，但可由 UA 自行决定放置在全尺寸视口内的任何位置。大小和位置计算必须具确定性，并在同一会话内对于相同输入返回一致结果。

要归一化一组分量，UA 必须执行：

1. 令 length 为各分量平方和的平方根。

2. 如 length 为 0，抛出 InvalidStateError 并中止。

3. 每个分量除以 length 并设置该分量。

XRRigidTransform(position, orientation) 构造函数调用时必须执行以下步骤：

1. 令 transform 为 新 XRRigidTransform，位于当前 realm。

2. 令 transform 的 position 为新 DOMPointReadOnly，位于当前 realm。

3. 如 position 的 w 不等于 1.0，抛出 TypeError 并中止。

4. 如 position 或 orientation 中任一值为 NaN 或其他非有限数（如 infinity），抛出 TypeError 并中止。

5. 设置 transform 的 position 的 x、y、z、w 分别为 position 对应的字典成员。

6. 令 transform 的 orientation 为新 DOMPointReadOnly，位于当前 realm。

7. 设置 transform 的 orientation 的 x、y、z、w 分别为 orientation 对应的字典成员。

8. 令 transform 的 内部矩阵为 null。

9. 归一化 x、 y、 z、 w 这4个分量（属于 transform 的 orientation）。

10. 返回 transform。

要为 XRRigidTransform transform 获取矩阵：

1. 如果 transform 的 内部矩阵 不为 null，则执行：

   1. 如 IsDetachedBuffer 操作对 内部矩阵 结果为 false，则返回 transform 的 内部矩阵。

2. 令 translation 为新的矩阵，为列向量平移矩阵，对应 position。若 position 为 (x, y, z)，该矩阵为：

   

3. 令 rotation 为新的矩阵，为列向量旋转矩阵，对应 orientation。若 orientation 为单位四元数 (qx, qy, qz, qw)，矩阵为：

   

4. 将 transform 的 内部矩阵 设为在 transform 的 相关 realm中新建的 Float32Array，其值为 translation * rotation 的结果（左乘），即 translation * rotation。数学上，矩阵为：

   

5. 返回 transform 的 内部矩阵。

要相乘两个 XRRigidTransform B 和 A，位于 Realm realm，UA 必须执行：

1. 令 result 为 新 XRRigidTransform，位于 realm。

2. 将 result 的 matrix 设为 realm中新建 Float32Array，值为 B 的 matrix 左乘 A 的 matrix。

3. 将 result 的 orientation 设为 realm中新建 DOMPointReadOnly，表示 result matrix 左上 3x3 子矩阵对应的旋转四元数。

4. 将 result 的 position 设为 realm中新建 DOMPointReadOnly，取自 result matrix 的第四列向量。

5. 返回 result。

result 表示从 A 源空间到 B 目标空间的变换。

注意：这等价于构造一个 XRRigidTransform，其 orientation 为 A 与 B 的旋转的合成，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 并中止。

3. 如果 context 已丢失，抛出 InvalidStateError 并中止。

4. 如果 session 是 沉浸式会话 且 context 的 XR compatible 布尔值为 false，抛出 InvalidStateError 并中止。

5. 初始化 layer 的 context 为 context。

6. 初始化 layer 的 session 为 session。

7. 初始化 layer 的 ignoreDepthValues 如下：

   如果 layerInit 的 ignoreDepthValues 为 false 且 XR Compositor 会利用深度值：

   初始化 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. UA 可根据需要对 scaleFactor 进行限制或取整，例如为了性能把缓冲区尺寸对齐到2的幂。

   4. 令 framebufferSize 为推荐 WebGL framebuffer 分辨率，其宽高分别乘以 scaleFactor。

   5. 初始化 layer 的 framebuffer 为 新 WebGLFramebuffer ，在 context 的 相关 realm 下，是一个尺寸为 framebufferSize 的不透明 framebuffer，用 context 创建，session 初始化为 session，并用 layerInit 的 depth、stencil 和 alpha 参数。

   6. 分配并初始化与 session 的 XR 设备 兼容的资源，包括 GPU 可访问内存缓冲区，以支持 layer 的合成。

   7. 若 layer 的资源因任何原因无法创建，抛出 OperationError 并中止。

   否则：

   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 并中止这些步骤。

4. 如果 frame 的 active 布尔值为 false，则抛出 InvalidStateError 并中止这些步骤。

5. 如果 view 的 frame 不等于 frame，则抛出 InvalidStateError 并中止这些步骤。

6. 如果 viewport modifiable 标志为 true 且 view 的 requested viewport scale 不等于 current viewport scale：

   1. 将 current viewport scale 设为 requested viewport scale。

   2. 在 视口对象列表中，将与 view 关联的 XRViewport 设置为通过 获取缩放视口，从与 view 关联的 全尺寸视口列表及 session 得到的 XRViewport。

7. 将 view 的 viewport modifiable 标志设为 false。

8. 令 viewport 为 视口对象列表中与 view 关联的 XRViewport。

9. 返回 viewport。

注意：viewport modifiable 标志即使 current viewport scale 没有更改也会被设为 false。这样保证 getViewport(view) 在同一动画帧内多次调用总是返回一致结果，第一次获取的值会被锁定用于该帧后续操作。如果应用在 getViewport() 之后调用 requestViewportScale()，则请求的值只会在未来帧再次调用 getViewport() 时生效。

要确定 XRSession session 的 原生 WebGL 帧缓冲分辨率，需执行以下步骤：

1. 如果 session 的 mode 值不是 "inline"， 则将 原生 WebGL 帧缓冲分辨率 设为，足以容纳所有 XRView 的帧缓冲像素，与显示屏下最大放大倍率区域的物理像素一一对应的分辨率，并中止这些步骤。如无方法可得，则可用 推荐 WebGL 帧缓冲分辨率。

2. 如果 session 的 mode 值为 "inline"， 则将 原生 WebGL 帧缓冲分辨率 设为 session 的 renderState 的 输出画布的物理显示像素尺寸，在画布尺寸变化或 输出画布 变化时应重新评估本步骤。

getNativeFramebufferScaleFactor(session) 方法调用时，必须执行以下步骤：

1. 令 session 为 this。

2. 如果 session 的 ended 值为 true，则返回 0.0 并中止这些步骤。

3. 返回 session 的 推荐 WebGL 帧缓冲分辨率 的宽和高分别乘以的值，以得到 session 的 原生 WebGL 帧缓冲分辨率。

调用此方法时，UA 必须执行以下步骤：

1. 如果请求文档的origin 不被允许使用 "xr-spatial-tracking" 权限策略，resolve promise 并返回。XR 权限策略被禁用时，应表现为本地没有 XR 设备，因为 makeXRCompatible() 设计为一次性设置的方法。

2. 令 promise 为 新建 Promise，属于该 WebGLRenderingContextBase 所在 Realm。

3. 令 context 为 this。

4. 以下步骤并行执行：

   1. 令 device 为 ensure an immersive XR device is selected 的结果。

   2. 设置 context 的 XR compatible 布尔值如下：

      如果 context 的 WebGL context lost flag 已设：

      排队一个任务，将 context 的 XR compatible 设为 false，并用 InvalidStateError 拒绝 promise。

      如果 device 为 null：

      排队一个任务，将 context 的 XR compatible 设为 false，并用 InvalidStateError 拒绝 promise。

      如果 context 的 XR compatible 为 true：

      排队一个任务，resolve promise。

      如果 context 是在 兼容图形适配器上为 device 创建的：

      排队一个任务，将 context 的 XR compatible 设为 true，resolve promise。

      否则：

      排队一个任务 在 WebGL 任务源 上，执行以下步骤：

      1. 强制 context 丢失。

      2. 按 WebGL 规范处理上下文丢失：

         1. 令 canvas 为 context 的 canvas。

         2. 如果 context 的 webgl context lost flag 已设，终止这些步骤。

         3. 设 context 的 webgl context lost flag。

         4. 设每个由 context 创建的 WebGLObject 实例的invalidated 标志。

         5. 禁用所有扩展，除了 "WEBGL_lose_context"。

         6. 排队一个任务 在 WebGL 任务源 上，执行以下步骤：

            1. 触发 WebGL context 事件 e，事件名 "webglcontextlost"，目标 canvas，statusMessage 设为 ""。

            2. 如果 e 的 canceled flag 未设，则用 AbortError 拒绝 promise，并终止。

            3. 以下步骤并行执行。

               1. 等待在 兼容图形适配器上的可恢复绘图缓冲区，适配于 device。

               2. 将一个任务排入队列 在 WebGL task source 上执行以下步骤：

                  1. 恢复 上下文 在 兼容的 图形适配器 上，用于 device.

                  2. 将 context 的 XR compatible 设为 true。

                  3. resolve promise。

5. 返回 promise。

此外，任何 WebGL context 丢失时，在触发 "webglcontextlost" 事件前应执行下面步骤：

1. 将 context 的 XR compatible 设为 false。

当用户代理需要以名称 name、XRFrame frame 和 XRInputSource source 触发输入源事件时，必须执行以下步骤：

1. 用 XRInputSourceEvent、type name、frame frame 和 inputSource source 创建 event。

2. 将 frame 的 active 布尔值设为 true。

3. 为 frame 应用帧更新。

4. 在 frame 的 session 上 分发 event。

5. 将 frame 的 active 布尔值设为 false。