XRRenderState

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

XRRenderState 接口是 WebXR 设备 API 的一部分,其中包含可配置的值,这些值会影响 XRSession 生成的图像如何进行合成。这些属性包括在其中渲染内容的距离范围、垂直视场(用于内联呈现),以及指向用作在 XR 设备显示器上呈现场景之前的渲染目标的 XRWebGLLayer 的引用。

当您使用 XRSession 方法 updateRenderState() 应用更改时,指定的更改将在当前动画帧完成后,但在下一帧开始之前生效。

实例属性

XRRenderState.baseLayer 只读 实验性

浏览器合成系统从中获取 XR 会话图像的 XRWebGLLayer

XRRenderState.depthFar 只读 实验性

远裁剪平面到观察者的距离(以米为单位)。远裁剪平面是与显示器平行的平面,超出该平面将不再渲染场景。这本质上指定了用户可以看到的最大距离。

XRRenderState.depthNear 只读 实验性

近裁剪平面到观察者的距离(以米为单位)。近裁剪平面是与显示器平行的平面,场景的渲染从该平面开始。比此距离更近的任何部分都不会被绘制。

XRRenderState.inlineVerticalFieldOfView 只读 实验性

当会话处于 inline 模式时使用的默认垂直视场(以弧度为单位)。对于所有沉浸式会话,此值为 null

XRRenderState.layers 只读 实验性

一个有序数组,其中包含由 XR 合成器显示的 XRLayer 对象。

规范

规范
WebXR Device API
# xrrenderstate-interface

浏览器兼容性

另见