Table of Contents

Устранение неполадок: контент не отображается/не активируется

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

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

Проблемы с сетевым подключением

Симптомы: Отсутствие ответа после отправки запроса на распознавание или возврат кода ошибки.
Методы устранения:

  • Проверьте подключение устройства к интернету (Wi-Fi/4G/5G), попробуйте открыть веб-страницу для проверки.
  • Проверьте, предоставлено ли приложению разрешение на доступ к сети.
  • Перехватывайте журналы сетевых ошибок в коде.
  • Проверьте доступность API CRS в браузере (ссылка: Проверка работоспособности | GET /ping).

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

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

Ошибки конфигурации сервиса

Симптомы: Запрос на распознавание отклонен с возвратом Unauthorized или Invalid Key.
Методы устранения:

  • Проверьте правильность введенных в коде CRS API Key и Secret.
  • Убедитесь, что в коде указан корректный Client-end URL (например, не указан Server-end URL по ошибке).
  • Убедитесь, что License Key активирован и не истек (проверьте в личном кабинете на сайте EasyAR).

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

  • Используйте кнопку Копировать в библиотеке CRS для копирования настроек сервиса, чтобы обеспечить их точность.

Ошибки конфигурации библиотеки целей/приложения

Симптомы: Определенное целевое изображение ранее распознавалось нормально, но теперь запросы на распознавание завершаются сбоем.
Методы устранения:

  • Проверьте статус целевого изображения через API CRS, убедитесь, что цель находится в статусе "Активирована" ("active":"1").
  • Убедитесь, что ID цели в коде полностью совпадает с ID в системе (с учетом регистра).

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

  • При обновлении/изменении облачной библиотеки изображений убедитесь, что целевые изображения в приложении всегда активированы.
  • Тщательная проверка кода.

Сбой локальной загрузки в гибридном режиме

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

  • Убедитесь, что при загрузке локального ImageTarget не возникает исключений (проверьте журналы).
  • Проверьте, активирован ли ImageTracker.

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

  • Оберните логику локальной загрузки в try-catch, перехватывайте исключения и повторите попытку.
  • Убедитесь, что виртуальный контент является дочерним объектом ImageTarget и не отключен.

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

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

  1. Проверьте сетевое подключение и доступность сервиса CRS;
  2. Проверьте настройки сервиса: License, API Key/Secret, Client-end URL.
  3. Проверьте статус целевых изображений в библиотеке CRS, убедитесь в совпадении ID целей в библиотеке и приложении;

В случае сложных проблем активируйте журналы отладки EasyAR или обратитесь в техническую поддержку.