Window: vrdisplayactivate-Ereignis
Deprecated
Avoid using this feature in new projects. Development of the WebVR API halted in favor of WebXR. This feature may be a candidate for removal from web standards or browsers.
Consider using the following features instead: WebXR.
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.
Das vrdisplayactivate-Ereignis der WebVR API wird ausgelöst, wenn Inhalte auf einem VR-Display dargestellt werden können, beispielsweise wenn ein HMD bewegt wurde und dadurch den Standby-Modus verlässt oder wenn es durch Aufsetzen aktiviert wurde.
Hinweis: Dieses Ereignis war Teil der alten WebVR API. Diese wurde durch die WebXR Device API ersetzt.
Dieses Ereignis kann nicht abgebrochen werden und steigt nicht im DOM-Baum auf.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("vrdisplayactivate", (event) => { })
Alternativ können Sie ihn der Ereignisbehandlungs-Eigenschaft der Schnittstelle zuweisen:
onvrdisplayactivate = (event) => { }
Ereignistyp
Ein VRDisplayEvent. Erbt von Event.
Beispiele
Sie können das vrdisplayactivate-Ereignis mit der Methode addEventListener verwenden:
window.addEventListener("vrdisplayactivate", () => {
info.textContent = "Display activated.";
reportDisplays();
});
Oder verwenden Sie die Ereignisbehandlungs-Eigenschaft onvrdisplayactivate. Beachten Sie jedoch, dass dadurch gegebenenfalls andere über onvrdisplayactivate hinzugefügte Ereignis-Listener ersetzt werden:
window.onvrdisplayactivate = () => {
info.textContent = "Display activated.";
reportDisplays();
};
Spezifikationen
Dieses Ereignis war Teil der alten WebVR API, die durch die WebXR Device API ersetzt wurde. Es wird nicht mehr als Standard weiterentwickelt.
Bis alle Browser die neue WebXR Device API implementiert haben, empfiehlt es sich, für die Entwicklung browserübergreifend funktionierender WebXR-Anwendungen Frameworks wie A-Frame, Babylon.js oder Three.js oder einen Polyfill zu verwenden. Weitere Informationen finden Sie in Metas Leitfaden zur Migration von WebVR zu WebXR.