Запись eif данных: высокоточное воспроизведение проблем ar
В приложениях дополненной реальности (AR) некоторые сложные проблемы пространственного позиционирования (например, дрожание трекинга, несоответствие виртуального и реального, дрейф контента) часто трудно полностью воспроизвести только с помощью записи экрана или логов. Для этого мы предоставляем функцию записи данных EIF — проприетарный формат дампа данных высокой точности, синхронно записывающий следующую ключевую информацию:
- Базовую информацию об устройстве (модель, ОС, версия SDK и т.д.)
- Кадры изображения с камеры с временными метками
- Внутреннюю матрицу камеры устройства, внешнюю матрицу
- Данные датчиков IMU
- Дополнительные данные внешних вспомогательных входов (например, GNSS)
Почему запись eif данных критически важна?
Важно
EIF-данные, способные воспроизвести проблему, бесценны.
Данные EIF позволяют полностью воссоздать детальный контекст возникновения проблемы, позволяя команде разработчиков в офлайн-среде точно воспроизвести сценарий, с которым столкнулся пользователь, что значительно повышает эффективность диагностики. По сравнению с записью экрана или логами, EIF обладает следующими преимуществами:
- Точное воспроизведение: Разработчики могут напрямую воспроизводить данные EIF в инструментах отладки, воссоздавая встреченный вами баг.
- Глубокая диагностика: Путем комплексного анализа различных данных (изображения, датчики, внешние входы и т.д.) разработчики могут определить, на каком этапе технологического процесса возникла проблема.
- Экономия времени: Избегаются длительные циклы коммуникации, значительно сокращая срок от сообщения о проблеме до ее решения.
Как записывать eif данные
EasyAR предоставляет два способа записи данных EIF.
- Непосредственное использование API-интерфейсов, предоставляемых SDK, для реализации функции записи данных EIF в вашем приложении.
- Использование официального приложения Mega Toolbox App. Обычно подходит для разработки с EasyAR Mega и предоставления обратной связи по проблемам.
Конкретные шаги см. в нашей технической документации, чтобы получить руководство по эксплуатации для вашего случая использования и устройства.
Совет
Посетите следующую ссылку, чтобы узнать о реализации записи EIF внутри приложения с помощью вызова API: Запись входных кадров и симуляция.
Посетите следующую ссылку для руководства по использованию Mega Toolbox App: Использование Toolbox для записи EIF-файлов на телефоне.
Краткий обзор процесса записи (на примере Mega Toolbox App):
- Откройте Mega Toolbox App, нажмите "Тест локализации на месте & Запись данных для обратной связи по проблемам локализации".
- Войдите в свою учетную запись, выберите свою библиотеку локализации и начните тест.
- Попытайтесь воспроизвести вашу проблему. Найдите стабильно воспроизводимый шаблон действий (ориентация устройства, способ навигации, точки съемки и т.д.).
- Когда все будет готово, нажмите красную кнопку "Запись", чтобы начать запись.
- После возникновения проблемы нажмите красную кнопку "Остановить и сохранить".
- Система автоматически сгенерирует файл EIF. Подключите устройство к компьютеру, экспортируйте файл в локальное хранилище и отправьте его.
Примечание
EIF-файлы могут быть большими (от сотен МБ до нескольких ГБ). Рекомендуется записывать только ключевой фрагмент, содержащий проблему (обычно достаточно 10–30 секунд).
Рекомендации по best practice
Чтобы обеспечить эффективную обработку вашей обратной связи, при отправке обязательно включите все четыре типа информации:
| Тип информации | Описание |
|---|---|
| EIF-файл с данными | Ключевое доказательство для диагностики. Обязательно включает процесс воспроизведения проблемы. |
| Описание наблюдаемого явления | Четко опишите наблюдаемое поведение (например, "Навигационная стрелка внезапно прыгнула к потолку при повороте налево"). |
| Запись экрана или скриншот | Помогает визуализировать проблему, наглядно показывая "что в итоге увидел пользователь". |
| Дополнительный контекст | Включает: • Модель вашего устройства и версию ОС • Версию EasyAR SDK, используемую в вашем приложении • Описание среды возникновения проблемы (в помещении/на улице, освещение, размер пространства) • Для приложений типа Mega дополнительно требуется информация о библиотеке локализации, которую можно экспортировать в инструментах Unity • Для приложений с облачным распознаванием (CRS) дополнительно требуется информация о библиотеке облачного распознавания |
Совет
Пример: "На Apple Vision Pro (visionOS 26) с использованием EasyAR Sense Unity Plugin 4000.0.1, при навигации в помещении (торговый центр) в определенном месте путь навигации внезапно стал ошибочным. Записан EIF-файл: avp_wrong_path_20251218.mkveif, прилагаются запись экрана, фото окружения и информация о библиотеке локализации: MegaStudio_ServiceInfo_myaccount_2025-12-18_10-33-26.json."
Предоставление указанного выше полного пакета информации значительно ускорит процесс анализа и устранения проблемы. Благодарим за сотрудничество!