Отчёт о проблеме и обратная связь

Мы очень ценим вашу обратную связь. Она является ключом к улучшению продуктов и сервисов EasyAR Mega. Чтобы мы могли быстро и точно найти и решить вашу проблему, перед отправкой отчёта уделите несколько минут этому руководству.

Наши контакты

Вы можете отправить нам отчёт о проблеме через следующие каналы:

Официальное сообщество/форум разработчиков - рекомендуется для общих вопросов и общения в сообществе.
- Пользователи из Китая нажмите здесь
- Другие пользователи нажмите здесь
Корпоративная группа WeChat - подходит для enterprise-пользователей, которым нужна конфиденциальность или более формальная поддержка.
- Отсканируйте QR-код ниже, чтобы вступить в группу
Другие контакты - как запасной вариант.
- Чтобы получить контакты, нажмите здесь

Ключевые элементы качественного отчёта

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

Общий checklist отчёта (нужен для всех проблем)

Чёткое описание проблемы:
- Какой результат вы ожидали получить?
- Что произошло фактически? Например: приложение crash, localization не удалась, контент drift.
- Как часто возникает проблема, всегда или иногда? При каких условиях?
Информация об устройстве и окружении:
- Модель устройства: например iPhone 14 Pro, Samsung Galaxy S23 Ultra, Apple Vision Pro.
- Версия операционной системы: например iOS 17.2, Android 14, visionOS 26.
- Версия EasyAR SDK: например EasyAR Sense Unity Plugin v4.6.0.
- Тестовое окружение: в помещении/на улице, освещение, является ли среда динамической.
Данные EIF (самое важное доказательство):
- Обязательно предоставьте файл записи EIF, который может воспроизвести проблему.
- Данные EIF содержат всю информацию датчиков и изображений на момент возникновения проблемы и являются самым сильным инструментом диагностики. См. Сбор данных симуляции выполнения, чтобы узнать, как записывать.
Файл журнала (Log):
- Предоставьте полный журнал приложения на момент возникновения проблемы.
- Android: вывод Logcat.
- iOS: журнал Console.app или вывод консоли Xcode.
- Unity: журнал Console Unity Editor.
- WeChat Mini Program: файл журнала, полученный через session.dumpLog().
Запись экрана или screenshot:
- Запись экрана или screenshot высокого разрешения в момент проблемы, чтобы наглядно показать описанное явление.
- Инструкции для разных устройств см.: запись экрана телефона, запись экрана headset.
Информация Mega localization library
- В Unity экспортируйте diagnostic information block, используемый приложением, или сервисную информацию Mega localization library. Способ экспорта:

Дополнительный checklist для конкретных типов проблем

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

A. Localization не удаётся или нестабильна

Вы уже пробовали проверить то же место с помощью Mega Toolbox или PC tool и описали результат.
Вы подтвердили, что map, загруженная в localization library, соответствует текущему физическому пространству.
Вы описали примерное место возникновения проблемы, например атриум торгового центра или вход в туристическую зону.

B. Контент не отображается

Вы предоставили результат проверки localization внешним tool.
Вы явно подтвердили, что размещение контента или логика кода не имеют проблем.
Если это проблема rendering, предоставьте screenshot или описание используемой модели, Shader или эффектов.

C. Контент прыгает или drift

Вы описали способ движения устройства, например плавное или быстрое движение.
Вы описали текстуру и освещение среды, а также есть ли крайне похожие области, вызывающие путаницу.
Вы описали внутреннюю логику обработки pose в приложении и подтвердили правильность размещения контента.

D. Проблема WeChat Mini Program

Вы предоставили screenshot включения пользователем разрешения сервиса Mega в WeChat.
Вы указали, находится ли модель телефона пользователя в официальном списке поддержки WeChat.
Вы предоставили AppID Mini Program и конкретное описание бизнес-сценария.

E. Проблема производительности (lag, высокое энергопотребление)

Вы указали модель устройства, на котором возникла проблема.
Вы предоставили загрузку CPU/GPU или температуру устройства во время работы приложения, если возможно.
Вы описали сложность 3D-контента, например число полигонов модели и размер текстур.
Вы указали, используется ли multi-map configuration.

Экспорт информации разработки Unity с EasyAR Sense Unity Plugin

Специально для разработки Mega-приложений на платформе Unity мы подготовили более удобный tool для генерации информации обратной связи. Подробные шаги:

Откройте в строке меню EasyAR > Sense > Ask a Question
В Ask a Question предоставьте следующую информацию:
- Отметьте runtime environment, single selection, например Android.
- Скопируйте информацию об устройстве. В ARSession установите DiagnosticsController.DumpSession в Log, скопируйте вывод одного frame и вставьте результат в поле информации об устройстве.
- Отметьте все функции EasyAR, используемые вашим приложением; поддерживается multiple selection.
- Подтвердите, что четыре проверки на странице выполнены и отмечены. При вопросе рекомендуется описать, как воспроизвести проблему в Sample.
- Нажмите функцию копирования в правом верхнем углу, чтобы завершить сбор информации разработки Unity.