XRSession: visibilitychange Ereignis

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandlereigenschaft.

addEventListener("visibilitychange", (event) => {});

onvisibilitychange = (event) => {};

Ein XRSessionEvent. Erbt vom Event.

Neben den unten aufgeführten Eigenschaften sind die Eigenschaften der übergeordneten Schnittstelle, Event, verfügbar.

session Schreibgeschützt

Die XRSession, auf die sich das Ereignis bezieht.

Wird ausgelöst, wenn eine XRSession sichtbar oder verborgen wird, oder wenn sie sichtbar, aber derzeit nicht fokussiert ist.

Wenn die XRSession dieses Ereignis empfängt, wurde der Sichtbarkeitszustand bereits geändert.

Beim Erhalt des Ereignisses können Sie den Wert der visibilityState Eigenschaft der Sitzung überprüfen, um den neuen Sichtbarkeitsstatus zu bestimmen.

Dieses Beispiel zeigt, wie man auf ein visibilitychange-Ereignis in einer WebXR-Sitzung hört, indem addEventListener() verwendet wird, um mit dem Lauschen auf das Ereignis 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 Sichtbarkeitsstatus auftritt, wird das Ereignis empfangen und an eine Funktion mySessionVisible() weitergeleitet, mit einem booleschen Parameter, der angibt, ob die Sitzung derzeit dem Benutzer angezeigt wird oder nicht.

Sie können auch den Ereignishandler erstellen, indem Sie ihn der onvisibilitychange-Ereignishandlereigenschaft der XRSession zuordnen, wie folgt:

xrSession.onvisibilitychange = (e) => {
  /* event handled here */
};