WebVR API

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

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

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

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

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

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

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

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

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

WebVR Интерфейс

Представляет любое устройство VR, поддерживаемое этим API. VRDisplay включает в себя общую информацию, такую как идентификаторы устройств и описания, а также методы для начала представления сцены VR, получения параметров глаз и возможностей отображения и других важных функций.

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

Возвращает объект события (event) связанного с WebVR-событием (см. window object extensions , перечисленных ниже).

Представляет всю информацию, необходимую для создания одного кадра сцены VR; созданный от VRDisplay.getFrameData().

Представляет состояние позиции на заданной временной отметке (которая включает в себя ориентацию, положение, скорость и ускорение).

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

Представляет поле зрения, определённое четырьмя различными значениями степени, описывающими представление из центральной точки.

Представляет слой, который должен быть представлен в VRDisplay.

Представляет значения, описывающие область сцены для устройств, поддерживающих опыт в помещении.

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

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

Геймпад

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

Навигатор

Возвращает массив, содержащий каждый VRDisplay объект, который в настоящее время отображается (VRDisplay.ispresenting является true).

Возвращает промис, который преобразуется в массив VRDisplay объектов, представляющих любые доступные VR-дисплеи, подключённые к компьютеру.

Window события

Представляет обработчик событий, который будет выполняться, при изменении состояния отображения VR-дисплея — т.е. идёт от отображения до неотображения, или наоборот (когда vrdisplaypresentchange событие срабатывает).

Представляет обработчик событий, который будет запускаться, когда к компьютеру подключён совместимый VR-дисплей (когда vrdisplayconnect событие срабатывает).

Представляет обработчик событий, который будет запускаться, когда совместимый VR-дисплей был отключён от компьютера (когда vrdisplaydisconnect событие срабатывает).

Представляет обработчик событий, который будет выполняться, когда дисплей может быть представлен (когда vrdisplayactivateсобытие срабатывает), например, HMD (Head Mounted Display) был перемещён, чтобы вывести его из режима ожидания, или проснулся, будучи перемещённым.

Представляет обработчик событий, который будет запускаться, когда дисплей больше не будет отображаться (когда vrdisplaydeactivate событие срабатывает), например, HMD (Head Mounted Display) перешёл в режим ожидания или спящий режим из-за периода бездействия.

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

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

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

Представляет обработчик событий, который будет выполняться, когда презентация на дисплей возобновляется после потери фокуса (когда vrdisplayfocus событие срабатывает).

Примеры

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

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

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

Enable JavaScript to view this browser compatibility table.

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

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