XRSessionEvent

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die XRSessionEvent Schnittstelle der WebXR Device API beschreibt ein Ereignis, das eine Zustandsänderung einer XRSession anzeigt. Diese Ereignisse treten beispielsweise auf, wenn die Sitzung endet oder sich die Sichtbarkeit ihres Kontextes ändert.

Event XRSessionEvent

Konstruktor

XRSessionEvent()

Erstellt und gibt ein neues XRSessionEvent-Objekt zurück.

Instanz-Eigenschaften

Zusätzlich zu den von der übergeordneten Schnittstelle Event geerbten Eigenschaften bietet XRSessionEvent folgende:

session Schreibgeschützt

Die XRSession, auf die sich das Ereignis bezieht.

Instanz-Methoden

Obwohl XRSessionEvent keine Methoden definiert, erbt es Methoden von seiner übergeordneten Schnittstelle Event.

Sitzungsereignistypen

Folgende Ereignisse werden über die XRSessionEvent Schnittstelle dargestellt und sind zulässige Werte für die Eigenschaft type.

end

Wird bei der Sitzung ausgelöst, wenn diese beendet wurde, nachdem sie von der Anwendung oder dem User-Agent beendet wurde.

visibilitychange

Wird bei der Sitzung ausgelöst, wann immer sich der Sichtbarkeitsstatus ändert.

Beispiele

Dieses Beispiel erstellt einen Listener, der beobachtet, wann sich der Sichtbarkeitsstatus der Sitzung ändert. Er reagiert, indem er eine Funktion mySessionVisible() aufruft, die ein Boolean erhält, das angibt, ob die Sitzung sichtbar ist oder nicht; diese Funktion könnte beispielsweise einen Worker starten oder umkonfigurieren, der für das Rendern der Szene verantwortlich ist.

js
xrSession.addEventListener("visibilitychange", (e) => {
  switch (e.session.visibilityState) {
    case "visible":
    case "visible-blurred":
      mySessionVisible(true);
      break;
    case "hidden":
      mySessionVisible(false);
      break;
  }
});

Spezifikationen

Specification
WebXR Device API
# xrsessionevent-interface

Browser-Kompatibilität

BCD tables only load in the browser