XRSession: end-Ereignis

Limited availability

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

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

Ein end-Ereignis wird an einem XRSession-Objekt ausgelöst, wenn die WebXR-Sitzung beendet wurde, entweder weil die Webanwendung beschlossen hat, die Sitzung zu beenden, oder weil der User Agent die Sitzung beendet hat.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder legen Sie eine Ereignis-Handler-Eigenschaft fest.

js
addEventListener("end", (event) => {});

onend = (event) => {};

Ereignistyp

Ereigniseigenschaften

Zusätzlich zu den unten aufgeführten Eigenschaften sind Eigenschaften der übergeordneten Schnittstelle Event verfügbar.

session Nur lesbar

Die XRSession, auf die sich das Ereignis bezieht.

Beschreibung

Auslöser

Wird ausgelöst, wenn die WebXR-Sitzung beendet wurde, entweder weil die Webanwendung beschlossen hat, die Sitzung zu beenden, oder weil der User Agent die Sitzung beendet hat.

Dieses Ereignis kann nicht abgebrochen werden und wird nicht weitergeleitet.

Anwendungsfälle

Sie können dieses Ereignis verwenden, um auf das Ende einer WebXR-Sitzung zu reagieren. Möglicherweise möchten Sie ein UI-Element anzeigen, das über die Beendigung der Sitzung informiert.

Beispiele

Um informiert zu werden, wenn eine WebXR-Sitzung endet, können Sie einen Handler zu Ihrer XRSession-Instanz mit addEventListener() hinzufügen, so:

js
XRSession.addEventListener("end", (event) => {
  /* the session has shut down */
});

Alternativ können Sie die XRSession.onend-Ereignis-Handler-Eigenschaft verwenden, um einen Handler für das end-Ereignis festzulegen:

js
XRSession.onend = (event) => {
  /* the session has shut down */
};

Spezifikationen

Specification
WebXR Device API
# eventdef-xrsession-end
WebXR Device API
# dom-xrsession-onend

Browser-Kompatibilität

BCD tables only load in the browser