XRSession：domOverlayState 属性
immersive-ar XRSession 的只读domOverlayState 属性提供有关 DOM 叠加层的信息（如果该功能已启用）。
值
如果 DOM 叠加层功能不受支持或未启用，则返回 null，或者返回一个包含有关 DOM 叠加层状态信息的包含以下属性的对象
type-
指示 DOM 叠加层如何显示的字符串。可能的取值：
screen-
叠加层绘制在整个基于屏幕的设备上（适用于手持式 AR 设备）。
head-locked-
叠加层绘制在填充可渲染视口的头部锁定 UI 上，并跟随用户的头部移动。
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 |
浏览器兼容性
BCD 表仅在启用 JavaScript 的浏览器中加载。