Table of Contents

Диагностика и устранение: дрожание контента

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

Различия "нормального дрожания"

Понимание следующих ситуаций поможет избежать избыточной оптимизации или ошибочной диагностики:

Незначительное смещение (норма)

  • Проявление: легкое плавание или медленное вращение виртуального контента на несколько пикселей.
  • Сценарии:
    • Неравномерное освещение (например, перепады света в помещении)
    • Автофокус или автоматическая регулировка экспозиции камеры
    • Легкое дрожание рук с устройством (без штатива)
  • Ожидание: такие сценарии сложно избежать, специальная обработка не требуется.

Кратковременное дрожание (норма)

  • Проявление: виртуальный контент дрожит 0.5~1 секунду при быстром перемещении устройства или целевого изображения, затем стабилизируется.
  • Сценарии:
    • Переход от статики к движению
    • Начальная стадия распознавания при попадании изображения в поле зрения
  • Ожидание: часть процесса сходимости алгоритма, нормально, если восстанавливается в короткий срок.

Дрожание на границах (норма)

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

Распространенные причины аномального дрожания и улучшения

Следующие типы дрожания являются проблемой и требуют целенаправленного решения:

Низкое качество целевого изображения

Симптомы: постоянное высокочастотное дрожание контента, беспорядочные скачки или частая потеря трекинга.
Диагностика:

Рекомендации:

  • Оптимизируйте изображение:
    • Увеличьте локальную контрастность.
    • Избегайте однотонных областей, добавьте мелкие текстуры.
    • Избегайте повторяющихся текстур.

Недостаточная производительность оборудования

Симптомы: заметно более сильное дрожание или потеря трекинга на слабых устройствах по сравнению с флагманами.
Диагностика:

  • Проверьте загрузку CPU: используйте инструмент Profiler для мониторинга загрузки CPU приложения.

Рекомендации:

  • Включите режим производительности: установите ImageTrackerMode в PreferPerformance (пожертвуйте небольшой точностью ради плавности).
  • Уменьшите количество треков: если включен одновременный трекинг нескольких целей, сократите параметр Simultaneous Number.
  • Адаптируйте под платформу: предоставьте упрощенную версию сцены для слабых устройств.

Помехи от окружения

Симптомы: дрожание проявляется только при определенном освещении или фоне, исчезает при их смене.
Диагностика:

  • Тест освещения: протестируйте при равномерном (например, пасмурно) и контрастном (яркий свет/тени) освещении.
  • Фоновые помехи: проверьте, не слишком ли динамичен фон в кадре (например, движение людей).
  • Отражения: имеет ли физическая поверхность целевого изображения блики (например, стекло, металл).

Рекомендации:

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

Локальное дрожание контента

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

  • Уменьшение масштаба: уменьшите общий Scale виртуального контента и повторите тест в тех же условиях.

Рекомендации:

  • Корректировка контента: слишком крупный виртуальный контент усиливает угловую погрешность на удалении (например, погрешность 0.1° вызывает смещение 0.1см вблизи, но 10см вдали). При проектировании соизмеряйте виртуальные размеры с физическими размерами целевого изображения.

Итоги и лучшие практики

Дрожание контента требует разделения на нормальное и аномальное. Нормальное (незначительное смещение, кратковременное восстановление) не требует действий; аномальное (высокочастотные скачки, частые потери) ухудшает UX и требует внимания. Рекомендуемая последовательность диагностики:

  1. Проверьте качество целевого изображения;
  2. Убедитесь, что проблема проявляется только на слабых устройствах;
  3. Исключите помехи окружения (освещение, динамичные сцены, блики);
  4. Проверьте, не слишком ли крупен виртуальный контент.

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