Table of Contents

Запись данных EIF: высокоточные материалы для воспроизведения проблем AR

В приложениях дополненной реальности (AR) некоторые сложные проблемы spatial localization, такие как дрожание tracking, несовпадение виртуального и реального, дрейф контента и т. п., часто трудно полностью восстановить только по записи экрана или логам. Для этого мы предоставляем функцию записи данных EIF — проприетарный формат высокоточного дампа данных, который может синхронно записывать следующую ключевую информацию:

  • Основная информация об устройстве, например модель, система, версия SDK
  • Кадры изображения камеры с timestamp
  • Матрица внутренних параметров и матрица внешних параметров камеры устройства
  • Данные датчиков IMU
  • Дополнительные данные из внешних вспомогательных входов, например GNSS

Почему важно записывать данные EIF?

Важно

Данные EIF, позволяющие воспроизвести проблему, бесценны.

Данные EIF могут полностью воспроизвести подробный контекст возникновения проблемы, позволяя команде разработки точно восстановить пользовательский сценарий в офлайн-среде и значительно повысить эффективность локализации проблемы. По сравнению с записью экрана или логами EIF имеет следующие преимущества:

  1. Точное воспроизведение: разработчики могут напрямую воспроизвести данные EIF в отладочных инструментах, чтобы повторить Bug, с которым вы столкнулись.
  2. Низкоуровневая диагностика: благодаря всестороннему анализу разных данных, таких как изображения, датчики и внешние входы, разработчики могут определить, на каком техническом этапе возникла проблема.
  3. Экономия времени: позволяет избежать длительных циклов коммуникации и значительно сокращает период от сообщения о проблеме до ее решения.

Как записывать данные EIF

EasyAR предоставляет два способа записи данных EIF.

  1. Непосредственно использовать API, предоставляемые SDK, чтобы реализовать запись данных EIF в вашем приложении.
  2. Использовать официальный Mega Toolbox App. Обычно это подходит для разработки EasyAR Mega и обратной связи по проблемам.

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

Совет

Перейдите по следующей ссылке, чтобы узнать, как реализовать запись EIF внутри приложения через вызов API: Input frame recording and simulated runtime.

Перейдите по следующей ссылке, чтобы посмотреть руководство по использованию Mega Toolbox App: Use Toolbox to record mobile EIF files.

Краткий обзор процесса записи на примере Mega Toolbox App:

  1. Откройте Mega Toolbox App и нажмите On-site Verification and Diagnostics Tool.
  2. Войдите в свой аккаунт, выберите свою localization library и начните тестирование.
  3. Попробуйте воспроизвести проблему. Найдите шаблон действий, который стабильно воспроизводит проблему, например ориентация устройства, способ просмотра или точка съемки.
  4. Когда все готово, нажмите красную кнопку "Record", чтобы начать запись.
  5. После появления проблемы нажмите красную кнопку "Stop and Save".
  6. Система автоматически создаст файл EIF. Подключите устройство к компьютеру, экспортируйте файл в локальное хранилище и отправьте его.
Примечание

Файлы EIF могут быть большими, от сотен MB до нескольких GB. Рекомендуется записывать только ключевой фрагмент, содержащий проблему, обычно достаточно 10-30 секунд.

Рекомендации лучших практик

Чтобы ваша обратная связь была обработана эффективно, при отправке одновременно включайте следующие четыре типа информации:

Тип информации Описание
Файл данных EIF Основное диагностическое свидетельство, обязательно должно содержать процесс воспроизведения проблемы
Субъективное описание явления Четко опишите наблюдаемое поведение, например "стрелка навигации при повороте налево внезапно прыгнула на потолок"
Запись экрана или screenshot Помогает визуализировать проблему и наглядно показывает, "что в итоге увидел пользователь"
Дополнительная контекстная информация Включает:
• Модель вашего устройства и версию операционной системы
• Версию EasyAR SDK, используемую вашим приложением
• Описание среды, где возникла проблема (indoor/outdoor, освещение, размер пространства)
• Для приложений типа Mega нужно дополнительно предоставить информацию localization library, которую можно экспортировать из Unity tool
• Для приложений CRS cloud recognition нужно дополнительно предоставить информацию cloud recognition library
Совет

Пример: "На Apple Vision Pro (visionOS 26) используется EasyAR Sense Unity Plugin 4000.0.1, навигация выполняется в indoor торговом центре, в определенном месте маршрут навигации внезапно стал неправильным. Записан файл EIF: avp_wrong_path_20251218.mkveif, приложены запись экрана, фотографии среды и информация localization library: MegaStudio_ServiceInfo_myaccount_2025-12-18_10-33-26.json."

Предоставив полный пакет информации выше, вы значительно ускорите анализ и исправление проблемы. Спасибо за сотрудничество!