Table of Contents

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

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

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

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

Неудачное распознавание объекта

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

  • Проверьте качество модели: Убедитесь, что 3D-модель и объект соответствуют требованиям к форматам файлов, текстурам, геометрии и т.д., изложенным в Подготовка моделей.
  • Проверьте целевой объект: Убедитесь, что поверхность целевого объекта не отражает свет и не имеет зеркальных свойств.
  • Проверьте логи: Проверьте логи приложения, успешно ли загружена целевая модель.

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

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

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

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

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

  • Проверьте настройки ObjectTarget:
    • В зависимости от типа Source проверьте, указывает ли он на правильный файл в папке StreamingAssets.
    • Соответствует ли значение Scale фактическим размерам объекта (например, если вычисленный по файлу модели размер BoundingBox составляет 10 x 10 x 30, а реальный размер объекта - 0.1м x 0.1м x 0.3м, то Scale должен быть установлен в 0.01).
  • Проверьте иерархию префабов:
    • Виртуальный контент должен находиться на том же уровне, что и целевая 3D-модель, и оба должны быть дочерними элементами ObjectTarget. Виртуальный контент не должен быть отключен (disabled).
    • В свойстве Rotation целевой 3D-модели значение оси Y должно быть установлено в 180.
    • Размещение виртуального контента должно полностью основываться на положении целевой 3D-модели.

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

  • Сбросьте настройки: Удалите и заново создайте ObjectTarget на сцене, перетащите префаб по правилам и привяжите 3D-модель.
  • Проверьте логи: Ищите ошибки, связанные с ObjectTargetController, например fail to load target data.

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

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

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

Если это так, возможно, вы используете пробную версию лицензии (trial License).

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

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

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

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

  • Проверьте настройки ближней и дальней плоскостей отсечения (Near/Far Clipping Planes): Убедитесь, что установленные вами значения для ближней и дальней плоскостей отсечения при рендеринге виртуального контента находятся в разумных пределах.
  • Проверьте размер модели контента: Слишком большая модель контента при приближении камеры может привести к "продавливанию" (clipping) и невидимости контента. Слишком маленькая модель при удалении камеры может стать незаметной из-за малого размера.

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

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

Резюме и лучшие практики

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

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

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