Table of Contents

Отчет о проблемах в WeChat Mini Program

Чтобы быстро и точно выявить проблемы, возникающие при разработке или использовании WeChat Mini Program с функциональностью EasyAR (Mega или CRS), перед отправкой обратной связи предоставьте необходимую информацию и данные, следуя этому руководству. Это значительно сократит время на выявление и устранение проблем.

Предварительная проверка проблемы

Перед сообщением о проблеме попробуйте решить её базовыми методами или изучите документацию.

При использовании плагина Mega:

  • Убедитесь, что используется плагин Mini Program версии 2.x (версия 1.x плагина Mega для Mini Program больше не поддерживается).
  • Ознакомьтесь с известными проблемами и ограничениями плагина Mega, чтобы подтвердить, не является ли это известной проблемой.
  • Сравните с реализацией в Mega Sample или CRS Sample, убедитесь, что проблема сохраняется.

Данные, необходимые при обращении с проблемой

Полный отчёт о проблеме должен включать следующие данные для точного анализа командой разработчиков EasyAR.

Данные среды выполнения

  • Модель устройства: можно получить через wx.getDeviceInfo().model.
  • Платформа клиента WeChat: через wx.getDeviceInfo().system.
  • Версия WeChat: через wx.getAppBaseInfo().version.
  • Версия базовой библиотеки клиента Mini Program: через wx.getAppBaseInfo().SDKVersion.
  • (При использовании плагина Mega) Версия плагина Mega: можно получить из поля version в секции plugins файла app.json вашего проекта.

[Mega] Файл AR Session dump (критически важно)

Файл AR Session dump, воспроизводящий проблему, — ключевые данные для анализа проблем позиционирования и трекинга в WeChat Mini Program.

См. Как записать AR Session dump в вашем Mini Program для реализации записи и передачи файла dump.

Если проблема стабильно воспроизводится, вы также можете записать эти данные через Mega Toolbox и передать их. См. Запись и передача данных session dump с помощью WeChat Mini Program Mega Toolbox.

Запись экрана (рекомендуется)

При использовании плагина Mega обязательно ведите запись экрана одновременно с записью AR Session dump. Это позволит сопоставить визуальные явления на видео с данными алгоритмов.

Логи выполнения

Если в vConsole появляются ошибки, предоставьте детальную информацию о них. Подробные методы см. в Анализ логов в WeChat Mini Program.

Важно

При проблемах с позиционированием или трекингом в Mega (не программных сбоях) обязательно предоставьте файлы session dump и записи экрана за соответствующий период. Только логи дают косвенную информацию, а данные dump и запись экрана — основа для анализа.