Table of Contents

Диагностика и исправление: контент не отображается

Эта статья рассматривает распространенные проблемы, при которых виртуальный контент не отображается при planar image tracking. Она предлагает системные методы troubleshooting и рекомендации по улучшению, чтобы помочь разработчикам быстро найти и решить проблему.

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

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

Ошибка image recognition

Симптом: после наведения камеры на target image виртуальный контент вообще не появляется. Troubleshooting:

  • Проверьте recognition score изображения: используйте target image detection tool, чтобы загрузить image и подтвердить recognition score, который должен достигать 4-5 звезд.
  • Проверьте качество image: убедитесь, что image соответствует требованиям к texture, размеру и пропорциям в best practices.
  • Проверьте target image entity: убедитесь, что поверхность target image entity, например плаката или карточки, не отражает свет, остается ровной и не сложена.
  • Просмотрите logs: проверьте application logs, найдите событие TargetLoad и подтвердите, что target image успешно загружена.

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

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

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

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

Troubleshooting:

  • Проверьте конфигурацию ImageTarget:
    • Проверьте, указывает ли она на правильный файл в папке StreamingAssets согласно типу Source.
    • Проверьте, установлен ли Scale в соответствии с фактическим физическим размером.
  • Подтвердите hierarchy prefab: виртуальный контент, например Cube, должен быть child node ImageTarget и не должен быть disabled.

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

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

Проблемы permission

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

  • Использование XR headset
  • Использование custom camera
  • Использование AR Engine/ARFoundation на телефоне

Если это один из указанных случаев, возможно, вы используете trial License.

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

  • Используйте официальную License.

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

Симптом: контент сначала отображается нормально, но его не видно, когда камера очень близко или далеко от target object. Troubleshooting:

  • Проверьте near и far clipping settings: убедитесь, что near и far clipping settings при rendering виртуального контента находятся в разумном диапазоне.
  • Проверьте размер content model: если content model слишком велика, приближение к target object может привести к прохождению камеры сквозь модель и сделать контент невидимым; если content model слишком мала, удаление от target object может сделать отображение слишком маленьким и нечетким.

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

  • Установите подходящие near и far clipping.
  • Физический размер виртуального контента должен быть подходящим относительно target image entity.

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

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

  1. Проверьте, является ли License официальной версией;
  2. Проверьте, подходит ли сам виртуальный контент;
  3. Проверьте качество target image;
  4. Подтвердите, есть ли проблемы в реализации программы или конфигурации разработки.

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