FAQ по Mega

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

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

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

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

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

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

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

A: Это означает, что используемая License является пробной, а не официальной версией.

Q: Почему в моем приложении есть строка обратного отсчета, timeout within * seconds?

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

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

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

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

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

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

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

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

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

Q: Почему заявка на использование плагина Mini Program не удалась?

A: Причина в том, что плагины Mini Program не поддерживают использование в “visitor mode” WeChat Developer Tools, а также не поддерживают Mini Program, субъектом которых является физическое лицо. Подайте заявку с AppId WeChat Mini Program, принадлежащего корпоративному субъекту.

Q: Почему авторизация моего Mini Program не была одобрена?

A: Вам нужно получить Mega Mini Program plugin license в developer center и убедиться, что используемый AppId совпадает с AppId в license.

Q: Почему мой Mini Program нельзя использовать на телефоне XX?

A: Интеграция Mega в Mini Program зависит от компонента VisionKit WeChat. Системные требования и список поддерживаемых device см. в WeChat documentation.

Q: Localization выполнена успешно, но почему положение виртуального контента выглядит смещенным или drifting?

A: Проблемы, связанные с эффектом localization, часто имеют сложные причины. Возможные причины:

1. Проблема точности mapping:
   Mega map этой области сама может иметь ошибки точности. Обычно это происходит на этапе map collection или reconstruction. Свяжитесь с коммерческой поддержкой для подтверждения.
2. Скачки при initialization:
   В первые несколько секунд после начала localization положение может слегка прыгать. Это вызвано тем, что SLAM-система device еще не завершила initialization. В WeChat Mini Program этот процесс особенно заметен, а на некоторых device может даже занимать довольно долгое время.
3. Динамические изменения среды:
   Если физическая среда значительно изменилась, например были перемещены крупные конструкции или добавлены временные стенды, map может перестать соответствовать реальности. В этом случае map нужно обновить.
4. Системная ошибка device:
   После длительной непрерывной работы большинства device накопленные ошибки их SLAM-систем могут вызывать drifting.
5. Проблема ошибки localization:
   Visual localization сама по себе имеет ошибки точности. Обычно такие ошибки не влияют на визуальный опыт виртуального контента. Если ошибка достаточно велика и вызывает заметное смещение или drifting, для анализа и решения требуются подробные данные. Соберите данные и отправьте feedback согласно методам, описанным в issue diagnosis and report.

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

A: EIF-данные являются мощным debugging tool. См. следующие разделы:

• Как собирать: Прочитайте collect simulated runtime data, чтобы узнать, как записывать EIF-файлы на телефоне или headset.
• Как воспроизводить: В зависимости от development environment, Unity или WeChat Mini Program, обратитесь к соответствующему replay guide в этом разделе.

Найти более конкретную помощь

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

• Контент не отображается - посвящено устранению проблем рендеринга контента.
• Дрожание и дрейф контента - подробный анализ дрожания и дрейфа контента.
• Известные проблемы интеграции WeChat Mini Program - сводка специальных проблем платформы mini program.

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

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

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

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

Отправьте указанную информацию через форум, email или бизнес-контакт. Спасибо за ваш отзыв!