Table of Contents

Использование образцов EasyAR на гарнитурах XR или очках

EasyAR предоставляет унифицированные образцы для всех гарнитур, в которых нет кода, всё реализовано через настройки в сценах. Использование функций можно изучить по образцам для Android/iOS смартфонов.

Образцы для гарнитур называются Combination_BasedOn_*, например, образец для Pico — Combination_BasedOn_Pico. Этот образец демонстрирует большинство функций EasyAR в одной сцене, их можно динамически включать/выключать, использовать по отдельности или одновременно.

Подготовительные работы

  • Убедитесь, что ваша гарнитура или очки входят в список поддерживаемых устройств EasyAR
  • Скачайте и импортируйте пакет плагина EasyAR для Unity
  • Скачайте и импортируйте пакет расширений EasyAR для устройств XR в Unity
  • Получите лицензию EasyAR, подходящую для гарнитур XR или очков. Доступные типы лицензий:
    • Пробная версия XR License для EasyAR Sense 4.x (пробная, активируется самостоятельно на сайте EasyAR)
    • Коммерческая версия XR License для EasyAR Sense 4.x (платная, обратитесь в отдел продаж)
    • Корпоративная версия XR License для EasyAR Sense 4.x (для корпоративной версии SDK)
Осторожно

На гарнитурах и очках разрешено использовать только XR License. Обычная лицензия не активирует функции EasyAR.

Импорт официальных образцов

  1. Образцы для встроенных поддерживаемых устройств находятся в пакете плагина EasyAR для Unity. Импортируйте нужный образец для вашего устройства. xr-samples-location

  2. Образцы для устройств, поддерживаемых через расширения, распространяются вместе с соответствующим расширением для гарнитуры. Используйте Unity для импорта образца в проект. Пример для Pico: xr-pico-extension

Сборка и запуск образца

Выполните настройку проекта для гарнитуры и следуйте инструкциям по использованию образца.

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

Образец содержит несколько кнопок с функциями: xr-sample-usage-7

  • Кнопка 1 HUD: переключает режим отображения UI. В исходном состоянии UI зафиксирован в реальном мире, при включении HUD — всегда отображается перед глазами.
  • Кнопка 2 Record: включает/выключает запись EIF. Для записи корректного файла EIF запись нужно остановить (выключить).
  • Кнопка 3 Image: включает/выключает отслеживание изображений.
  • Кнопка 4 Image Fusion: включает/выключает режим отслеживания изображений + слияния с движением.
  • Кнопка 5 Dense: включает/выключает плотное картографирование пространства.
  • Кнопка 6 Sparse: включает/выключает разреженное картографирование пространства.
  • Кнопка 7 Mega: включает/выключает Mega.

Подробное описание функций

  • Статус функций по умолчанию

    Все функции по умолчанию отключены при запуске (скрипты деактивированы в редакторе). Кнопки включают/выключают соответствующие скрипты. Можно настроить функции, активные по умолчанию.

    hmd-default-disable

  • Опорная точка системы координат

    В образце в начале координат отслеживания движения размещена статичная модель панды для проверки статуса отслеживания. Эта модель помогает диагностировать проблемы (например, при работе Mega быстрый дрейф может быть вызван дефектом отслеживания движения устройства — тогда модель панды тоже будет дрейфовать). При необходимости модель можно изменить или удалить.

  • Использование встроенного изображения для отслеживания

    • В образце предустановлен размер изображения для плоскостного отслеживания. Распечатайте namecard.jpg на листе A4, сохраняя пропорции без растяжения/обрезки, максимально заполняя лист (см. ниже). namecard

    • Измерьте длину напечатанного изображения визитки. В сцене Unity установите Scale для Image Target равным реальному физическому размеру (в метрах). set-the-actual-size

    • При включенном EasyAR слиянии с движением можно отслеживать только статичные (неподвижные) изображения. Если слияние отключено, изображение теряется при выходе из поля зрения.

    • Иногда угол обзора очков не оптимален для размера изображения камеры. Если распознавание не работает, попробуйте приблизить камеру очков к изображению. Для реального использования рекомендуется отслеживать крупные изображения (например, 5м x 5м).

Примечание

На гарнитурах параметр Scale для image target всегда должен соответствовать реальному физическому размеру (независимо от статуса EasyAR слияния с движением), иначе позиция отображения будет некорректной.