VRDisplayEvent: reason-Eigenschaft

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Nicht standardisiert: Diese Funktion ist nicht standardisiert und befindet sich nicht auf dem Weg zur Standardisierung. Verwenden Sie sie nicht auf Produktionsseiten, die dem Web ausgesetzt sind: Sie funktioniert nicht für alle Benutzer. Es kann auch 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