VRDisplayCapabilities

Устаревшее: Эта функция больше не рекомендуется. Хотя некоторые браузеры могут её всё ещё поддерживать, она может быть удалена из соответствующих веб-стандартов, находится в процессе удаления или поддерживается только для совместимости. Избегайте её использования и, при возможности, обновите существующий код; обратитесь к таблице совместимости внизу этой страницы для принятия решения. Имейте в виду, что эта функция может перестать работать в любой момент.

Нестандартная: Эта функция нестандартна и не входит в список стандартов. Не используйте её на производственных сайтах, обращённых к сети: она не будет работать для каждого пользователя. Также могут существовать значительные несовместимости между реализациями, и поведение может измениться в будущем.

Интерфейс VRDisplayCapabilities API WebVR описывает возможности VRDisplay — его возможности могут использоваться для проверки возможностей устройств VR, например, может ли он возвращать информацию о позиции.

Примечание: Этот интерфейс был частью старого API WebVR. Он был заменён API устройств WebXR.

К этому интерфейсу можно получить доступ через свойство VRDisplay.capabilities.

Свойства экземпляра

VRDisplayCapabilities.canPresent Устаревшее Только для чтения Нестандартное: Возвращает логическое значение, указывающее, может ли устройство VR отображать контент (например, через шлем HMD).
VRDisplayCapabilities.hasExternalDisplay Устаревшее Только для чтения Нестандартное: Возвращает логическое значение, указывающее, отделено ли устройство VR от основного экрана устройства.
VRDisplayCapabilities.hasOrientation Устаревшее Только для чтения Нестандартное: Возвращает логическое значение, указывающее, может ли устройство VR отслеживать и возвращать информацию об ориентации.
VRDisplayCapabilities.hasPosition Устаревшее Только для чтения Нестандартное: Возвращает логическое значение, указывающее, может ли устройство VR отслеживать и возвращать информацию о позиции.
VRDisplayCapabilities.maxLayers Устаревшее Только для чтения Нестандартное: Возвращает число, указывающее максимальное количество VRLayerInit, которые может одновременно отображать устройство VR (например, максимальная длина массива, который может принять VRDisplay.requestPresent()).

Примеры

function reportDisplays() {
  navigator.getVRDisplays().then((displays) => {
    displays.forEach((display, i) => {
      const cap = display.capabilities;
      // cap is a VRDisplayCapabilities object
      const listItem = document.createElement("li");
      listItem.innerText = `
VR Display ID: ${display.displayId}
VR Display Name: ${display.displayName}
Display can present content: ${cap.canPresent}
Display is separate from the computer's main display: ${cap.hasExternalDisplay}
Display can return position info: ${cap.hasPosition}
Display can return orientation info: ${cap.hasOrientation}
Display max layers: ${cap.maxLayers}`;
      listItem.insertBefore(
        document.createElement("strong"),
        listItem.firstChild,
      ).textContent = `Display ${i + 1}`;
      list.appendChild(listItem);
    });
  });
}

Спецификации

Этот интерфейс был частью старого API WebVR, который был заменён API устройств WebXR. Он больше не рассматривается как стандарт.

До тех пор, пока все браузеры не реализуют новые API WebXR, рекомендуется полагаться на фреймворки, такие как A-Frame, Babylon.js или Three.js, или полифил для разработки приложений WebXR, которые будут работать во всех браузерах. Обратитесь к руководству Meta's Porting from WebVR to WebXR для получения дополнительной информации.

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`VRDisplayCapabilities`	Нет	15–79	98 64–98 Поддержка macOS была включена в Firefox 64. 55–98 Поддержка Windows была включена в Firefox 55.	Нет	Нет	Нет	55–98	Нет	Нет	6.0 Google Cardboard поддерживается в Samsung Internet 7.0.	Нет
`canPresent`	Нет	15–79	98 64–98 Поддержка macOS была включена в Firefox 64. 55–98 Поддержка Windows была включена в Firefox 55.	Нет	Нет	Нет	55–98	Нет	Нет	6.0 Google Cardboard поддерживается в Samsung Internet 7.0.	Нет
`hasExternalDisplay`	Нет	15–79	98 64–98 Поддержка macOS была включена в Firefox 64. 55–98 Поддержка Windows была включена в Firefox 55.	Нет	Нет	Нет	55–98	Нет	Нет	6.0 Google Cardboard поддерживается в Samsung Internet 7.0.	Нет
`hasOrientation`	Нет	15–79	98 64–98 Поддержка macOS была включена в Firefox 64. 55–98 Поддержка Windows была включена в Firefox 55.	Нет	Нет	Нет	55–98	Нет	Нет	6.0 Google Cardboard поддерживается в Samsung Internet 7.0.	Нет
`hasPosition`	Нет	15–79	98 64–98 Поддержка macOS была включена в Firefox 64. 55–98 Поддержка Windows была включена в Firefox 55.	Нет	Нет	Нет	55–98	Нет	Нет	6.0 Google Cardboard поддерживается в Samsung Internet 7.0.	Нет
`maxLayers`	Нет	15–79	98 64–98 Поддержка macOS была включена в Firefox 64. 55–98 Поддержка Windows была включена в Firefox 55.	Нет	Нет	Нет	55–98	Нет	Нет	6.0 Google Cardboard поддерживается в Samsung Internet 7.0.	Нет

См. также

API WebVR

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/VRDisplayCapabilities