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

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

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

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

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

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

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

Общий чек-лист отчета (необходим для всех проблем)

Четкое описание проблемы:
- Какого результата вы ожидали?
- Что произошло на самом деле? (Например: сбой приложения, сбой локализации, дрейф контента)
- Как часто возникает проблема (постоянно/иногда)? При каких условиях?
Информация об устройстве и окружении:
- Модель устройства: Например, 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: файл журнала, полученный с помощью session.dumpLog().
Запись экрана или скриншот:
- Видеозапись экрана или качественный скриншот на момент проблемы, что наглядно покажет описанное явление.
- Инструкции для разных устройств см.: Запись экрана телефона, Запись экрана гарнитуры.
Информация о локализационной библиотеке Mega
- Информация о сервисе локализационной библиотеки Mega, использованной для экспорта приложения в Unity. Метод экспорта:

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

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

A. Сбой или нестабильность локализации

Уже использовали Mega Toolbox или инструменты на ПК для проверки в том же месте и указали результат.
Убедились, что загруженная в локализационную библиотеку карта соответствует текущему физическому пространству.
Указали примерное местоположение возникновения проблемы (например, атриум торгового центра, вход в достопримечательность).

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

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

C. Подпрыгивание или дрейф контента

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

D. Проблемы с мини-программами WeChat

Уже предоставили скриншот, подтверждающий, что пользователь включил разрешения для службы Mega в WeChat.
Указали, входит ли модель телефона пользователя в официальный список поддерживаемых WeChat устройств.
Предоставили AppID мини-программы и конкретное описание бизнес-сценария.

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

Указали модель устройства, на котором возникает проблема.
Предоставили информацию о загрузке CPU/GPU или температуре устройства во время работы приложения (если возможно).
Указали сложность 3D-контента (число полигонов моделей, размер текстур).
Указали, используется ли конфигурация с несколькими изображениями (multi-image).

Экспорт информации о разработке в Unity с помощью EasyAR Sense Unity Plugin

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

В строке меню откройте EasyAR > Sense > Вопрос
В разделе Вопрос предоставьте следующую информацию:

Отметьте флажком среду выполнения (один выбор), например Android.
Скопируйте информацию об устройстве. В ARSession установите DiagnosticsController.DumpSession в значение Log, скопируйте вывод одного кадра и вставьте результат в поле информации об устройстве.
Отметьте флажками все функции EasyAR, используемые вашим приложением (поддерживается множественный выбор).
Убедитесь, что выполнены четыре проверки на странице и поставлены галочки, при описании вопроса рекомендуется указать, как воспроизвести проблему в Sample.
Нажмите кнопку копирования в правом верхнем углу — сбор информации о разработке в Unity завершен.