XRReferenceSpaceType - 定义了用于标识 WebXR 支持的参考空间类型的字符串
XRReferenceSpaceType
枚举类型定义了用于标识 WebXR 支持的参考空间类型的字符串。在调用 requestReferenceSpace()
方法以获取 XRSession
的参考空间时使用此类型。
值
由 XRSession.requestReferenceSpace()
返回的参考空间为 XRReferenceSpace
或 XRBoundedReferenceSpace
。下表中的 “接口” 列指示为每个参考空间类型常量返回两种类型中的哪一种。
参考空间描述符
下表中列出了参考空间的类型,以及有关它们的用例,以及用于实现它们的接口的简要信息。
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 的定义 |
工作草案 | 初始定义。 |
桌面浏览器兼容性
暂无兼容数据