XRSystem: devicechange-Ereignis

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

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

ondevicechange = (event) => {};

Wenn die Nutzung von WebXR durch eine xr-spatial-tracking Permissions Policy blockiert wurde, werden devicechange-Ereignisse nicht ausgelöst.

Ein generisches Event ohne zusätzliche Eigenschaften.

Wird ausgelöst, wenn sich die Verfügbarkeit von immersiven XR-Geräten geändert hat. Zum Beispiel, wenn ein VR-Headset oder AR-Brille verbunden oder getrennt wurde.

Sie können dieses Ereignis nutzen, um beispielsweise die Verfügbarkeit eines WebXR-kompatiblen Geräts zu überwachen, damit Sie ein UI-Element aktivieren können, das der Benutzer verwenden kann, um den immersiven Modus zu aktivieren. Dies wird im Beispiel unten gezeigt.

Das hier gezeigte Beispiel behandelt das devicechange-Ereignis, indem es basierend auf der Verfügbarkeit von immersiven Geräten die Verfügbarkeit der "Enter XR"-Schaltfläche umschaltet.

if (navigator.xr) {
  navigator.xr.addEventListener("devicechange", (event) => {
    navigator.xr.isSessionSupported("immersive-vr").then((immersiveOK) => {
      enableXRButton.disabled = !immersiveOK;
    });
  });
}

Wenn devicechange empfangen wird, ruft der in diesem Code eingerichtete Handler die XR-Methode isSessionSupported() auf, um festzustellen, ob ein Gerät verfügbar ist, das immersive VR-Präsentationen handhaben kann. Wenn ja, wird der Button, um den XR-Modus zu betreten, aktiviert; andernfalls wird er deaktiviert.

Sie können auch die ondevicechange-Event-Handler-Eigenschaft verwenden, um einen einzigen Handler für devicechange-Ereignisse festzulegen:

if (navigator.xr) {
  navigator.xr.ondevicechange = (event) => {
    // …
  };
}