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

瀏覽器相容性

另見