XRReferenceSpaceEvent: transform 屬性

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

只讀的 XRReferenceSpaceEvent 屬性 transform 指示了受影響的 referenceSpace 在應用事件所代表的更改後,其本地原點的位置和方向。transform 是使用舊座標系定義的,這使得它可以用來將座標從事件發生前的座標系轉換為事件發生後的座標系。

一個 XRRigidTransform 物件,提供了一個可以用來將座標從事件發生前的座標系轉換為事件發生後坐標系的變換。

用法說明

收到 reset 事件後,您可以將 transform 應用於快取的位置或方向資訊,將其移至更新後的座標系。或者,您可以直接丟棄任何快取的位置資訊並從頭重新計算。您採取的方法將取決於您的需求。

有關導致 reset 事件的原因以及如何響應的詳細資訊,請參閱 reset 事件的文件。

示例

此示例透過遍歷場景中的所有物件來處理 reset 事件,透過將每個物件的當前位置乘以事件給出的 transform 來更新每個物件的位置。場景由一個 scene 物件表示,場景中的所有物件都位於該物件內的名為 objects 的陣列中。

js
xrReferenceSpace.addEventListener("reset", (event) => {
  for (const obj of scene.objects) {
    mat4.multiply(obj.transform, obj.transform, event.transform);
  }
});

規範

規範
WebXR Device API
# dom-xrreferencespaceevent-transform

瀏覽器相容性