Table of Contents

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

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

Распространенные причины и методы диагностики

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

Сбой распознавания изображения

Симптомы: Виртуальный контент не появляется после наведения камеры на целевое изображение.
Методы диагностики:

  • Проверка распознаваемости изображения: Используйте инструмент оценки целевых изображений, загрузите изображение и убедитесь, что оценка распознаваемости составляет 4-5 звезд.
  • Проверка качества изображения: Убедитесь, что изображение соответствует требованиям к текстуре, размеру и пропорциям из лучших практик.
  • Проверка физического носителя: Убедитесь, что поверхность физического носителя (плакат, карточка и т.д.) не бликует, ровная, без складок.
  • Анализ логов: Проверьте логи приложения, найдите события TargetLoad, подтвердите успешную загрузку целевого изображения.

Рекомендации по улучшению:

  • Оптимизация изображения: Увеличьте контраст, избегайте повторяющихся узоров, убедитесь, что основной объект занимает >70% площади.
  • Замена изображения: Если проблема сохраняется после оптимизации, используйте тестовое изображение из официального Sample (например, namecard.jpg) для проверки.
  • Физический носитель: Используйте матовые или шероховатые поверхности, обеспечьте ровность без изгибов.
  • Проверка логики: Убедитесь, что приложение корректно загружает используемое целевое изображение.

Ошибки реализации функций

Симптомы: Изображение распознано, но виртуальный контент не отображается или расположен некорректно.

Методы диагностики:

  • Проверка конфигурации ImageTarget:
    • Убедитесь, что Source указывает на корректный файл в папке StreamingAssets.
    • Проверьте, установлен ли Scale в соответствии с реальными физическими размерами.
  • Проверка иерархии префаба: Виртуальный контент (например, Cube) должен быть дочерним объектом ImageTarget и не отключен.

Рекомендации по улучшению:

  • Сброс конфигурации: Удалите и заново создайте ImageTarget на сцене, перетащите префаб по инструкции и привяжите изображение.
  • Упрощение теста: Временно удалите пользовательские скрипты, оставьте только базовый Cube, проверьте минимально рабочую сцену.
  • Анализ логов: Ищите ошибки, связанные с ImageTargetController, например fail to load target data.

Проблемы с правами доступа (License)

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

  • Использование на гарнитуре XR
  • Использование пользовательской камеры
  • Использование AR Engine/ARFoundation на смартфоне

Если да, возможно, вы используете пробную версию License.

Рекомендации по улучшению:

  • Используйте коммерческую (полную) версию License.

Проблемы с виртуальным контентом

Симптомы: Контент отображается нормально, но исчезает при очень близком/далеком положении камеры от цели.
Методы диагностики:

  • Проверка плоскостей отсечения (near/far clip planes): Убедитесь, что настройки ближней и дальней плоскостей отсечения при рендеринге находятся в разумных пределах.
  • Проверка размера модели контента: Слишком большая модель может привести к "прохождению сквозь объект" при приближении; слишком маленькая модель может стать неразличимой при отдалении.

Рекомендации по улучшению:

  • Установите подходящие значения near/far clip planes.
  • Убедитесь, что размер виртуального контента пропорционален физическому размеру носителя целевого изображения.

Заключение и лучшие практики

Проблемы с отображением контента обычно вызваны изображением, реализацией кода, правами доступа (License) или самим контентом. Рекомендуется диагностировать в следующем порядке:

  1. Проверьте, используется ли коммерческая (полная) версия License.
  2. Проверьте адекватность самого виртуального контента.
  3. Проверьте качество целевого изображения.
  4. Убедитесь в отсутствии ошибок в реализации кода или конфигурации разработки.

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