Пазлы виртуальной и дополненной реальности
Эти пазлы используются для создания приложений дополненной реальности (ДР) и виртуальной реальности (ВР), работающих с использованием технологии ВебИксЭр.

Для получения дополнительной информации о поддерживаемых устройствах виртуальной реальности и работе с данными пазлами смотрите соответствующий раздел данного руководства пользователя.
Содержание
Перечень пазлов
check VR mode
Проверяет систему виртуальной реальности. В случае успеха запускаются пазлы в слоте if available do. В противном случае, если браузер не поддерживает ВР или оборудование ВР не найдено, запускаются пазлы в слоте if unavailable do.

enter VR mode
Входит в режим виртуальной реальности. Пазлы, размещенные в слотах on enter do и on exit do, срабатывают при входе или выходе из режима ВР. Пазлы, размещенные в слоте если недоступен, срабатывают, если сеанс ВР не удалось установить.
Режимы позиционирования ВР:
- sitting or standing
- неподвижная камера, расположенная на некоторой высоте над землей.
- room
- мобильная камера, расположенная внутри определенных границ, например, комнаты (например, для «Эйч Ти Си Вайв», «Окулус Квест»).
- looking around
- неподвижная камера, расположенная в нулевых координатах.
- walking
- мобильная камера без ограничений.
- viewer locked
- неподвижная камера, расположенная в нулевых координатах. Все содержимое является родительским для вида.
Числовой параметр hover to click after обозначает период времени (в секундах), в течение которого объект, над которым наведен прицел ВР, будет получать событие щелчка мыши. Значение по умолчанию Infinity означает отсутствие преобразования наведения в щелчок.

Чтобы правильно управлять камерой в режиме ВР, при входе в режим ВР обязательно привяжите ее к какому-либо пустому или реальному объекту, расположенному в выбранном вами 3Д-редакторе. Это необходимо потому, что в ВР-сессии камера полностью контролируется, а вы можете перемещать только пустой объект, к которому привязана камера.

end VR session
Завершает сеанс виртуальной реальности.

check AR mode
Проверяет систему дополненной реальности. В случае успеха запускаются пазлы в слоте if available do. В противном случае, если браузер не поддерживает ДР или оборудование ДР не найдено, срабатывают пазлы в слоте if unavailable do.

enter AR mode
Входит в режим дополненной реальности. Пазлы, размещенные в слотах on enter do и on exit do, срабатывают при входе или выходе из режима ДР. Пазлы, размещенные в слоте if unavailable do, срабатывают, если не удалось установить сеанс ДР.
Свойство allow HTML используется для отображения ХТМЛ-контента в режиме ДР. Если указано, содержимое элемента canvas container будет отображаться поверх 3Д-контента. Этот параметр считается экспериментальным.
Режимы позиционирования ДР:
- sitting or standing
- неподвижная камера, расположенная на некоторой высоте над землей.
- room
- мобильная камера, расположенная внутри некоторых границ, таких как комната.
- looking around
- неподвижная камера, расположенная в нулевых координатах.
- walking
- мобильная камера без ограничений.
- viewer locked
- неподвижная камера, расположенная в нулевых координатах. Все содержимое является родительским для вида.

detect surface AR
Обнаружение горизонтальных поверхностей в режиме дополненной реальности путем направления луча вперед. При пересечении этот луч запускает пазлы в слоте on intersection do. Если пересечения не произошло или устройство находится в состоянии «разогрева», срабатывают пазлы в слоте if missed do.
Параметр smooth используется для того, чтобы сделать движение маркера более плавным. Укажите значение 0 для отключения сглаживания, значение, близкое к 1, для максимального сглаживания.

AR hit point
Координаты точки поверхности, обнаруженные с помощью пазла detect surface AR. Могут быть отдельными значениями X, Y, Z или вектором XYZ.

AR hit normal
Координаты нормали к поверхности, обнаруженные с помощью пазла detect surface AR. Могут быть отдельными значениями X, Y, Z или вектором XYZ.

on session event
Захватывает событие сессии ВР, сгенерированное устройством ВР (например, гарнитурой или кнопкой контроллера), и запускает пазлы, указанные в слоте do.

Events:
- select - срабатывает, когда пользователь нажимает и отпускает кнопку основного контроллера.
- selectstart - срабатывает при нажатии пользователем кнопки основного контроллера.
- selectend - срабатывает, когда пользователь отпускает основную кнопку контроллера.
- squeeze - срабатывает, когда пользователь сжимает и разжимает контроллер.
- squeezestart - срабатывает, когда пользователь сжимает контроллер.
- squeezeend - срабатывает, когда пользователь разжимает контроллер.
- connected - срабатывает при подключении контроллера ВР, т.е. при входе в сеанс ВР. Используйте это событие для инициализации любой логики контроллера.
- disconnected - срабатывает при отключении контроллера ВР.
traverse controllers
Переберите все подключенные контроллеры ВР, выполните пазлы, указанные в слоте do.

get controller property
Получите свойство контроллера.

Свойства:
- object - пустой объект, представляющий контроллер.
- ray/reticle - луч контроллера или объект прицела.
- handedness - ориентация контроллера, одна из: "left" (левый контроллер), "right" (правый контроллер), "none" (не указано, вероятно, контроллер, установленный на голове).
- target ray mode - один из: "gaze" (для устройств, типа cardboard), "tracked-pointer" (для обычных ручных контроллеров), "screen" (событие связано с вводом на холсте, в настоящее время не реализовано).
- profiles - список имен профилей контроллеров.
- gamepad index - индекс геймпада контроллера, который может быть передан в пазл get gamepad property для получения дополнительной информации от вашего контроллера, такой как состояние кнопок/осей.
Проблемы с пазлами?
Обращайтесь за помощью на наш форум!