XRSession: domOverlayState 屬性

可用性有限

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

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

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

immersive-ar XRSession只讀 domOverlayState 屬性提供了有關 DOM 覆蓋的資訊(如果該功能已啟用)。

如果 DOM 覆蓋功能不受支援或未啟用,則返回 null,否則返回一個包含 DOM 覆蓋狀態資訊的物件,該物件具有以下屬性:

type

一個指示 DOM 覆蓋顯示方式的字串。可能的值:

screen

覆蓋繪製在整個基於螢幕的裝置上(適用於手持 AR 裝置)。

head-locked

覆蓋繪製在以頭部為中心的使用者介面上,該介面填充可渲染的視口並跟隨使用者的頭部移動。

floating

覆蓋顯示為一個漂浮在空間中的矩形,始終保持在使用者前面。它不一定會填充整個空間,並且/或者不嚴格地以頭部為中心。

示例

檢查啟用了哪個 DOM 覆蓋

js
if (session.domOverlayState) {
  console.log(session.domOverlayState.type);
} else {
  console.log("DOM overlay not supported or enabled!");
}

規範

規範
WebXR DOM 疊加模組
# dom-xrsession-domoverlaystate

瀏覽器相容性

另見