XRReferenceSpaceType - 定义了用于标识 WebXR 支持的参考空间类型的字符串

XRReferenceSpaceType 枚举类型定义了用于标识 WebXR 支持的参考空间类型的字符串。在调用 requestReferenceSpace() 方法以获取 XRSession 的参考空间时使用此类型。

XRSession.requestReferenceSpace() 返回的参考空间为 XRReferenceSpaceXRBoundedReferenceSpace。下表中的 “接口” 列指示为每个参考空间类型常量返回两种类型中的哪一种。

参考空间描述符

下表中列出了参考空间的类型,以及有关它们的用例,以及用于实现它们的接口的简要信息。

bounded-floor

local 类型类似,不同之处在于,不希望用户移动到预定边界之外,该边界由返回对象中的 boundsGeometry 赋予。

对应的接口是 XRBoundedReferenceSpace

local

创建会话时其原始位置位于查看者位置附近的跟踪空间。确切位置取决于基础平台和实现。用户不会移动太多,甚至不会超出他们的起始位置,并且针对此用例优化了跟踪。

对于具有六个自由度(6DoF)跟踪的设备,local 参考空间会尝试使原点相对于环境保持稳定。

对应的接口是 XRReferenceSpace

local-floor

local 类型类似,不同之处在于,起始位置放置在安全的位置,以使观看者可以站立,其中 y 轴的值在楼层为 0。如果该底限未知,则 user agent 将估计底限。如果估计的楼层高度不为零,则预期浏览器将其舍入为一种避免产生指纹的方式(可能会接近最近的厘米)。

对应的接口是 XRReferenceSpace

unbounded

一个允许用户完全自由移动的跟踪空间,可能距离他们的原点很远。没有跟踪查看器;观众完全没有被跟踪;跟踪是为用户当前位置的稳定性而优化的,因此原始原点可能会根据需要漂移以适应这种需要。

对应的接口是 XRReferenceSpace

viewer

一个跟踪空间,其原始位置跟踪查看者的位置和方向。它用于用户可以在其中进行物理移动的环境,并且受到沉浸式和嵌入式的所有 XRSession 实例的支持,不过它对内联会话最有用。在确定查看器与输入之间的距离或使用偏移空间时,此功能特别有用。否则,通常将更频繁地使用其他参考空间类型之一。

对应的接口是 XRReferenceSpace

规范

规范 状态 备注
WebXR Device API
XRReferenceSpaceType 的定义
工作草案 初始定义。

桌面浏览器兼容性

暂无兼容数据