XRSession: end event

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 vor der Verwendung auf produktiven Webseiten.

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

Ein end-Ereignis wird bei 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 setzen Sie eine Ereignishandler-Eigenschaft.

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

onend = (event) => { }

Ereignistyp

Ereigniseigenschaften

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

session Schreibgeschützt

Die XRSession, auf die sich das Ereignis bezieht.

Beschreibung

Auslösung

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 löst sich nicht blasenförmig aus.

Anwendungsfälle

Sie können dieses Ereignis verwenden, um auf das Ende einer WebXR-Sitzung zu reagieren. Sie könnten beispielsweise 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 hinzufügen, indem Sie addEventListener() verwenden, wie hier gezeigt:

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

Alternativ können Sie die XRSession.onend Ereignishandler-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