XRCubeLayer:redraw 事件

可用性有限

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

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

当图层的底层资源丢失或 XR 合成器无法再重投影图层时,会向 XRCubeLayer 对象发送 redraw 事件。如果发送此事件,开发者应在下一个 XR 动画帧中重绘图层的内容。

另请参阅 XRCompositionLayer.needsRedraw 属性,该属性通过继承自 XRCompositionLayer 的方式也可用于 XRCubeLayer 对象。

语法

在诸如 addEventListener() 之类的方法中使用事件名称,或设置事件处理程序属性。

js
addEventListener("redraw", (event) => { })

onredraw = (event) => { }

事件类型

一个 XRLayerEvent。继承自 Event

事件属性

除了下面列出的属性之外,父接口 Event 的属性也可使用。

layer 只读

生成事件的 XRLayer

示例

使用 redraw 事件

您可以将 redraw 传递给 addEventListener()

js
cubeLayer.addEventListener("redraw", (event) => {
  // redraw the layer
});

或者,您可以使用 onredraw 事件处理程序属性来为 redraw 事件建立一个处理程序

js
cubeLayer.onredraw = (event) => {
  // redraw the layer
};

规范

规范
WebXR Layers API Level 1
# dom-xrcubelayer-onredraw

浏览器兼容性

另见