XRCompositionLayer: needsRedraw 屬性

可用性有限

此特性不是基線特性，因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性： 這是一項實驗性技術
在生產中使用此技術之前，請仔細檢查瀏覽器相容性表格。

XRCompositionLayer 介面的只讀 needsRedraw 屬性是一個布林值，用於指示該圖層應在下一幀中重新渲染。

重新渲染的需求可能發生在圖層的底層資源丟失時，例如紋理可能已被合成器在後臺釋放。當裝置進入睡眠狀態或瀏覽器切換上下文（例如切換到作業系統對話方塊等）然後返回時，可能會發生這種情況。

對於每一幀都更新的圖層來說，重新渲染不是問題。但是，對於不頻繁更新的圖層，或靜態圖層（您只能在建立後或在 redraw 事件後繪製一次），圖層的內容可能會丟失並需要重新繪製。如果圖層的資源丟失，needsRedraw 屬性將為 true，並且會在圖層上觸發一個 redraw 事件。

值

一個布林值。true 表示下一幀需要重新渲染，false 表示不需要重新渲染。

使用 needsRedraw 屬性檢查圖層是否需要重新繪製，然後進行重繪。

function onXRFrame(time, frame) {
  // …

  if (quadLayer.needsRedraw) {
    // redraw the layer
  }
}

規範
WebXR Layers API Level 1 # dom-xrcompositionlayer-needsredraw

此頁面最後修改於 2023年4月8日，由 MDN 貢獻者更新。