Симуляция запуска в Unity editor
Этот документ поможет выполнить симуляцию real-scene localization в Unity editor, чтобы до публикации mini program проверить статическое выравнивание виртуального контента.
Перед началом
Подтвердить, что localization library уже можно использовать.
Использовать инструмент Mega Toolbox для сбора simulation run data.
Создать 3D-контент, выровненный с реальной сценой, например:
Важно
Использование EIF-данных, записанных onsite, позволяет визуально проверить точность размещения виртуального контента.
Однако из-за различий сред платформ xr-frame и Unity логика code scripts и результаты рендеринга не могут быть проверены в simulation run.
Simulation run
Создайте Sense license
Поскольку simulation run в Unity требует EasyAR Sense, нужно подготовить Sense license (она может быть пробной).
В EasyAR Developer Center выберите [Sense license management] > [Create a new Sense license key]:
Выберите EasyAR Sense Personal Edition.
В опции ‘Whether to use sparse space’ выберите ‘No’.
Заполните любое имя приложения, iOS Bundle ID и Android Package Name.
Нажмите OK. После этого запрошенная license появится в Sense license management в Developer Center.
В EasyAR Developer Center выберите Sense license, запрошенную на этапе подготовки.
Нажмите copy:
Нажмите [EasyAR] > [Mega] > [Configuration] в верхней строке меню Unity editor, чтобы перейти на страницу конфигурации:
Нажмите Sense слева для настройки и введите Sense license.
Включите verification tool и нажмите Run.
В pop-up window нажмите OK.
Нажмите load button, чтобы загрузить EIF-файл.
Выберите EIF-файл, сохраненный на этапе подготовки (суффикс
.eifили.mkveif).
Скройте Block Mesh.
Можно установить весь Block Mesh как hidden.
В verification tool можно установить Block Mesh Alpha в 0, то есть сделать прозрачным.
Перетащите control bar в крайнее левое положение.
Play EIF
Важно
При воспроизведении EIF в Unity editor используемые SDK и input frame data отличаются от используемых в xr-frame mini program, поэтому этот способ:
✅ Может использоваться для визуальной проверки точности размещения виртуального контента и проверки точности localization cloud localization service в этой позиции.
❌ Не может использоваться для проверки финального эффекта xr-frame mini program на реальном устройстве.
Принцип работы и ожидания: когда Unity воспроизводит EIF data, EasyAR SDK вызывает записанные input frame data и отправляет реальные облачные запросы в настроенный localization service.
Если localization успешна и стабильна: позиция модели точная и без drift, поэтому можно ожидать, что эта сцена в xr-frame mini program также достигнет относительно хорошего эффекта.
Если localization не удалась или поведение abnormal: модель часто прыгает, смещается или не может выполнить localization. Обычно это означает, что xr-frame mini program столкнется с похожими проблемами при запуске на реальном устройстве.