XRSystem: событие devicechange

Событие devicechange срабатывает на объекте XRSystem, когда изменяется доступность устройств XR; например, когда гарнитура виртуальной реальности или очки дополненной реальности подключены или отключены. Это общее Event без дополнительных свойств.

Используйте имя события в методах, таких как addEventListener(), или задайте обработчик событий.

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

ondevicechange = (event) => {};

Если использование WebXR было заблокировано политикой xr-spatial-tracking разрешений, события devicechange не будут срабатывать.

Общее Event без дополнительных свойств.

Срабатывает при изменении доступности устройств XR. Например, когда гарнитура VR или очки AR подключаются или отключаются.

Это событие можно использовать для мониторинга доступности устройства, совместимого с WebXR, чтобы включить элемент пользовательского интерфейса, который пользователь может использовать для активации интерактивного режима. Пример показан ниже.

В приведенном примере событие devicechange обрабатывается путем переключения доступности кнопки "Войти в XR" в зависимости от того, доступны ли в данный момент какие-либо устройства.

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

При получении события devicechange обработчик вызывает метод XR isSessionSupported(), чтобы узнать, доступно ли устройство, способное обрабатывать интерактивные VR-презентации. Если да, то кнопка для входа в XR режим активируется; в противном случае она деактивируется.

Также можно использовать свойство обработчика событий ondevicechange для задания единого обработчика для событий devicechange:

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