XRSession: visibilitychange Event
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.
Das visibilitychange-Ereignis wird an eine XRSession gesendet, um sie darüber zu informieren, wann sie sichtbar oder versteckt wird oder wann sie sichtbar, aber nicht aktuell fokussiert ist. Nach Erhalt des Ereignisses können Sie den Wert der visibilityState-Eigenschaft der Sitzung überprüfen, um den neuen Sichtbarkeitszustand zu bestimmen.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("visibilitychange", (event) => { })
onvisibilitychange = (event) => { }
Ereignistyp
Ein XRSessionEvent. Erbt von Event.
Beschreibung
Auslöser
Wird ausgelöst, wenn eine XRSession sichtbar oder versteckt wird, oder wenn sie sichtbar, aber nicht aktuell fokussiert ist.
Wenn die XRSession dieses Ereignis empfängt, wurde der Sichtbarkeitszustand bereits geändert.
Anwendungsfälle
Nach Erhalt des Ereignisses können Sie den Wert der visibilityState-Eigenschaft der Sitzung überprüfen, um den neuen Sichtbarkeitszustand zu bestimmen.
Beispiele
Dieses Beispiel demonstriert, wie man mit addEventListener() auf ein visibilitychange-Ereignis in einer WebXR-Sitzung lauscht, um mit dem Abhören des Ereignisses zu beginnen:
navigator.xr.requestSession("inline").then((xrSession) => {
xrSession.addEventListener("visibilitychange", (e) => {
switch (e.session.visibilityState) {
case "visible":
case "visible-blurred":
mySessionVisible(true);
break;
case "hidden":
mySessionVisible(false);
break;
}
});
});
Wenn eine Änderung des Sichtbarkeitszustands auftritt, wird das Ereignis empfangen und an eine Funktion mySessionVisible() weitergeleitet, mit einem booleschen Parameter, der angibt, ob die Sitzung dem Benutzer derzeit angezeigt wird oder nicht.
Sie können den Ereignis-Handler auch erstellen, indem Sie ihn der onvisibilitychange-Ereignis-Handler-Eigenschaft der XRSession zuweisen, wie folgt:
xrSession.onvisibilitychange = (e) => {
/* event handled here */
};
Spezifikationen
| Spezifikation |
|---|
| WebXR Device API # eventdef-xrsession-visibilitychange |
| WebXR Device API # dom-xrsession-onvisibilitychange |