XRFrame：getViewerPose() 方法

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

安全上下文：此功能仅在 安全上下文（HTTPS）中可用，并且在某些或所有 支持的浏览器中可用。

getViewerPose() 方法是 XRFrame 接口的成员，它返回一个 XRViewerPose 对象，该对象描述了查看器姿势（位置和方向）相对于指定参考空间的状态。

请参阅 getPose() 方法，了解如何计算表示两个空间之间差异的姿势。

语法

js
getViewerPose(referenceSpace)

参数

referenceSpace

一个 XRReferenceSpace 对象，指定用作参考点或基准，用于计算查看器当前姿势的空间。

返回值

一个 XRViewerPose，描述查看器相对于指定参考空间的位置和方向。

异常

InvalidStateError DOMException

如果 getViewerPose() 不是在会话的 XRSession.requestAnimationFrame() 回调函数的上下文中调用的，则抛出此异常。

示例

在此 requestAnimationFrame() 的回调函数中，描述查看器在世界中的视点的 XRViewerPose 通过在传递给回调函数的 XRFrame 上调用 getViewerPose() 来获取。

js
viewerPose = xrFrame.getViewerPose(xrReferenceSpace);

if (viewerPose) {
  /* render the pose's views */
}

要查看完整的示例，请查看 移动、方向和运动。

规范

规范
WebXR 设备 API
# dom-xrframe-getviewerpose

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。