Руководство по устранению аномального tracking в Mega
Mega использует технологию edge-cloud fusion. После успешной cloud localization она объединяет SLAM устройства для поддержания непрерывного tracking и обеспечивает точное закрепление AR-контента в реальном мире. Идеальное состояние tracking должно характеризоваться отсутствием drift, малым jitter и высокой плавностью. Этот документ посвящен проблемам tracking во время localization Mega и помогает понять правильные ожидания, распространенные категории ошибок, влияние различий между устройствами и случаи, когда нужно обращаться в техническую поддержку EasyAR.
Ожидаемый результат
Аномалии tracking обычно связаны с качеством данных mapping, факторами среды или совместимостью устройства. Для диагностики можно использовать MegaToolbox. Если проблема касается runtime-эффекта вашего приложения, можно также проверить ее непосредственно в вашем приложении.
В качественном Mega Block и хорошей среде tracking должен соответствовать следующим критериям:
- Стабильное закрепление: после успешной localization виртуальный контент фиксируется в мировых координатах без заметного drift.
- Устойчивое восстановление: после кратковременного перекрытия, быстрого поворота или изменения освещения tracking автоматически восстанавливается.
- Плавная производительность: контент рендерится нормально, без заметного jitter.
- Ограничения среды: возле однотонных стен, пустых полов, стекла или сильно отражающих поверхностей качество tracking снижается.
Если ваш опыт соответствует описанию выше, tracking в целом нормален.
Нормальные явления: легкий jitter или кратковременная потеря допустимы, особенно на этапе проверки процесса создания. Если состояние остается стабильным длительное время, оно считается нормальным.
Использование Mega Toolbox для самостоятельной диагностики
Аномалии tracking обычно появляются после успешной localization. Если аномальный tracking появляется в разработанном вами приложении, проверьте состояние localization в Mega Toolbox (см. руководство по Mega Toolbox - инструмент onsite verification and diagnosis). Если результаты отличаются, сначала проверьте, нет ли проблемы в реализации программы.
Шаги
- Установите Mega Toolbox на тестовый телефон.
- Откройте Toolbox, перейдите в
onsite verification and diagnosis toolи войдите с учетной записью и паролем. - Выберите режим SLAM и localization library.
- Отнесите телефон в точное место возникновения проблемы и наблюдайте отображение в интерфейсе Toolbox.
О том, как настроить localization library и провести onsite-тест, см. предварительный просмотр реального runtime-эффекта onsite.
Оценка по результатам отображения Toolbox
Mega Toolbox является одним из важнейших диагностических инструментов. Это отдельное мобильное App, которое помогает определить, исходит ли проблема от Mega или от вашего приложения.
Localization abnormal
Если в интерфейсе Toolbox отображается состояние, отличное от
FoundиNotFound, обратитесь к руководству по обработке ошибки localization.Localization successful
В интерфейсе Toolbox отображается
Found, и размещенный контент также отображается нормально.Нормальные ситуации:
- Контент относительно хорошо совпадает со сценой и медленно перемещается в течение некоторого времени.
- Если виртуальный контент выходит за определенный диапазон относительно сцены, он напрямую корректируется.
Аномальные ситуации:
- Контент в сцене постоянно дрейфует в одном направлении.
- Контент дрейфует в одном направлении, возвращается назад, затем снова дрейфует и снова возвращается.
- Контент становится все больше или все меньше.
- Контент в нескольких местах прыгает туда-сюда.
Классификация ошибок и диагностика
Используйте Toolbox для тестирования. По аномальному явлению можно посмотреть соответствующие рекомендации.
| Категория аномалии | Возможная причина | Рекомендация |
|---|---|---|
| Состояние устройства всегда показывает NotTracking | В среде нет заметных признаков, плохое освещение или слабая модель телефона | Определите, вызвано ли это средой или моделью телефона. Можно попробовать сменить тестовую область или модель телефона |
| Контент в сцене постоянно дрейфует в одном направлении | Слабая модель телефона, в SLAM есть drift | Попробуйте более хорошую модель телефона |
| Контент дрейфует в одном направлении, возвращается назад, затем снова дрейфует и снова возвращается | Слабая модель телефона, в SLAM есть drift | Попробуйте более хорошую модель телефона |
| Контент становится все больше или все меньше | Слабая модель телефона, в SLAM есть drift | Попробуйте более хорошую модель телефона |
| Контент в нескольких местах прыгает туда-сюда | Возможно, в сцене есть несколько похожих областей. При начале localization из этих областей может возникать помеха | Начинайте localization из другой уникальной области или используйте Bluetooth assistance |
Дополнительное тестирование
Чтобы лучше определить проблему, можно выполнить дополнительное тестирование следующими способами. Если вы разработчик, см. устройства и платформенные приложения, поддерживаемые Mega.
Тестирование на более хорошей модели телефона
Разные устройства отличаются по качеству tracking, в основном из-за качества камеры, точности датчиков и производительности процессора. Во время проверки в процессе создания рекомендуется тестировать на нескольких разных моделях, чтобы обеспечить совместимость. Если на устройствах ARKit или ARCore tracking работает нормально, значит проблема вызвана производительностью проблемного устройства. Для более слабых устройств можно попробовать разные режимы SLAM.
Выбор разных режимов SLAM
Для некоторых слабых моделей точность SLAM относительно низкая из-за точности датчиков телефона и вычислительной мощности. На странице onsite verification and diagnosis tool в Toolbox попробуйте выбрать разные режимы SLAM для тестирования. Можно выбрать FiveDof, ThreeDof или ZeroDof, чтобы увидеть разные эффекты tracking.
![]()
Ситуации, требующие обратной связи
Большинство аномалий tracking в процессе создания вызваны устройством, но следующие ситуации могут быть связаны с алгоритмом Block или проблемами сервиса. Рекомендуется обратиться в поддержку EasyAR:
- После тестирования на нескольких моделях и в нескольких областях частый drift все еще сохраняется.
- Toolbox не может выполнить localization или localization abnormal.
- Один и тот же Block показывает сильно различный эффект при разной погоде или освещении, и supplementary update не решает проблему.
Если проблемы остаются, передайте сотрудникам EasyAR описание onsite-проблемы, информацию об устройстве, запись экрана во время onsite runtime, EIF-файл и информацию сервиса Mega/диагностическую информацию Block. Перед отправкой обратной связи убедитесь в Mega Studio, что этот EIF воспроизводит проблему.
С помощью этого руководства вы можете быстро выявлять аномалии tracking на этапе создания и повышать общее качество Mega Block.