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

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

Краткое содержание

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

Идентификация проблемы: классификация и первоначальная оценка распространённых аномалий.
Стандарты скриншотов и видеозаписей: методы визуальной фиксации для различных платформ устройств.
Сбор данных во время выполнения: извлечение и экспорт данных о среде выполнения на различных платформах.
Стандарты обратной связи: обеспечение «минимального набора информации», необходимого технической команде для воспроизведения проблемы.

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

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

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

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

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

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

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

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

Базовый перечень информации (минимальный набор)

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

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

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

Данные времени выполнения (ключевая основа для расследования)

Данные EIF: запись времени выполнения на основе EasyAR Sense, поддерживает воспроизведение и анализ на ПК.
Данные Dump: снимок состояния выполнения, специфичный для мини-программ WeChat.
Логи приложения: логи выполнения приложения (Logcat/Console) и стек ошибок.

Совет

Дополнительно: Как чётко передать детальное описание проблемы

Среда выполнения и классификация методов сбора

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

Классификация устройств

Мобильные устройства: смартфоны (iOS/Android).
Гарнитуры:
- OST (Optical See-Through): оптическая сквозная передача (например, XREAL, Rokid).
- VST (Video See-Through): видеосквозная передача (например, Apple Vision Pro, PICO).

Руководство по скриншотам и видеозаписям

Тип платформы	Справочное руководство
Телефон / Мини-программа WeChat	Скриншоты, видеозапись и экспорт с телефона
Гарнитура OST	Видеозапись и экспорт с OST
Гарнитура VST	Видеозапись и экспорт с VST

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

Тип сценария	Метод сбора
Нативное приложение EasyAR Sense	Запись EIF в мобильном приложении / Запись EIF на гарнитуре
Мини-программа WeChat	Запись и экспорт данных Dump мини-программы
Инструмент быстрого сбора	Запись EIF в Mega Toolbox / Запись Dump в Toolbox

Автоматический сбор данных (скоро)

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

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

Навигация по руководствам

Перейдите непосредственно к детальным руководствам в соответствии с вашей платформой устройства:

Тип	Руководство по сбору скриншотов и видеозаписей	Руководство по сбору данных времени выполнения
Мобильное приложение	Скриншоты, видеозапись и экспорт с телефона	Запись EIF в мобильном приложении, Запись EIF в Mega Toolbox, Инструкции по экспорту данных EIF
Гарнитура OST	Видеозапись и экспорт с OST	Запись и экспорт EIF на гарнитуре
Гарнитура VST	Видеозапись и экспорт с VST	Запись и экспорт EIF на гарнитуре
Мини-программа WeChat	Скриншоты, видеозапись и экспорт с телефона	Запись и экспорт Dump мини-программы WeChat, Запись Dump мини-программы в Toolbox

Table of Contents