QR-коды в Unreal

Статья
03/21/2023

Если вы не знакомы с QR-кодами, вы можете изучить этот обзор.

Устройство HoloLens 2 способно видеть QR-коды в мировом пространстве с помощью веб-камеры, отрисовывая их в виде голограмм в месте расположения каждого QR-кода в реальном мире. Кроме того, HoloLens 2 может также отрисовывать голограммы в одном и том же месте на нескольких устройствах для общего взаимодействия с несколькими пользователями. Соблюдайте рекомендации по добавлению QR-кодов в приложения:

Тихие зоны
Освещение и фон
Размер, расстояние и угловое положение

Размещая QR-коды в приложении, следует уделять особое внимание особенностям пространственной среды. Более подробные сведения по каждой из этих тем, а также инструкции по скачиванию соответствующего пакета NuGet см. в главном документе с обзором отслеживания QR-кодов.

Внимание!

QR-коды — это единственный тип изображений, отслеживаемый HoloLens без дополнительной настройки. Модуль Unreal UARTrackedImage не поддерживается в HoloLens. Если вам требуется отслеживать собственные изображения, вы можете получать данные с веб-камеры устройства и обрабатывать кадры с нее с помощью сторонней библиотеки распознавания изображений.

Включение обнаружения QR-кодов

Поскольку для обнаружения QR-кодов устройству HoloLens 2 нужно задействовать веб-камеру, необходимо включить эту функцию в параметрах проекта:

Выберите Edit > Project Settings (Правка > Параметры проекта), прокрутите вниз до раздела Platforms (Платформы) и выберите элемент HoloLens.
- Разверните раздел Capabilities (Возможности) и установите флажок Webcam (Веб-камера).  
Необходимо также включить отслеживание QR-кодов, добавив ресурс ARSessionConfig (по умолчанию оно выключено).

4.26
4.25

Если вы используете UE 4.26, мы рекомендуем использовать следующую настройку схемы для добавления небольшой задержки, так как отслеживание QR-кода должно быть инициализировано ПОСЛЕ запуска сеанса дополненной реальности:

Схема функции Toggle ARCapture с задержкой

Настройка отслеживаемого QR-кода

QR-коды выводятся в виде отслеживаемого изображения через систему отслеживания геометрии в дополненной реальности Unreal. Чтобы обеспечить работу этого механизма:

Создайте схему субъекта и добавьте в нее компонент ARTrackableNotify:

AR Trackable Notify для QR-кодов

Выберите компонент ARTrackableNotify и в панели Details (Сведения) разверните раздел Events (События):

События QR-кодов

Щелкните + рядом с пунктом On Add Tracked Geometry (При добавлении отслеживаемой геометрии), чтобы добавить соответствующий узел в граф событий.
- Полный список событий можно найти в API объекта UARTrackableNotify.

Добавление узла в событие On Add Tracked Geometry (При добавлении отслеживаемой геометрии)

Использование отслеживаемого QR-кода

В графе событий, показанном на следующей иллюстрации, событие OnUpdateTrackedImage используется для отрисовки точки в центре QR-кода и печати его данных.

4.26
4.25

Пример отрисовки QR-кода для 4.26

Что происходит:

Сначала отслеживаемое изображение приводится к типу ARTrackedQRCode и проверяется, что текущее обновленное изображение содержит QR-код.
Закодированные данные извлекаются из переменной QRCode. Координаты левого верхнего угла QR-кода можно получить из расположения, возвращаемого функцией GetLocalToWorldTransform, а размеры кода — с помощью функции GetEstimateSize.

Можно также получить систему координат для QR-кода в программном коде.

Поиск уникального идентификатора

Каждый QR-код имеет уникальный идентификатор (GUID), найти который можно следующим образом:

Перетащите закрепление As ARTracked QRCode (Как отслеживаемый QR-код дополненной реальности) и найдите узел Get Unique ID (Получить уникальный идентификатор).

GUID для QR-кода