XRSystem: метод isSessionSupported()

Метод XRSystem isSessionSupported() возвращает промис, который выполняется успешно с результатом true, если указанный режим сессии WebXR поддерживается устройством WebXR пользователя. В противном случае промис выполняется успешно с результатом false.

Если устройства недоступны или браузер не имеет разрешения на использование устройства XR, промис отклоняется с соответствующей ошибкой DOMException.

mode

Строка String, указывающая режим сессии WebXR, для которого необходимо проверить поддержку. Возможные режимы:

• immersive-ar Экспериментально
• immersive-vr
• inline

Промис Promise, который выполняется успешно с результатом true, если указанный режим сессии поддерживается; в противном случае промис выполняется успешно с результатом false.

Вместо бросания исключений, isSessionSupported() отклоняет возвращенный промис, передавая обработчику отклонения объект DOMException, значение свойства name которого является одной из следующих строк.

SecurityError

Использование этой функции заблокировано политикой политики разрешений.

В этом примере мы используем isSessionSupported() для проверки поддержки VR-режима на устройстве, проверяя поддержку сессии immersive-vr. Если она поддерживается, мы создаем кнопку с текстом "Ввести XR", вызываем метод onButtonClicked(), и активируем кнопку.

Если сессия еще не запущена, мы запрашиваем VR-сессию. При успешном выполнении мы настраиваем сессию в методе onSessionStarted(), который не показан. Если сессия уже запущена при нажатии на кнопку, мы вызываем метод end() объекта xrSession для завершения сессии WebXR.

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();
  }
}