XRSession: end-Ereignis
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
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 für ein XRSession-Objekt ausgelöst, wenn die WebXR-Sitzung beendet wurde – entweder weil die Webanwendung die Sitzung beendet hat oder weil der User Agent sie beendet hat.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("end", (event) => { })
Alternativ können Sie einen Handler der Event-Handler-Eigenschaft der Schnittstelle zuweisen:
onend = (event) => { }
Ereignistyp
Ein XRSessionEvent. Erbt von Event.
Beschreibung
Auslöser
Wird ausgelöst, wenn die WebXR-Sitzung beendet wurde – entweder weil die Webanwendung die Sitzung beendet hat oder weil der User Agent sie beendet hat.
Dieses Ereignis kann nicht abgebrochen werden und durchläuft die Ereigniskette nicht nach oben.
Anwendungsfälle
Sie können dieses Ereignis verwenden, um auf das Ende einer WebXR-Sitzung zu reagieren. Beispielsweise können Sie ein UI-Element anzeigen, das über die Beendigung der Sitzung informiert.
Beispiele
Um benachrichtigt zu werden, wenn eine WebXR-Sitzung endet, können Sie Ihrer XRSession-Instanz mit addEventListener() einen Handler hinzufügen:
xrSession.addEventListener("end", (event) => {
/* the session has shut down */
});
Alternativ können Sie über die Event-Handler-Eigenschaft xrSession.onend einen Handler für das end-Ereignis festlegen. Beachten Sie jedoch, dass dadurch gegebenenfalls andere über onend hinzugefügte Event-Listener ersetzt werden:
xrSession.onend = (event) => {
/* the session has shut down */
};
Spezifikationen
| Spezifikation |
|---|
| WebXR Device API # eventdef-xrsession-end |
| WebXR Device API # dom-xrsession-onend |