WebVR API

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

WebVR обеспечивает поддержку для использования устройств виртуальной реальности — например, шлемы виртуальной реальности, таких как Oculus Rift или HTC Vive — для веб-приложений, позволяя разработчикам передавать информацию о местоположении и движения с дисплея в движение вокруг 3D-сцены. Это имеет множество интересных приложений, от виртуальных туров продукта и интерактивных обучающих приложений до захватывающих игр от первого лица.

Концепция и использование

Любые VR-устройства, подключённые к вашему компьютеру, будут возвращены методом Navigator.getVRDisplays(); каждое из которых будет представлено VRDisplay объектом.

Sketch of a person in a chair with wearing goggles labelled "Head mounted display (HMD)" facing a monitor with a webcam labelled "Position sensor"

VRDisplay является центральным интерфейсом в API WebVR - с помощью его свойств и методов вы получить доступ к функциям:

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

Типичное (простое) WebVR приложение будет работать так:

Navigator.getVRDisplays() используется для получения ссылки на ваш VR-дисплей.
VRDisplay.requestPresent() используется для начала представления на дисплей VR.
Выделенный VRDisplay.requestAnimationFrame() WebVR's используется для запуска цикла рендеринга приложения с правильной частотой обновления для отображения.
Внутри цикла рендеринга берутся данные, необходимые для отображения текущего кадра (VRDisplay.getFrameData()), дважды нарисуйте отображаемую сцену - один раз для просмотра в каждом глазу, затем отправьте отображаемый вид на дисплей, чтобы показать пользователю (VRDisplay.submitFrame()).

Кроме того, WebVR 1.1 добавляет ряд событий Window объекту, чтобы JavaScript мог реагировать на изменения состояния дисплея.

Примечание: Вы можете найти намного больше о том, как работает API в Using the WebVR API и WebVR Concepts статьях.

Использование контроллеров: Объединение WebVR с API-интерфейсом геймпада

Многие аппаратные настройки WebVR оснащены контроллерами, которые сочетаются с гарнитурой. Они могут быть использованы в WebVR приложениях через Gamepad API, и, в частности, Gamepad расширения API, которые добавляют API функции для доступа к позе контроллера, haptic actuators, и многое другое.

Примечание: Наша Using VR controllers with WebVR статья объясняет основы использования VR-контроллеров в приложениях WebVR.

WebVR Интерфейс

VRDisplay: Представляет любое устройство VR, поддерживаемое этим API. VRDisplay включает в себя общую информацию, такую как идентификаторы устройств и описания, а также методы для начала представления сцены VR, получения параметров глаз и возможностей отображения и других важных функций.
VRDisplayCapabilities: описывает возможности VRDisplay — его функции могут использоваться для тестирования возможностей устройства VR, например, может ли он возвращать информацию о местоположении.
VRDisplayEvent: Возвращает объект события (event) связанного с WebVR-событием (см. window object extensions , перечисленных ниже).
VRFrameData: Представляет всю информацию, необходимую для создания одного кадра сцены VR; созданный от VRDisplay.getFrameData().
VRPose: Представляет состояние позиции на заданной временной отметке (которая включает в себя ориентацию, положение, скорость и ускорение).
VREyeParameters: Предоставляет доступ ко все информации, необходимой для корректного отображения сцены для каждого заднего глаза, включая информацию о поле зрения.
VRFieldOfView: Представляет поле зрения, определённое четырьмя различными значениями степени, описывающими представление из центральной точки.
VRLayerInit: Представляет слой, который должен быть представлен в VRDisplay.
VRStageParameters: Представляет значения, описывающие область сцены для устройств, поддерживающих опыт в помещении.

Расширения для других интерфейсов

WebVR API расширяет следующие API, добавляя перечисленные функции.

Геймпад

Gamepad.displayId Только для чтения: Возвращает VRDisplay.displayId связанного с VRDisplay — VRDisplay , которым геймпад управляет отображаемой сценой.

Навигатор

Navigator.activeVRDisplays Только для чтения: Возвращает массив, содержащий каждый VRDisplay объект, который в настоящее время отображается (VRDisplay.ispresenting является true).
Navigator.getVRDisplays(): Возвращает промис, который преобразуется в массив VRDisplay объектов, представляющих любые доступные VR-дисплеи, подключённые к компьютеру.

Window события

Window.onvrdisplaypresentchange: Представляет обработчик событий, который будет выполняться, при изменении состояния отображения VR-дисплея — т.е. идёт от отображения до неотображения, или наоборот (когда vrdisplaypresentchange событие срабатывает).
Window.onvrdisplayconnect: Представляет обработчик событий, который будет запускаться, когда к компьютеру подключён совместимый VR-дисплей (когда vrdisplayconnect событие срабатывает).
Window.onvrdisplaydisconnect: Представляет обработчик событий, который будет запускаться, когда совместимый VR-дисплей был отключён от компьютера (когда vrdisplaydisconnect событие срабатывает).
Window.onvrdisplayactivate: Представляет обработчик событий, который будет выполняться, когда дисплей может быть представлен (когда vrdisplayactivateсобытие срабатывает), например, HMD (Head Mounted Display) был перемещён, чтобы вывести его из режима ожидания, или проснулся, будучи перемещённым.
Window.onvrdisplaydeactivate: Представляет обработчик событий, который будет запускаться, когда дисплей больше не будет отображаться (когда vrdisplaydeactivate событие срабатывает), например, HMD (Head Mounted Display) перешёл в режим ожидания или спящий режим из-за периода бездействия.

Невыполненные window события

Следующие события перечислены в спецификации, but do not currently seem to be implemented anywhere as yet.

Window.onvrdisplayblur: Представляет обработчик событий, который будет выполняться, когда презентация на дисплей была приостановлена по какой-то причине в браузере, ОС или оборудованием VR (когда vrdisplayblur событие срабатывает) — например, в то время как пользователь взаимодействует с системным меню или браузером, чтобы предотвратить отслеживание или потерю опыта.
Window.onvrdisplayfocus: Представляет обработчик событий, который будет выполняться, когда презентация на дисплей возобновляется после потери фокуса (когда vrdisplayfocus событие срабатывает).

Примеры

Вы можете найти несколько примеров в этих местах:

webvr-tests — очень простые примеры для сопровождения MDM WebVR документации.
Carmel starter kit — простые, хорошо прокомментированные примеры, которые идут вместе с Carmel,браузером WebVR от Facebook's .
WebVR.info samples — несколько более подробных примеров плюс исходный код
WebVR.rocks Firefox demos — демонстрация примеров
A-Frame homepage — примеры использования A-Frame

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

BCD tables only load in the browser

Смотрите также

vr.mozilla.org — Основная посадочная площадка Mozilla для WebVR с демонстрационными материалами, утилитами и другой информацией.
A-Frame — Веб-платформа с открытым исходным кодом для создания опыта VR.
webvr.info — Актуальная информация о WebVR, настройке браузера и сообществе.
threejs-vr-boilerplate — Полезный стартовый шаблон для написания приложений WebVR.
Web VR polyfill — JavaScript-реализация WebVR.