Table of Contents

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

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

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

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

Важно

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

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

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

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

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

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

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

Совет

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

Перейдите по следующей ссылке, чтобы посмотреть инструкцию по использованию приложения Mega Toolbox: [Запись файлов EIF с мобильного устройства с помощью Toolbox](../../mega/data - collection/simulation/toolbox.md).

Краткий обзор процесса записи (на примере приложения Mega Toolbox):

  1. Откройте приложение Mega Toolbox и нажмите Инструменты для проверки и диагностики в реальном времени.
  2. Войдите в свою учетную запись, выберите свою базу данных локализации и начните тестирование.
  3. Попытайтесь воспроизвести проблему. Найдите режим работы, при котором проблема стабильно воспроизводится (например, ориентация устройства, способ просмотра, точка съемки и т.д.).
  4. Когда все будет готово, нажмите красную кнопку "Запись" для начала записи.
  5. После появления проблемы нажмите красную кнопку "Остановить и сохранить".
  6. Система автоматически сгенерирует файл EIF. Подключите устройство к компьютеру, экспортируйте файл на локальное хранилище и отправьте его.
Примечание

Файлы EIF могут быть большими (от нескольких сотен МБ до нескольких ГБ). Мы рекомендуем записывать только основной фрагмент, содержащий проблему (обычно 10 - 30 секунд достаточно).

Советы по лучшей практике

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

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

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

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