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

瀏覽器相容性