Компонент валидации

Компонент валидации используется для симуляции и проверки работы эффектов Mega на ПК.

Обзор интерфейса в неактивном состоянии

Если инструмент валидации не открыт в отдельном окне, панель инструментов студии отображает:

Если инструмент валидации открыт в отдельном окне, панель инструментов студии отображает:

А окно инструмента валидации отображает:

Обзор интерфейса в активном состоянии

Если инструмент валидации не открыт в отдельном окне, панель инструментов студии отображает:

Если инструмент валидации открыт в отдельном окне, окно инструмента валидации адаптирует отображение в зависимости от размера окна:

Описание областей инструмента

1. Область управления запуском
2. Область воспроизведения EIF
3. Область управления позиционированием
4. Область управления отображением
5. Область информации о состоянии

Область управления запуском

1. Включить/отключить инструмент валидации
2. Запустить/остановить инструмент валидации
3. Открыть в отдельном окне
4. Закрыть инструмент в отдельном окне
5. Выбрать инструмент студии в отдельном окне инструмента

Область воспроизведения EIF

1. Воспроизвести/пауза
2. Стоп
3. Перемотка вперед на 5с (доступно для данных нового формата, за исключением аварийной остановки записи)
4. Замедлить воспроизведение (доступно для данных нового формата)
5. Ускорить воспроизведение (доступно для данных нового формата)
6. Перемотка назад на 5с (доступно для данных нового формата, за исключением аварийной остановки записи)
7. Открыть файл EIF
8. Текущее время/общее время
9. Текущая скорость воспроизведения
10. Прогресс воспроизведения (перетаскивание доступно для данных нового формата, за исключением аварийной остановки записи)

Управление позиционированием

1. Индикатор состояния позиционирования
2. Запуск/остановка позиционирования (по умолчанию запущено)
3. Сброс состояния отслеживания
4. Выбор адреса сервера (можно изменить только когда инструмент не запущен)

Объяснение цветов индикатора состояния позиционирования

• Зеленый: позиционирование на Block успешно, и отслеживание VIO устройства работает. Становится прозрачным в течение 5 секунд, если новых результатов нет;
• Желтый: позиционирование на Block успешно, но отслеживание VIO устройства не работает. Становится прозрачным в течение 5 секунд, если новых результатов нет;
• Белый: невозможность позиционирования на Block. Становится прозрачным в течение 5 секунд, если новых результатов нет;
• Красный: ошибка позиционирования. Отображается до получения следующего результата;

Управление отображением

1. Показать/скрыть видео фон
2. Показать/скрыть аннотации данных
3. Показать/скрыть модель Block (в URP также скрывает модель в окне Scene)
4. Показать/скрыть названия кнопок
5. Управление прозрачностью модели Block (недоступно в URP)

Изменение прозрачности модели Block показано ниже

Область информации о состоянии

1. Состояние сессии, обновляемое каждый кадр
2. Результат позиционирования, возвращаемый сервером (связан с эффектом отслеживания, но не является полным результатом)
3. Копировать
4. Копировать
5. Отображать ли информацию dump в Game View

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

Подготовка данных EIF

Для проверки эффекта потребуются данные EIF. Используйте инструмент записи тестовых данных EIF для удалённой разработки и симуляции локации из Mega Toolbox для записи файла EIF. В зависимости от выбранного формата записи в результате будут сохранены файлы .mkveif (или файлы .eif и .eif.json — эти два файла необходимы вместе).

Подготовка пакета

Убедитесь, что com.easyar.sense импортирован. Если он не импортирован, появится сообщение:

В этом случае импортируйте необходимый пакет через Unity Package Manager: com.easyar.sense-**.tgz.

Заполнение лицензионного ключа EasyAR Sense

Войдите в центр разработки EasyAR через веб-интерфейс, чтобы получить лицензионный ключ EasyAR Sense.

В меню Unity откройте EasyAR > Sense > Configuration.

Затем в открывшемся окне Project Settings вставьте скопированный с сайта лицензионный ключ.

Подключение к сервису локации Mega

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

Подготовка данных Block (опционально)

Для наглядной оценки эффекта локации рекомендуется загружать модели Block для соответствующей области. Загрузку выполните согласно инструкции компонента данных Block.

Подготовка данных аннотаций (опционально)

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

Если к этому моменту данные Block и аннотаций уже импортированы, они отобразятся в сцене.

Подготовка 3D-контента (опционально)

Через контекстное меню можно создавать 3D-объекты. Учтите, что 3D-объекты должны располагаться под узлом Block.

После создания можно настроить положение, размер и другие параметры.

Также можно импортировать собственные модели.

Запуск инструмента

Сначала активируйте инструмент, затем нажмите кнопку запуска.

Также можно запустить через кнопку на панели инструментов Unity.

После запуска появится информационное окно. Внимательно ознакомьтесь с ним, если разрабатываете приложение на Unity.

Открытие EIF

После открытия EIF автоматически начнётся воспроизведение.

Просмотр эффекта

Можно управлять воспроизведением по необходимости. Типичный результат:

Можно полностью скрыть модель Block, чтобы добиться эффекта, идентичного реальной сцене.

Остановка работы и восстановление приложения

Остановите выполнение через кнопку инструмента.

Или через кнопку на панели инструментов Unity.

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

Эффект отображения и рекомендации по использованию в Unity

Настройка размера окна Game

Рекомендуется, чтобы размер окна соответствовал размеру видео кадров EIF. Обычно советуют использовать фиксированный размер, примерно эквивалентный 1080P, например, 1080x1920 (альбомный режим 1920x1080).

Если размер окна значительно отличается от размера видео кадра EIF, невозможно будет просмотреть полное видеоизображение, и инструмент также отобразит предупреждение.

Настройка освещения сцены

Для лучшего наблюдения за эффектом рендеринга можно добавлять и настраивать освещение в зависимости от потребностей. Если нет особых требований к освещению Unity, можно позволить Unity автоматически генерировать окружающий свет.

Одновременное отображение окна Scene и окна Game

Иногда необходимо одновременно просматривать содержимое окна Scene и окна Game. В этом случае можно изменить макет окон по умолчанию в Unity и отрегулировать расположение окон Scene и Game в соответствии с потребностями.

Особенности разработки в Unity

ARSession

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

Main Camera

Во время работы инструмент изменяет параметры Clear Flags и Background у основной камеры (Main Camera). Clear Flags изменяется на Solid Color. Background изменяется на черный цвет. Эти изменения не сохраняются.

Режим центра (Center mode)

Во время работы инструмента можно использовать все поддерживаемые режимы центра. Обычно рекомендуется использовать режим центра First Target.