XRSystem: isSessionSupported() Methode

mode

Ein String, der den WebXR-Sessionmodus angibt, für den die Unterstützung überprüft werden soll. Mögliche Modi, die überprüft werden können:

• immersive-ar Experimentell
• immersive-vr
• inline

Ein Promise, das zu true aufgelöst wird, wenn der angegebene Sessionmodus unterstützt wird; andernfalls wird das Promise zu false aufgelöst.

Anstatt echte Ausnahmen zu werfen, lehnt isSessionSupported() das zurückgegebene Promise ab und übergibt dem Rückruf für die Ablehnung eine DOMException, deren name einer der folgenden Strings ist.

SecurityError

Die Nutzung dieser Funktion wird durch eine xr-spatial-tracking Permissions Policy blockiert.

In diesem Beispiel wird isSessionSupported() verwendet, um zu erkennen, ob das Gerät den VR-Modus unterstützt, indem geprüft wird, ob eine immersive-vr-Session unterstützt wird. Wenn ja, richten wir einen Button ein, der "Enter XR" liest, eine Methode onButtonClicked() aufruft und den Button aktiviert.

Wenn keine Session bereits läuft, fordern wir die VR-Session an und richten sie bei Erfolg in einer Methode namens onSessionStarted() ein, die hier nicht gezeigt wird. Wenn bereits eine Session läuft, wenn der Button geklickt wird, rufen wir die Methode end() des xrSession-Objekts auf, um die WebXR-Session zu beenden.

if (navigator.xr) {
  navigator.xr.isSessionSupported("immersive-vr").then((isSupported) => {
    if (isSupported) {
      userButton.addEventListener("click", onButtonClicked);
      userButton.textContent = "Enter XR";
      userButton.disabled = false;
    }
  });
}

function onButtonClicked() {
  if (!xrSession) {
    navigator.xr.requestSession("immersive-vr").then((session) => {
      xrSession = session;
      // onSessionStarted() not shown for reasons of brevity and clarity.
      onSessionStarted(xrSession);
    });
  } else {
    // Button is a toggle button.
    xrSession.end();
  }
}