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

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

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

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

Ошибка object recognition

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

• Проверьте качество модели: убедитесь, что 3D model и object соответствуют требованиям file format, texture, geometry и другим требованиям в model preparation.
• Проверьте target object: убедитесь, что поверхность target object не имеет отражающего или зеркального материала.
• Просмотрите logs: проверьте application logs и убедитесь, что target model успешно загружена.

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

• Оптимизируйте модель: убедитесь, что texture достаточно богата, а geometry не имеет отверстий.
• Проверьте логику: убедитесь, что приложение корректно загрузило target model. Если загрузка не удалась, обратитесь к разделу target loading failure для проверки и исправления.

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

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

• Unity
• Native

Troubleshooting:

• Проверьте конфигурацию ObjectTarget:
  • Проверьте, указывает ли она на правильный файл в папке StreamingAssets согласно типу Source.
  • Проверьте, был ли Scale изменен согласно фактическому размеру object. Например, если размер BoundingBox, рассчитанный из файла модели, равен 10 x 10 x 30, а фактический размер object равен 0.1m x 0.1m x 0.3m, то Scale следует установить в 0.01.
• Подтвердите hierarchy prefab:
  • Виртуальный контент должен находиться на одном уровне с target 3D model, и оба должны быть дочерними узлами ObjectTarget. Виртуальный контент не должен быть disabled.
  • У свойства Rotation target 3D model направление Y нужно установить в 180.
  • Размещение виртуального контента должно полностью учитывать позицию target 3D model.

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

• Сбросьте конфигурацию: удалите и заново создайте ObjectTarget в scene, перетащите prefab согласно спецификации и привяжите 3D model.
• Проверьте logs: ищите ошибки, связанные с ObjectTargetController, например 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 object.

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

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

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

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