XRFrame: getViewerPose() 方法

可用性有限

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

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

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

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

有关计算表示两个空间之间差异的姿势的方法,请参阅 getPose() 方法。

语法

js
getViewerPose(referenceSpace)

参数

referenceSpace

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

返回值

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

异常

InvalidStateError DOMException

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

示例

在此用于 requestAnimationFrame() 的回调函数中,通过调用传递到回调函数中的 XRFrame 上的 getViewerPose() 来获取描述查看器在世界中的视角的 XRViewerPose

js
viewerPose = xrFrame.getViewerPose(xrReferenceSpace);

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

要查看完整示例,请参阅 Movement, orientation, and motion

规范

规范
WebXR Device API
# dom-xrframe-getviewerpose

浏览器兼容性