Window: vrdisplayactivate 事件

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

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

WebVR API 的 vrdisplayactivate 事件會在 VR 顯示器能夠呈現內容時觸發,例如,當 HMD 從待機狀態啟用,或戴上後被喚醒時。

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

此事件不可取消,也不會冒泡。

語法

在諸如 addEventListener() 之類的方法中使用事件名稱,或設定事件處理程式屬性。

js
addEventListener("vrdisplayactivate", (event) => { })

onvrdisplayactivate = (event) => { }

事件型別

一個 VRDisplayEvent。繼承自 Event

事件屬性

VRDisplayEvent 還繼承了其父物件 Event 的屬性。

VRDisplayEvent.display 已棄用 只讀

與此事件關聯的 VRDisplay

VRDisplayEvent.reason 已棄用 只讀

觸發事件的原因,人類可讀的描述。

示例

您可以使用 addEventListener 方法中的 vrdisplayactivate 事件

js
window.addEventListener("vrdisplayactivate", () => {
  info.textContent = "Display activated.";
  reportDisplays();
});

或者使用 onvrdisplayactivate 事件處理程式屬性

js
window.onvrdisplayactivate = () => {
  info.textContent = "Display activated.";
  reportDisplays();
};

規範

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

在所有瀏覽器都實現了新的 WebXR Device API 之前,建議依賴 A-FrameBabylon.jsThree.js 等框架,或使用 polyfill 來開發可跨瀏覽器工作的 WebXR 應用程式。有關更多資訊,請閱讀 Meta 的 WebVR 遷移到 WebXR 指南

瀏覽器相容性

另見