VRDisplayEvent: reason 屬性

已棄用:此特性不再推薦。雖然某些瀏覽器可能仍然支援它,但它可能已經從相關的網路標準中刪除,可能正在刪除過程中,或者可能僅為相容性目的而保留。請避免使用它,如果可能,請更新現有程式碼;請參閱本頁底部的相容性表格以指導您的決策。請注意,此特性可能隨時停止工作。

非標準:此特性未標準化。我們不建議在生產環境中使用非標準特性,因為它們瀏覽器支援有限,並且可能會更改或被移除。但是,在沒有標準選項的特定情況下,它們可以是合適的替代方案。

VRDisplayEvent 介面的只讀屬性 reason 返回一個人類可讀的原因,說明事件觸發的原因。

注意:此屬性是舊的 WebVR API 的一部分。它已被 WebXR Device API 取代。

一個字串,表示觸發事件的原因。可用原因定義在 VRDisplayEventReason 列舉中,具體如下:

  • mountedVRDisplay 檢測到使用者已佩戴它(或已以其他方式啟用)。
  • navigation — 頁面是從一個允許立即開始展示的上下文中導航而來的,例如從另一個已處於 VR 展示模式的站點。
  • requested — 使用者代理已請求開始 VR 展示模式。這允許使用者代理在不同站點之間提供一致的進入 VR 的 UI。
  • unmountedVRDisplay 檢測到使用者已取下它(或已以其他方式進入睡眠/待機狀態)。

示例

js
window.addEventListener("vrdisplaypresentchange", (e) => {
  console.log(
    `Display ${e.display.displayId} presentation has changed. Reason given: ${e.reason}.`,
  );
});

規範

此屬性是舊的 WebVR API 的一部分,已被 WebXR Device API 取代。它已不再是標準的開發方向。

在所有瀏覽器都實現新的 WebXR API 之前,建議依靠 A-FrameBabylon.jsThree.js 等框架,或 polyfill 來開發可在所有瀏覽器上執行的 WebXR 應用程式。有關更多資訊,請閱讀 Meta 的從 WebVR 移植到 WebXR 指南。

瀏覽器相容性

另見