WebXR 设备 API

每当沉浸式 XR 设备列表发生变化时，用户代理 should 通过运行以下步骤来选择沉浸式 XR 设备：

1. 令 oldDevice 为沉浸式 XR 设备。

2. 如果沉浸式 XR 设备列表是空 列表， 则将沉浸式 XR 设备设为 null。

3. 如果沉浸式 XR 设备列表的 大小为一，则将沉浸式 XR 设备设为 沉浸式 XR 设备列表[0]。

4. 按如下方式设置沉浸式 XR 设备：

   如果存在任何活动的 XRSession， 且沉浸式 XR 设备列表 包含 oldDevice：

   将沉浸式 XR 设备设为 oldDevice。

   否则：

   将沉浸式 XR 设备设为用户代理所选择的设备。

5. 如果适当，用户代理 MAY 将内联 XR 设备更新为 沉浸式 XR 设备， 否则更新为默认内联 XR 设备。

6. 如果这是首次枚举设备，或者 oldDevice 等于 沉浸式 XR 设备，则中止这些步骤。

7. 关闭 任何活动的 XRSession。

8. 排队一个任务，将所有 WebGLRenderingContextBase 实例的 XR compatible 布尔值设为 false。

9. 排队一个任务，在 相关 Global 对象的 navigator 的 xr 上 触发 一个事件，其名称为 devicechange。

10. 排队一个任务，在任何因 沉浸式 XR 设备或 内联 XR 设备的变化而受到影响的 XRPermissionStatus 对象上触发适当的 change 事件。

注：这些步骤应始终 并行运行。

用户代理可以通过运行以下步骤来确保选中了沉浸式 XR 设备：

1. 如果沉浸式 XR 设备不是 null，则返回 沉浸式 XR 设备并中止这些步骤。

2. 枚举沉浸式 XR 设备。

3. 选择沉浸式 XR 设备。

4. 返回沉浸式 XR 设备。

注：这些步骤应始终 并行运行。

调用此方法时，它 MUST 运行以下步骤：

1. 令 promise 为此 XRSystem 的 相关 realm中的 新 Promise。

2. 如果 mode 是 "inline"， 则用 true 解决 promise 并返回它。

3. 如果 mode 是沉浸式会话模式，且请求文档的 源不被允许使用 "xr-spatial-tracking" 权限策略，则用 "SecurityError" DOMException 拒绝 promise 并返回它。

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

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

   用 false 解决 promise。

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

   promise MAY 用 true 解决， 前提是所有按用户代理字符串 不可区分的用户代理实例在此处产生相同结果。

   否则

   并行运行以下步骤：

   1. 令 device 为针对 mode、一个空 列表和 一个空 列表 获得当前设备的结果。

   2. 如果 device 为 null，则用 false 解决 promise 并中止这些步骤。

   3. 如果 device 的受支持模式列表不 包含 mode，则 排队一个任务以用 false 解决 promise 并中止这些步骤。

   4. 使用 XRSessionSupportedPermissionDescriptor 请求使用 强大特性 "xr-session-supported" 的使用权限，其中 mode 等于 mode。如果它返回 "denied"， 则排队一个任务以用 false 解决 promise 并中止这些步骤。更多信息见指纹识别 考量。

   5. 排队一个任务，用 true 解决 promise。

5. 返回 promise。

requestSession(mode, options) 方法尝试在可能的情况下为给定 mode 初始化一个 XRSession， 并在必要时进入沉浸式模式。

调用此方法时，用户代理 MUST 运行以下步骤：

1. 令 promise 为此 XRSystem 的 相关 realm中的 新 Promise。

2. 令 immersive 为 true，如果 mode 是 沉浸式会话模式；否则为 false。

3. 令 global object 为调用此方法的 XRSystem 的相关 Global 对象。

4. 按如下方式检查会话请求是否被允许：

   如果 immersive 为 true：

   1. 检查是否为 global object 允许沉浸式会话请求； 如果不允许，则用 "SecurityError" DOMException 拒绝 promise 并返回 promise。

   2. 如果待处理沉浸式会话为 true，或活动沉浸式会话不是 null，则用 "InvalidStateError" DOMException 拒绝 promise 并返回 promise。

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

   否则：

   检查是否为 global object 允许内联会话请求； 如果不允许，则用 "SecurityError" DOMException 拒绝 promise 并返回 promise。

5. 并行运行以下步骤：

   1. 令 requiredFeatures 为 options 的 requiredFeatures。

   2. 令 optionalFeatures 为 options 的 optionalFeatures。

   3. 将 device 设为针对 mode、requiredFeatures 和 optionalFeatures 获得 当前设备的结果。

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

      1. 如果 device 为 null，或 device 的 受支持模式列表不 包含 mode，则运行以下 步骤：

         1. 用 "NotSupportedError" DOMException 拒绝 promise。

         2. 如果 immersive 为 true，则将 待处理沉浸式 会话设为 false。

         3. 中止这些步骤。

      2. 令 descriptor 为一个以 mode、requiredFeatures 和 optionalFeatures 初始化的 XRPermissionDescriptor

      3. 令 status 为一个 XRPermissionStatus， 初始为 null

      4. 用 descriptor 和 status 请求 xr 权限。

      5. 如果 status 的 state 为 "denied"， 则运行以下步骤：

         1. 用 "NotSupportedError" DOMException 拒绝 promise。

         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. 用 session 解决 promise。

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

          注：这些步骤确保初始 inputsourceschange 事件发生在初始会话被解决之后。

          1. 将 session 的 promise resolved 标志设为 true。

          2. 令 sources 为任何已附加到 session 的现有输入源。

          3. 如果 sources 非空，则执行以下步骤：

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

             2. 在 session 上触发一个名为 inputsourceschange 的 XRInputSourcesChangeEvent， 并将 added 设为 sources。

6. 返回 promise。

为了针对 XRSessionMode mode、requiredFeatures 和 optionalFeatures 获得 当前设备，用户代理 MUST 运行以下步骤：

1. 按如下方式选择 device：

   如果 mode 是沉浸式会话模式：

   将 device 设为确保选中沉浸式 XR 设备的结果。

   否则，如果 requiredFeatures 或 optionalFeatures 不为空：

   将 device 设为内联 XR 设备。

   否则：

   将 device 设为默认内联 XR 设备。

2. 返回 device。

注：这些步骤应始终 并行运行。

为了初始化 会话，给定 session、mode、granted 和 device， 用户代理 MUST 运行以下步骤：

1. 将 session 的 mode 设为 mode。

2. 将 session 的 XR device 设为 device。

3. 将 session 的 已授予特性集合设为 granted。

4. 初始化渲染状态。

5. 如果用户代理的其他特性尚未完成，则执行必要的平台特定步骤，以初始化设备的跟踪和渲染能力， 包括向用户显示任何必要说明。

注：某些设备需要额外的用户 激活说明。例如，在基于手机的头显设备上进入沉浸式模式 需要将手机插入头显，而在连接到外部头显的桌面浏览器上执行此操作 需要佩戴头显。确保显示任何此类说明是用户代理的责任，而不是 作者的责任。

当一个 XRSession session 被关闭时，运行以下步骤：

1. 将 session 的 ended 值设为 true。

2. 如果活动沉浸式会话等于 session，则将活动沉浸式会话设为 null。

3. 从内联会话列表中移除 session。

4. 用 InvalidStateError 拒绝由 session 返回的任何未决 promise， 但由 end() 返回的任何 promise 除外。

5. 如果用户代理的其他特性没有正在主动使用它们，则执行必要的平台特定步骤以关闭设备的跟踪和渲染能力。 这 MUST 包括：

   • 如果 session 是一个沉浸式会话，则释放对 XR 设备的 独占访问。

   • 释放 session 为向 XR 设备呈现而获取的任何图形资源。

   • 如果 session 是一个沉浸式会话，则将 XR 设备置于这样一种状态：不同来源可能能够 使用同一设备发起会话。

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

end() 方法提供了一种手动关闭 会话的方式。调用时，它 MUST 运行以下步骤：

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

2. 如果 this 的 ended 值为 true，则用 "InvalidStateError" DOMException 拒绝 promise 并返回 promise。

3. 关闭 this。

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

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

   2. 解决 promise。

5. 返回 promise。

当用户代理将使用 XRSession session 和 XRRenderStateInit newState 更新待处理层状态时，它必须运行以下步骤：

1. 如果 newState 的 layers 的 值不是 null，则抛出 NotSupportedError。

注：WebXR layers module 将为 此算法引入新的语义。

当用户代理想要在 XRSession session 上应用标称帧率 rate 时，它 MUST 运行以下步骤：

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

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

3. 将 session 的 内部标称帧率设为 rate。

4. 在 session 上触发一个名为 frameratechange 的 XRSessionEvent 事件。

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

调用此方法时，用户代理 MUST 运行以下步骤：

1. 令 session 为 this。

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

3. 如果 session 没有内部标称帧率，则用 "InvalidStateError" DOMException 拒绝 promise 并返回 promise。

4. 如果 session 的 ended 值为 true，则用 "InvalidStateError" DOMException 拒绝 promise 并返回 promise。

5. 如果 rate 不在 supportedFrameRates 中，则用 "TypeError" DOMException 拒绝 promise 并返回 promise。

6. 将 session 的 内部目标帧率设为 rate。

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

   1. XR 合成器 MAY 使用 rate 来计算新的 显示帧率和/或 标称帧率。

   2. 令 newrate 为新的标称帧率。

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

      1. 等待直到 XRSystem 将标称帧率更新为 newrate 的操作已生效。

      2. 用 newrate 和 session 应用标称帧率。

      3. 解决 promise。

8. 返回 promise。

updateRenderState(newState) 方法将对活动渲染状态的更新排队，以便在下一帧应用。传递给此方法的 XRRenderStateInit newState 中未设置的字段不会被更改。

调用此方法时，用户代理 MUST 运行以下步骤：

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 的 passthroughFullyObscured。

10. 如果 newState 的 depthNear 值已设置，则将 session 的待处理渲染状态的 depthNear 设为 newState 的 depthNear。

11. 如果 newState 的 depthFar 值已设置，则将 session 的待处理渲染状态的 depthFar 设为 newState 的 depthFar。

12. 如果 newState 的 inlineVerticalFieldOfView 已设置，则将 session 的待处理渲染状态的 inlineVerticalFieldOfView 设为 newState 的 inlineVerticalFieldOfView。

13. 如果 newState 的 baseLayer 已设置，则将 session 的待处理渲染状态的 baseLayer 设为 newState 的 baseLayer。

在请求时，XRSession session MUST 通过运行以下步骤来 应用待处理渲染状态：

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 是一个内联会话，且 baseLayer 是一个 XRWebGLLayer 实例，并且 composition enabled 设为 false：

      将 activeState 的 composition enabled 布尔值设为 false。

      将 activeState 的 output canvas设为 baseLayer 的 context 的 canvas。

      否则：

      将 activeState 的 composition enabled 布尔值设为 true。

      将 activeState 的 output canvas设为 null。

调用此方法时，用户代理 MUST 运行以下步骤：

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

2. 并行运行以下步骤：

   1. 如果对 type 和 session 运行 reference space is supported 的结果为 false，则排队一个任务以用 NotSupportedError 拒绝 promise 并中止这些步骤。

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

      用户代理无需等待这类参考空间的跟踪建立完成后才解决 requestReferenceSpace()。 当会话最初尝试建立跟踪时，getViewerPose() 返回 null 是可以接受的，内容可以利用这段时间显示启动画面或其他内容。注意， 如果 type 是 "bounded-floor"， 且边界尚未建立，则用户代理 MAY 将边界设置为一个较小的初始区域，并在边界建立时使用 reset 事件。

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

   4. 用 type 和 session 创建参考空间 referenceSpace。

   5. 用 referenceSpace 解决 promise。

3. 返回 promise。

当新的 XR 输入源变得可用于 XRSession session 时，用户代理 MUST 运行以下步骤：

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

2. 令 added primary sources 为新的列表。

3. 令 added tracked sources 为新的列表。

4. 对于每个新的 XR 输入源：

   1. 令 inputSource 为此 XRSession 的相关 realm中的 一个新 XRInputSource， 然后执行以下步骤：

      如果 inputSource 是一个主输入 源：

      将 inputSource 添加到 added primary sources。

      否则，如果 tracked-sources 包含在 session 的已授予特性集合中：

      将 inputSource 添加到 added tracked sources。

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

   1. 用 added primary sources 扩展 session 的 活动 XR 输入源列表。

   2. 如果 added primary sources 非空，则在 session 上触发一个名为 inputsourceschange 的 XRInputSourcesChangeEvent， 并将 added 设为 added primary sources。

   3. 用 added tracked sources 扩展 session 的 活动 XR 被跟踪 源列表。

   4. 如果 added tracked sources 非空，则在 session 上触发一个名为 trackedsourceschange 的 XRInputSourcesChangeEvent， 并将 added 设为 added tracked sources。

当任何先前添加的 XR 输入源不再可用 于 XRSession session 时，用户代理 MUST 运行以下步骤：

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。

      否则，如果 tracked-sources 包含在 session 的已授予特性集合中：

      将 inputSource 添加到 removed tracked sources。

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

   1. 从 session 的活动 XR 输入源列表中 移除 removed primary sources 中的每个 XRInputSource。

   2. 如果 removed primary sources 非空，则在 session 上触发一个名为 inputsourceschange 的 XRInputSourcesChangeEvent， 并将 removed 设为 removed primary sources。

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

   4. 如果 removed tracked sources 非空，则在 session 上触发一个名为 trackedsourceschange 的 XRInputSourcesChangeEvent， 并将 removed 设为 removed tracked sources。

注：当输入源暂时同时失去位置和朝向跟踪时， 用户代理 MAY 触发此事件。建议仅对物理手持控制器输入源这样做。不建议在被跟踪的手部输入源发生这种情况时触发此事件， 因为这会经常发生；也不建议在跟踪器对象输入源发生这种情况时触发， 因为这会使应用更难维持身份概念。

当任何 XR 输入源的 handedness、 targetRayMode、 profiles、 gripSpace 是否存在，或其作为主输入源或被跟踪输入源的状态 发生变化，对于 XRSession session，用户代理 MUST 运行以下步骤：

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。

      否则，如果 tracked-sources 包含在 session 的已授予特性集合中：

      将 oldInputSource 添加到 removed tracked sources。

   2. 令 newInputSource 为 session 的 相关 realm中的一个 新 XRInputSource， 然后执行以下步骤：

      如果 newInputSource 是一个主输入 源，或者其状态从被跟踪输入 源变为主输入源：

      将 newInputSource 添加到 added primary sources。

      否则，如果 tracked-sources 包含在 session 的已授予特性集合中：

      将 newInputSource 添加到 added tracked sources。

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

   1. 从 session 的活动 XR 输入源列表中 移除 removed primary sources 中的每个 XRInputSource。

   2. 用 added primary sources 扩展 session 的 活动 XR 输入源列表。

   3. 如果 added primary sources 或 removed primary sources 非空， 则在 session 上触发一个名为 inputsourceschange 的 XRInputSourcesChangeEvent， 将 added 设为 added primary sources，并将 removed 设为 removed primary sources。

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

   5. 用 added tracked sources 扩展 session 的 活动 XR 输入源列表。

   6. 如果 added tracked sources 或 removed tracked sources 非空， 则在 session 上触发一个名为 trackedsourceschange 的 XRInputSourcesChangeEvent， 将 added 设为 added tracked sources，并将 removed 设为 removed tracked sources。

当为一个 XRSession session 创建 XRRenderState 对象时，用户代理 MUST 通过运行以下步骤来初始化渲染状态：

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 排队，以便在用户代理下一次希望为设备运行动画帧时运行。

调用此方法时，用户代理 MUST 运行以下步骤：

1. 令 session 为 this。

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

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

4. 将 callback 追加到 session 的 动画帧回调列表中， 并与 session 的 动画帧回调标识符的 当前值相关联。

5. 返回 session 的 动画帧回调标识符的 当前值。

cancelAnimationFrame(handle) 方法取消一个现有动画帧回调，该回调由其动画帧回调标识符 handle 给定。

调用此方法时，用户代理 MUST 运行以下步骤：

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 是一个内联会话，并且 session 的 renderState 的 输出画布为 null，则返回 false。

3. 返回 true。

当一个 XRSession session 从 XR 设备接收到时间戳 frameTime 的更新后观看者状态时，它会运行一个 XR 动画帧，无论 动画帧回调列表是否为空，该动画帧都 MUST 运行以下步骤：

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

   1. 令 now 为当前高分辨率时间。

   2. 令 frame 为 session 的动画 帧。

   3. 将 frame 的 time 设为 frameTime。

   4. 将 frame 的 predictedDisplayTime 设为 frameTime。

   5. 如果 session 是一个沉浸式会话，则将 frame 的 predictedDisplayTime 设为 XR 合成器预计显示此 XR 动画帧的平均时间戳。

   6. 对于 视图列表中的每个 view，将 view 的 viewport modifiable 标志设为 true。

   7. 如果 视图列表中任何视图的 active 标志自上一个 XR 动画帧以来已改变，则更新视口。

   8. 如果该帧应为 session 渲染：

      1. 将 session 的 当前 正在运行的动画帧回调列表设为 session 的 动画帧 回调列表。

      2. 将 session 的 动画帧 回调列表设为空列表。

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

      4. 为 frame 应用帧更新。

      5. 按顺序，对于 session 的 当前 正在运行的动画帧回调列表中的每个 entry：

      6. 如果 entry 的 cancelled 布尔值为 true，则继续处理下一个条目。

      7. 以 « now, frame » 和 "report" 调用 entry。

      8. 将 session 的 当前 正在运行的动画帧回调列表设为空 列表。

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

   9. 如果 session 的 待处理渲染状态不是 null，则应用待处理渲染状态。

getViewerPose(referenceSpace) 方法 以 XRViewerPose 的形式提供观看者相对于 referenceSpace 的姿态，时间为该 XRFrame 的 time。

调用此方法时，用户代理 MUST 运行以下步骤：

1. 令 frame 为 this。

2. 令 session 为 frame 的 session 对象。

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

4. 令 pose 为 session 的 相关 realm中的一个 新 XRViewerPose 对象。

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

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

7. 令 xrviews 为空列表。

8. 令 offset 为 0。

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

   1. 令 xrview 为 session 的 相关 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 为 session 的 相关 realm中一个新的 XRRigidTransform 对象，等于 view 在 视图偏移中的值。

   9. 将 xrview 的 transform 属性设为在 session 的相关 realm 中，将 XRViewerPose 的 transform 与 viewtransform 变换相乘所得的结果。

   10. 将 xrview 追加到 xrviews。

   11. 将 offset 增加 1。

10. 将 pose 的 views 设为 xrviews

11. 返回 pose。

getPose(space, baseSpace) 方法 以 XRPose 的形式， 在 XRFrame 表示的时间， 提供 space 相对于 baseSpace 的姿态。

调用此方法时，用户代理 MUST 运行以下步骤：

1. 令 frame 为 this。

2. 令 pose 为 frame 的 相关 realm中的一个 新 XRPose 对象。

3. 在 baseSpace 中，于 frame 表示的时间，将 space 的 pose 填充 到 pose 中。

4. 返回 pose。

为了为 XRFrame frame 应用帧更新，用户代理 MUST 运行以下步骤：

1. 对于 frame 的 session 的 帧更新列表中的每个 frame update， 执行以下步骤：

   1. 用 frame 运行 frame update。

为了在一个 XRSpace baseSpace 中，于一个 XRFrame frame 表示的时间，将一个 XRSpace space 的 pose 填充到一个 XRPose pose 中，并带有可选的 force emulation 标志，用户代理 MUST 运行以下 步骤：

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 在 frame 的 time 相对于 baseSpace 的姿态， 然后执行以下步骤：

   如果 limit 为 false，并且跟踪系统为 space 相对于 baseSpace 的姿态提供了一个位置被主动跟踪或静态已知的 6DoF 姿态：

   将 transform 的 orientation 设为 space 的 effective origin 在 baseSpace 的 坐标 系中的朝向。

   将 transform 的 position 设为 space 的 effective origin 在 baseSpace 的 坐标 系中的位置。

   如果支持，将 pose 的 linearVelocity 设为 space 的 effective origin 相对于 baseSpace 的 坐标 系的线速度。

   如果支持，将 pose 的 angularVelocity 设为 space 的 effective origin 相对于 baseSpace 的 坐标 系的角速度。

   将 pose 的 emulatedPosition 设为 false。

   否则，如果 limit 为 false，并且跟踪系统提供了一个 3DoF 姿态，或一个其位置既未被主动跟踪也非静态已知的 6DoF 姿态，用于表示 space 相对于 baseSpace 的姿态：

   将 transform 的 orientation 设为 space 的 effective origin 在 baseSpace 的 坐标 系中的朝向。

   将 transform 的 position 设为跟踪系统对 space 的 effective origin 在 baseSpace 的 坐标系中位置的最佳估计。这 MAY 包括 诸如颈部或手臂模型之类的计算偏移。如果位置估计不可用， 则 MUST 使用最后已知位置。

   将 pose 的 linearVelocity 设为 null。

   将 pose 的 angularVelocity 设为 null。

   将 pose 的 emulatedPosition 设为 true。

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

   将 transform 的 position 设为 space 的 effective origin 在 baseSpace 的 坐标 系中的最后已知位置。

   将 transform 的 orientation 设为 space 的 effective origin 在 baseSpace 的 坐标 系中的最后已知朝向。

   将 pose 的 linearVelocity 设为 null。

   将 pose 的 angularVelocity 设为 null。

   将 pose 的 emulatedPosition 布尔值设为 true。

   否则：

   将 pose 设为 null。

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

当为 XRSession session 请求一个类型为 XRReferenceSpaceType type 的 XRReferenceSpace 时，用户代理 MUST 通过运行以下步骤来创建参考空间：

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 的 相关 realm中，将 base 的 origin offset 与 originOffset 相乘所得的结果。

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中的一个 新 矩阵，其值等于 view geometry 的 投影矩阵。

3. 返回 view geometry 的 内部投影矩阵。

requestViewportScale(scale) 方法请求用户代理将此视口的 requested viewport scale 设置为所请求的值。

当此方法在一个 XRView xrview 上调用时，用户代理 MUST 运行以下步骤：

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. 对于 视图列表中的每个 活动 视图 view：

   1. 令 viewport 为从与 session 的 view 关联的 完整大小视口列表中 获得缩放视口所得的 XRViewport 结果。

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

为了为给定 XRView view 和 XRSession session 获得缩放视口：

1. 令 glFullSizedViewport 为来自与 view 关联的 完整大小视口列表的 WebGL viewport。

2. 令 scale 为 view 的 current viewport scale。

3. 用户代理 MAY 选择钳制 scale，以应用最小视口缩放因子。

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 分量加上 glFullSizedViewport 的 width 再减去 glViewport 的 width（含）之间。

10. 将 glViewport 的 y 分量设为一个整数值，该值位于 glFullSizedViewport 的 y 分量（含）与 glFullSizedViewport 的 y 分量加上 glFullSizedViewport 的 height 再减去 glViewport 的 height（含）之间。

11. 令 viewport 为 session 的 相关 realm中的一个 新 XRViewport。

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 MAY 也选择在指定约束内略作调整的值，例如为了效率将视口对齐到 2 的幂像素网格。 缩放视口 MUST 完全包含在完整大小视口内，但 MAY 按 UA 自行决定放置在完整大小视口内的任意位置。 大小和位置计算 MUST 是确定性的，并且在会话内对相同输入值返回一致结果。

为了归一化一个分量列表， UA MUST 执行以下步骤：

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

2. 如果 length 为 0，则抛出 InvalidStateError 并中止这些步骤。

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

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

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 值设为 position 的 x 字典成员，将 y 值设为 position 的 y 字典成员，将 z 值设为 position 的 z 字典成员，并将 w 值设为 position 的 w 字典成员。

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

7. 将 transform 的 orientation 的 x 值设为 orientation 的 x 字典成员，将 y 值设为 orientation 的 y 字典成员，将 z 值设为 orientation 的 z 字典成员，并将 w 值设为 orientation 的 w 字典成员。

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

9. 归一化 transform 的 orientation 的 x、 y、 z 和 w 分量。

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， 其值是在 transform 的 相关 realm中，将 translation 和 rotation 相乘且 translation 在左侧（translation * rotation）的结果。 数学上，此矩阵为

   

5. 返回 transform 的 内部矩阵。

为了在 Realm realm 中将两个 XRRigidTransform 相乘， B 和 A，UA MUST 执行以下步骤：

1. 令 result 为 realm 中一个新的 XRRigidTransform 对象。

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。

当 XRSession session 的一个 XR 输入 源 source 开始其主要操作时，UA MUST 运行以下步骤：

1. 令 frame 为 session 的 相关 realm中的一个 新 XRFrame， 其 session 为 session，time 为该操作发生的时间。

2. 排队一个任务，以触发输入 源事件，其名称为 selectstart， frame 为 frame，source 为 source。

当 XRSession session 的一个 XR 输入 源 source 结束其主要操作时，UA MUST 运行以下步骤：

1. 令 frame 为 session 的 相关 realm中的一个 新 XRFrame， 其 session 为 session，time 为该操作发生的时间。

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

   1. 触发输入源事件，其名称为 select， frame 为 frame，source 为 source。

   2. 触发输入源事件，其名称为 selectend， frame 为 frame，source 为 source。

当 XRSession session 的一个 XR 输入 源 source 开始其主要 squeeze 操作时，UA MUST 运行以下步骤：

1. 令 frame 为 session 的 相关 realm中的一个 新 XRFrame， 其 session 为 session，time 为该操作发生的时间。

2. 排队一个任务，以触发输入 源事件，其名称为 squeezestart， frame 为 frame，source 为 source。

当 XRSession session 的一个 XR 输入 源 source 结束其主要 squeeze 操作时，UA MUST 运行以下步骤：

1. 令 frame 为 session 的 相关 realm中的一个 新 XRFrame， 其 session 为 session，time 为该操作发生的时间。

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

   1. 触发输入源事件，其名称为 squeeze， frame 为 frame，source 为 source。

   2. 触发输入源事件，其名称为 squeezeend， frame 为 frame，source 为 source。

当 XRSession session 的一个 XR 输入 源 source 的主要操作被取消时，UA MUST 运行以下步骤：

1. 令 frame 为 session 的 相关 realm中的一个 新 XRFrame， 其 session 为 session，time 为该操作发生的时间。

2. 排队一个任务，以触发输入 源事件，触发一个名称为 selectend 的 XRInputSourceEvent， frame 为 frame，source 为 source。

当 XRSession session 的一个 XR 输入 源 source 的主要 squeeze 操作被取消时，UA MUST 运行以下 步骤：

1. 令 frame 为 session 的 相关 realm中的一个 新 XRFrame， 其 session 为 session，time 为该操作发生的时间。

2. 排队一个任务，以触发输入 源事件，触发一个名称为 squeezeend 的 XRInputSourceEvent， frame 为 frame，source 为 source。

当 XRSession session 的一个 瞬态输入源 source 开始其 瞬态操作时，UA MUST 运行以下步骤：

1. 令 frame 为 session 的 相关 realm中的一个 新 XRFrame， 其 session 为 session，时间为该操作发生的时间。

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

   1. 如有必要，触发由 XR 输入源操作产生的任何 "pointerdown" 事件。

   2. 将 XR 输入源添加到 活动 XR 输入源列表。

   3. 如果 瞬态操作是一个 主要操作，则触发输入源事件，其名称为 selectstart， frame 为 frame，source 为 source。

当 XRSession session 的一个 瞬态输入源 source 结束其 瞬态操作时，UA MUST 运行以下步骤：

1. 令 frame 为 session 的 相关 realm中的一个 新 XRFrame， 其 session 为 session，时间为该操作发生的时间。

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

   1. 如果 瞬态操作是一个 主要操作，则触发输入源事件，其名称为 select， frame 为 frame，source 为 source。

   2. 如有必要，触发由 XR 输入源操作产生的任何 "click" 事件。

   3. 如果 瞬态操作是一个 主要操作，则触发输入源事件，其名称为 selectend， frame 为 frame，source 为 source。

   4. 从 活动 XR 输入源列表中 移除 XR 输入源。

   5. 如有必要，触发由 XR 输入源操作产生的任何 "pointerup" 事件。

当 XRSession session 的一个 瞬态输入源 source 的 瞬态操作被取消时，UA MUST 运行以下步骤：

1. 令 frame 为 session 的 相关 realm中的一个 新 XRFrame， 其 session 为 session，时间为该操作发生的时间。

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

   1. 如果 瞬态操作是一个 主要操作，则触发输入源事件，其名称为 selectend， frame 为 frame，source 为 source。

   2. 从 活动 XR 输入源列表中 移除 XR 输入源。

   3. 如有必要，触发由 XR 输入源操作产生的任何 "pointerup" 事件。

XRWebGLLayer(session, context, layerInit) 构造函数在调用时 MUST 执行以下步骤：

1. 令 layer 为 session 的 相关 realm中的一个 新 XRWebGLLayer。

2. 如果 session 的 ended 值为 true，则抛出 InvalidStateError 并中止这些步骤。

3. 如果 context is lost，则抛出 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 是一个内联会话：

   将 layer 的 composition enabled 初始化为 false。

   否则：

   将 layer 的 composition enabled 布尔值初始化为 true。

9. 如果 layer 的 composition enabled 布尔值为 true：

   1. 将 layer 的 antialias 初始化为 layerInit 的 antialias 值。

   2. 令 scaleFactor 为 layerInit 的 framebufferScaleFactor。

   3. 用户代理 MAY 在此处选择按其认为合适的方式钳制或舍入 scaleFactor， 例如，如果它出于性能原因希望将缓冲区尺寸适配为 2 的幂。

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

   5. 将 layer 的 framebuffer 初始化为 context 的 相关 realm中的一个 新 WebGLFramebuffer， 它是一个由 context 创建、尺寸为 framebufferSize 的 不透明 framebuffer，其 session 初始化为 session，并使用 layerInit 的 depth、 stencil 和 alpha 值。

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

   7. 如果 layer 的资源因任何原因无法创建，则抛出 OperationError 并中止这些步骤。

   否则：

   1. 将 layer 的 antialias 初始化为 layer 的 context 的 实际上下文参数中的 antialias 值。

   2. 将 layer 的 framebuffer 初始化为 null。

10. 返回 layer。

getViewport(view) 方法在 XRWebGLLayer layer 上调用时，MUST 运行以下步骤：

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 设为从与 session 的 view 关联的 完整大小视口列表中 获得缩放视口所得的 XRViewport 结果。

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

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

9. 返回 viewport。

注：viewport modifiable 标志会被有意设为 false， 即使 current viewport scale 没有变化也是如此。这确保 getViewport(view) 调用在一个动画帧内对于该视图总是返回一致的结果， 因此第一个检索到的值会在该帧剩余期间被锁定。如果应用在 getViewport() 之后调用 requestViewportScale()， 则请求的值只会在未来帧中再次调用 getViewport() 时才被应用。

一个 XRSession session 的 原生 WebGL framebuffer 分辨率通过运行以下步骤确定：

1. 如果 session 是一个内联会话，则将 原生 WebGL framebuffer 分辨率设为 session 的 renderState 的 output canvas 的物理显示像素大小， 每次 canvas 大小发生变化或output canvas 发生变化时重新评估这些步骤，并中止这些步骤。

2. 将 原生 WebGL framebuffer 分辨率设为如下所需的分辨率： 一个足够大、能够包含会话所有 XRView 的 framebuffer 的像素，与最高放大倍率下显示区域中的物理屏幕像素之间具有 1:1 比率。如果不存在如上所述确定原生分辨率的方法， MAY 使用 推荐的 WebGL framebuffer 分辨率。

getNativeFramebufferScaleFactor(session) 方法在调用时 MUST 运行以下步骤：

1. 令 session 为 this。

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

3. 返回一个值，使 session 的 推荐的 WebGL framebuffer 分辨率的宽度和高度分别乘以该值后，得到 session 的 原生 WebGL framebuffer 分辨率。

当调用此方法时，用户代理 MUST 运行以下步骤：

1. 如果发起请求的文档的origin 不允许使用 "xr-spatial-tracking" 权限策略，则resolve promise 并返回它。当 XR 权限策略被禁用时，我们希望在这种情况下表现得仿佛没有 XR 设备， 因为 makeXRCompatible() 应该是一个设置后即忘的方法。

2. 令 promise 为在此 WebGLRenderingContextBase 的 Realm 中创建的新 Promise。

3. 令 context 为 this。

4. 并行运行以下步骤：

   1. 令 device 为确保已选择沉浸式 XR 设备的结果。

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

      如果 context 的 WebGL context lost flag 已设置：

      排队一个任务，将 context 的 XR compatible 布尔值设为 false，并以 InvalidStateError reject promise。

      如果 device 为 null：

      排队一个任务，将 context 的 XR compatible 布尔值设为 false，并以 InvalidStateError reject promise。

      如果 context 的 XR compatible 布尔值为 true：

      排队一个任务，以resolve promise。

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

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

      否则：

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

      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 task source 上 排队一个任务，以执行以下步骤：

            1. 在 canvas 上触发一个 WebGL 上下文事件 e，名称为 "webglcontextlost"，并将 statusMessage 设为 ""。

            2. 如果 e 的 canceled flag 未设置， 则以 AbortError reject promise 并中止这些步骤。

            3. 并行运行以下步骤。

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

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

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

                  2. 将 context 的 XR compatible 布尔值设为 true。

                  3. Resolve promise。

5. 返回 promise。

此外，当任何 WebGL 上下文丢失时，在触发 "webglcontextlost" 事件之前运行以下步骤：

1. 将该上下文的 XR compatible 布尔值设为 false。

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

1. 创建一个 XRInputSourceEvent event，其 type 为 name，frame 为 frame，并且 inputSource 为 source。

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

3. 对 frame 应用帧更新。

4. 在 frame 的 session 上派发 event

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