VRDisplayEvent: reason-Eigenschaft

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.

Kein Standard: Diese Funktion ist nicht standardisiert und befindet sich nicht im Standardisierungsprozess. Verwenden Sie sie nicht auf Produktionsseiten, die auf das Web ausgerichtet sind: Sie wird nicht für alle Benutzer funktionieren. Außerdem kann es große Inkompatibilitäten zwischen Implementierungen geben und das Verhalten kann sich in Zukunft ändern.

Die reason schreibgeschützte Eigenschaft der VRDisplayEvent-Schnittstelle gibt einen menschenlesbaren Grund an, warum das Ereignis ausgelöst wurde.

Hinweis: Diese Eigenschaft war Teil der alten WebVR API. Sie wurde durch die WebXR Device API ersetzt.

Wert

Ein String, der den Grund angibt, warum das Ereignis ausgelöst wurde. Die verfügbaren Gründe sind im VRDisplayEventReason-Enum definiert und lauten wie folgt:

  • mounted — Das VRDisplay hat erkannt, dass der Benutzer es aufgesetzt hat (oder es anderweitig aktiviert wurde).
  • navigation — Die Seite wurde von einem Kontext aus aufgerufen, der es dieser Seite erlaubt, sofort mit der Präsentation zu beginnen, z. B. von einer anderen Seite, die bereits im VR-Präsentationsmodus war.
  • requested — Der Benutzeragent hat angefragt, dass der VR-Präsentationsmodus gestartet wird. Dies ermöglicht es den Benutzeragenten, eine einheitliche Benutzeroberfläche zum Betreten von VR über verschiedene Seiten hinweg bereitzustellen.
  • unmounted — Das VRDisplay hat erkannt, dass der Benutzer es abgenommen hat (oder es anderweitig in den Ruhemodus/Standby versetzt wurde).

Beispiele

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

Spezifikationen

Diese Eigenschaft war Teil der alten WebVR API, die durch die WebXR Device API ersetzt wurde. Sie wird nicht mehr als Standard weiterverfolgt.

Bis alle Browser die neuen WebXR APIs implementiert haben, wird empfohlen, sich auf Frameworks wie A-Frame, Babylon.js oder Three.js zu verlassen oder ein Polyfill zu nutzen, um WebXR-Anwendungen zu entwickeln, die in allen Browsern funktionieren. Lesen Sie den Leitfaden von Meta zur Portierung von WebVR zu WebXR für weitere Informationen.

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch