Table of Contents

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

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

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

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

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

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

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

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

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

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

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

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

  • Используйте кнопку Copy в CRS image library, чтобы скопировать соответствующую конфигурацию сервиса и убедиться, что она заполнена правильно.

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

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

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

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

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

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

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

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

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

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

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

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

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

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