Сбор диагностических данных Mega

Это руководство предоставляет стандартизированные инструкции по сбору данных об аномалиях visual effect. Стандартизированный сбор данных и обратной связи помогают разработчикам точно описывать проблемы, а технической команде EasyAR эффективно находить, воспроизводить и устранять технические fault, связанные с visual локализация.

Введение

При интеграции EasyAR Mega локализация сервису точный сбор данных является ключевой предпосылкой диагностики проблемы. Руководство охватывает следующие основные этапы:

Выявление проблемы: классификация и предварительная оценка распространенных аномалий.
Спецификации снимков экрана и записи экрана: методы визуальных доказательств для разных платформ устройств.
Сбор данных выполнения: извлечение и экспорт данных среды выполнения на каждой платформе.
Стандарты информации обратной связи: обеспечение "минимальный набор информации", необходимого технической команде для воспроизведения проблемы.

Классификация аномалий и первичная оценка

Перед отправкой проблемы уточните тип аномалии по следующей классификации:

Распространенные проявления аномалий

Полная невозможность локализация: сцена не распознается, статус постоянно показывает "NotFound".
Отклонение точности локализация: локализация успешна, но точность недостаточна, присутствует явный пространственное смещение.
Нестабильная локализация: изображение дрожит или дрейфует, либо трекинг часто теряется.
Региональная аномалия: локализация работает плохо в определенных областях или точках.
Различия устройства compatibility: производительность хуже на некоторых конкретных моделях устройств.

Предполагаемые возможные причины

Связано со сценой: смещение размещение контента, низкое качество построение карты, слабое освещение среды или редкие признаки (например большие белые стены), либо помехи от похожих точек.
Техническая среда: network дрожит, задолженность по сервису, превышение лимит QPS, совместимость версия SDK или ошибки логика вызова API.
Аппаратные разрешения: устройства sensors (IMU) не поддерживают motion трекинг, либо не включены разрешения камеры/хранилища.

Стандартизированный процесс обратной связи

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

Чек-лист базовой информации (минимальный набор информации)

Идентификаторы ресурсов: информация аккаунта, Mega AppId, Block Id.
Информация о версии: EasyAR Sense версия SDK или версия плагина Mini Program.
Подробности проблемы: подробное описание аномалии и условий ее запуска.
Параметры среды: модель устройства, версия OS, версия WeChat и текущая сетевая среда (4G/5G/WiFi).

Визуальные доказательства (видео и снимки экрана)

Запись экрана процесса воспроизведения: полностью записать процесс локализация от запуска до появления аномалии.
Ключевые кадры снимки экрана: сделать снимки экрана в момент возникновения аномалии.
Записи с разных ракурсов: предоставить визуальные ориентиры с разных позиций и при разном освещении.

Данные выполнения (основная база для диагностики)

Данные EIF: записи выполнения на основе EasyAR Sense, поддерживающие воспроизведение и анализ на PC.
Данные Dump: snapshots состояние выполнения, специфичные для WeChat Mini Program.
Логи приложения: логи выполнения приложения (Logcat/Console) и стеки ошибок.

Совет

Дополнительное чтение: Как ясно передавать подробную информацию о проблеме

Категории среда выполнения и методов сбора

Методы сбора данных зависят от running устройства и платформы. Выберите соответствующее руководство согласно вашей actual environment.

Категории устройств

Mobile устройстваs: смартфоны (iOS/Android).
Headset устройстваs:
- OST (Optical See-Through): optical see-through, например XREAL и Rokid.
- VST (Video See-Through): video see-through, например Apple Vision Pro и PICO.

Руководства по снимков экрана и записи экрана

Тип платформы	Справочное руководство
Телефон / WeChat Mini Program	Screenshot, screen запись и экспорт на телефоне
OST headset	OST запись и экспорт
VST headset	VST запись и экспорт

Сбор данных выполнения (EIF/Dump)

Тип сценария	Способ сбора
EasyAR Sense нативное приложение	Телефон app EIF recording / Headset EIF recording
WeChat Mini Program	Mini Program Данные Dump запись и экспорт
Инструменты быстрого сбора	Запись EIF в Mega Toolbox / Toolbox Dump recording

Функция автоматического сбора (скоро)

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

Фоновая запись: запуск фонового сбора необходимых наборов данных по требованию
Автоматическая загрузка: автоматическая упаковка и загрузка данных технической команде EasyAR
Захват по требованию: самостоятельный в реальном времени-захват аномальных состояний
Progress трекинг: классификация и непрерывное отслеживание прогресс

Сводка навигации по операционного руководства

Перейдите напрямую к detailed операционного руководства согласно требованиям вашей устройства platform:

Type	Запись экрана and screenshot collection guide	Сбор данных выполнения guide
Телефон application	Screenshot, screen запись и экспорт на телефоне	Телефон app EIF recording, Запись EIF в Mega Toolbox, Инструкции по export Данные EIF
OST headset	OST запись и экспорт	Headset EIF запись и экспорт
VST headset	VST запись и экспорт	Headset EIF запись и экспорт
WeChat Mini Program	Screenshot, screen запись и экспорт на телефоне	WeChat Mini Program Dump запись и экспорт, Запись Dump в Toolbox WeChat Mini Program

Table of Contents