XRFrame

安全上下文:此功能仅在安全上下文(HTTPS)中可用,在一些或所有支持的浏览器中可用。

实验性:这是一个实验性技术
在生产环境中使用此功能之前,请仔细查看浏览器兼容性表格

一个WebXR 设备 APIXRFrame对象被传递到requestAnimationFrame()回调函数中,并提供访问渲染XRSession描述的 VR 或 AR 场景的单个动画帧所需信息。传递跟踪对象状态的事件也会在其结构中提供XRFrame的引用。

除了提供要渲染此帧的XRSession的引用外,还提供了getViewerPose()方法来获取描述查看者在空间中的位置和方向的XRViewerPose,并且可以使用getPose()来创建一个XRPose,该XRPose描述一个XRSpace相对于另一个XRSpace的相对位置。

实例属性

session 只读 实验性

用于此XRFrame描述所有对象跟踪详细信息的XRSession。可以通过调用对象上的某个方法来获取有关特定对象的信息。

trackedAnchors 只读 实验性

包含该帧中所有仍在跟踪的锚点的XRAnchorSet

实例方法

createAnchor() 实验性

返回一个Promise,该Promise解析为一个自由浮动的XRAnchor对象。

fillJointRadii() 实验性

使用一组手关节空间的半径填充Float32Array。如果所有空间都成功,则返回true

fillPoses() 实验性

使用相对于给定基准空间的姿势矩阵填充Float32Array。如果所有空间都有一个有效的姿势,则返回true

getDepthInformation() 实验性

返回一个XRCPUDepthInformation对象,该对象包含帧的 CPU 深度信息。

getHitTestResults() 实验性

返回一个XRHitTestResult对象数组,其中包含给定XRHitTestSource的命中测试结果。

getHitTestResultsForTransientInput() 实验性

返回一个XRTransientInputHitTestResult对象数组,其中包含给定XRTransientInputHitTestSource的命中测试结果。

getJointPose() 实验性

返回一个XRJointPose对象,该对象提供相对于给定基准空间的手关节(见XRHand)的姿势。

getLightEstimate() 实验性

返回一个XRLightEstimate对象,该对象包含XRLightProbe的估计光照值。

getPose() 实验性

返回一个表示两个指定 XRSpace 对象之间空间关系的 XRPose 对象。

getViewerPose() 实验性

返回一个 XRViewerPose 对象,描述查看器在给定 XRReferenceSpace 中的位置和方向。

规范

规范
WebXR 设备 API
# xrframe-interface

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅