Часто задаваемые вопросы о Mega

В процессе разработки проблемы неизбежны. Это руководство поможет вам быстро определить и решить распространённые вопросы. Начнём со списка часто задаваемых вопросов (FAQ). Если вы не найдёте здесь ответа, обратитесь к следующим разделам или отправьте нам отчёт о проблеме.

Часто задаваемые вопросы (faq)

Вот некоторые наиболее распространённые проблемы, с которыми сталкиваются разработчики при интеграции и использовании EasyAR Mega, и их решения.

В: Почему мое приложение показывает Invalid Key?

О: Обычно это вызвано следующими причинами:

1. Лицензия недействительна или истекла
2. Лицензия не соответствует Bundle ID / Package Name
3. Для устройств виртуальной реальности (headset) требуется отдельная XR License
4. Функция пользовательской камеры требует официальной лицензии

В: Почему на моем приложении есть водяной знак?

О: Это означает, что вы используете пробную (trial) лицензию, а не официальную.

В: Почему в моем приложении появляется обратный отсчет (timeout within * seconds)?

О: Это ограничение в течение пробного периода. Использование официальной лицензии EasyAR Sense и официального сервиса EasyAR Mega решит эту проблему.

В: Почему мое приложение открывается черным экраном?

О: В этом случае система обычно выводит причину ошибки в информации на экране или в логах. Вы можете решить проблему, основываясь на конкретной причине, выведенной системой. Если не удается решить, предоставьте техническую информацию (включая логи, скриншоты, подробную информацию об устройстве и т.д.).

В: Почему мое приложение не может определить местоположение, статус постоянно NotFound?

О: Обычно это вызвано следующими причинами:

1. Служба локализации все еще запускается:
   В этот момент служба локализации еще не завершила загрузку всех карт Mega, поэтому не может гарантировать успешное определение местоположения в определенной области.
2. Находитесь вне зоны покрытия карты:
   Убедитесь, что ваше текущее физическое местоположение находится в пределах зоны покрытия загруженной вами карты Mega.
3. Ошибка конфигурации при тестировании в симуляции:
   Приложение запущено не на месте, но MegaLocationInputMode ошибочно установлен в Onsite.
4. Неблагоприятные условия окружающей среды:
   Экстремальное освещение (слишком темно или слишком ярко), большие однотонные поверхности стен или пола (например, белые стены, полированный пол) могут повлиять на визуальную локализацию.

В: Почему мое приложение не может определить местоположение, возвращается аномальный статус?

О: Обычно это вызвано следующими причинами:

1. Превышено время ожидания запроса:
   В этом случае система вернет RequestTimeout.
2. Слишком короткий интервал между запросами:
   В этом случае система вернет RequestIntervalTooLow.
3. Другие ошибки:
   В этом случае система вернет UnknownError. Как правило, такие ошибки соответствуют сбоям при подключении или передаче данных, либо ошибкам самого сервиса Mega. Подробную информацию можно получить через интерфейс MegaBlockLocalizationResponse.ErrorMessage.

В: Почему моя заявка на использование плагина для мини-программы (mini-program) отклонена?

О: Это происходит потому, что плагины для мини-программ не поддерживают использование в "гостевом режиме" инструмента разработчика WeChat и не поддерживаются мини-программами, зарегистрированными на физическое лицо. Подавайте заявку, используя AppId мини-программы WeChat, зарегистрированной на юридическое лицо (предприятие).

Q: Почему моя авторизация мини-программы не прошла?

A: Вам необходимо получить лицензию плагина Mega для мини-программы из центра разработки и убедиться, что используемый AppId совпадает с указанным в лицензии.

Q: Почему моя мини-программа не работает на телефонах XX?

A: Интеграция Mega в мини-программу зависит от компонента VisionKit WeChat. Требования к системе и список поддерживаемых устройств смотрите в документации WeChat.

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

A: Проблемы с позиционированием часто сложны, возможные причины:

1. Погрешность карты:
   Сама карта Mega в этой области может иметь погрешность. Обычно это происходит на этапе сбора или реконструкции карты. Свяжитесь с коммерческим отделом для подтверждения.
2. Скачки при инициализации:
   В первые несколько секунд позиционирования положение может слегка скакать. Это вызвано тем, что SLAM-система устройства еще не завершила инициализацию, что особенно заметно в мини-программах WeChat (на некоторых устройствах это может занимать больше времени).
3. Динамические изменения среды:
   Если физическая среда значительно изменилась (например, передвинули крупные объекты, добавили временные стенды), карта может не соответствовать реальности. В этом случае карту необходимо обновить.
4. Системная погрешность устройства:
   У большинства устройств после длительной непрерывной работы накапливается погрешность SLAM-системы, что приводит к дрейфу.
5. Погрешность позиционирования:
   Визуальное позиционирование само по себе имеет погрешность, обычно не влияющую на визуальное восприятие контента. Если погрешность настолько велика, что вызывает явное смещение или дрейф, для анализа и решения потребуются подробные данные. Следуйте методам сбора данных и обратной связи, описанным в разделе Диагностика проблем и отчеты.

Q: Как собрать и использовать данные EIF для отладки?

A: Данные EIF — мощный инструмент отладки. Обратитесь к следующим разделам:

• Как собрать: Прочтите Запись данных симуляции, чтобы узнать, как записывать EIF-файлы на телефоне или гарнитуре.
• Как воспроизвести: В зависимости от вашей среды разработки (Unity или мини-программа WeChat) следуйте соответствующему руководству по воспроизведению в этом разделе.

Поиск более конкретной помощи

Если приведённые выше FAQ не решили вашу проблему, посетите следующие тематические страницы для получения более глубоких решений:

• Содержимое не отображается - Фокусируется на устранении неполадок с отображением контента.
• Дрожание и смещение содержимого - Подробный анализ дрожания и смещения контента.
• Известные проблемы интеграции с мини-программами WeChat - Сводка специфических проблем для платформы мини-программ.

Сообщение о новой проблеме

Если вы столкнулись с проблемой, не охваченной выше, которая, как вы подозреваете, связана с самим SDK или платформой, помогите нам улучшить продукт. Подробные шаги или инструкции см. в разделе: Отчёт о проблеме.

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

1. Описание проблемы: Чётко опишите наблюдаемые симптомы, частоту возникновения и шаги для воспроизведения.
2. Информация об устройстве: Модель устройства, версия операционной системы, версия EasyAR SDK.
3. Данные EIF: Обязательно предоставьте файл записи EIF, воспроизводящий проблему. Это самый важный диагностический материал.
4. Файл журналов: Полный журнал приложения (вывод Logcat или консоли).
5. Запись экрана или скриншот: Видеозапись экрана или скриншот на момент возникновения проблемы.

Отправьте эту информацию нам через форум, электронную почту или представителя по работе с клиентами. Благодарим за обратную связь!