XRSpace

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

XRSpace 接口是 WebXR 设备 API 的一部分,它是一个抽象接口,为表示虚拟世界中虚拟坐标系统的每个类提供了一个通用基础。该接口的 origin (原点) 对应于一个物理位置。WebXR 中的空间数据始终相对于一个基于 XRSpace 的派生接口的对象来表示,该对象在给定 XRFrame 发生时有效。

因此,诸如姿势位置之类的数值是相应 XRSpace 中的坐标,相对于该空间的原点。

注意: XRSpace 接口本身从不直接使用;相反,所有空间都是使用基于 XRSpace 的某个接口创建的。目前,这些接口是 XRReferenceSpaceXRBoundedReferenceSpaceXRJointSpace

EventTarget XRSpace

基于 XRSpace 的接口

以下是基于 XRSpace 接口的接口列表。

XRBoundedReferenceSpace

表示一个参考空间,它可能在一个空间区域内移动,该区域的边界由一组按顺时针顺序沿地面排列的点定义,以界定该空间的可通行区域。XRBoundedReferenceSpace 的原点始终位于地面水平,其 X 和 Z 坐标通常默认为房间中心附近的一个位置。

XRReferenceSpace

表示一个参考空间,该空间通常期望在 XRSession 的持续时间内保持静态。虽然对象可以在空间内移动,但空间本身会固定在原地。这种静态性质也有例外;最常见的是,为了根据用户头显或其他运动敏感设备的重新配置进行调整,XRReferenceSpace 可能会移动。

XRJointSpace

表示一个 XRHand 关节的空间。

实例属性

XRSpace 接口本身不定义任何属性;但是,它继承了其父接口 EventTarget 的属性。

实例方法

XRSpace 接口本身不提供任何方法。但是,它继承了其父接口 EventTarget 的方法。

规范

规范
WebXR Device API
# xrspace-interface

浏览器兼容性