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

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

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

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

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

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

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

A. Неудачная или нестабильная геолокация

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

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

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

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

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

D. Проблемы с мини-программой ВКонтакте

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

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

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

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

В частности, для разработки Mega-приложений на платформе Unity мы подготовили более удобный инструмент для генерации информации для обратной связи. Подробные шаги操作如下:

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