Table of Contents

Вопросы и ответы по CRS

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

Вопрос: Поддерживает ли CRS загрузку 3D-моделей/виртуального контента из облака?

Ответ: Да, CRS поддерживает загрузку 3D-моделей/виртуального контента следующими способами:

  • Мета-свойство: AR-контент хранится в поле meta целевого изображения в виде текстового файла. 3D-модель может быть закодирована в Base64 как текст или сохранена в виде URL в облачном хранилище (например, Alibaba Cloud OSS, AWS S3).
  • Процесс загрузки: После получения данных meta от CRS клиент использует 3D-движок (например, Unity, Three.js) для анализа и загрузки модели.
  • Документация: Подробнее см. Создание цели распознавания | POST /targets.
Примечание

Для больших файлов (>2 МБ) используйте способ с URL, чтобы избежать увеличения тела запроса из-за кодирования Base64.

Вопрос: Есть ли ограничение на количество распознаваний в CRS?

Ответ: Нет общего ограничения на количество распознаваний, но существует градация по параллельным запросам:

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

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

Вопрос: Почему Web Service API возвращает 404?

Ответ: Ошибка 404 обычно означает, что запрошенный URL-путь не существует или ресурс не найден. Распространенные причины:

  • Неправильный формат URL: Обращение к несуществующей конечной точке. Например: прямой доступ к http://your_crs_uuid.na1.crs.easyar.com:8888 недопустим, следует использовать полную конечную точку, например http://your_crs_uuid.na1.crs.easyar.com:8888/ping.
  • Пустой результат распознавания: При вызове интерфейса /search, если не найдено ни одного совпадения с целью, также возвращается 404, с телом сообщения No result: there is no matching.

Шаги по устранению неполадок:

  1. Убедитесь, что URL написан правильно, включая UUID и порт.
  2. Используйте интерфейс /ping для проверки доступности службы.
  3. Проверьте, все ли параметры запроса указаны (например, данные изображения, API Key).

Рекомендация: Если /search возвращает 404, это означает, что текущее изображение не совпало ни с одной целью. Можно предложить пользователю изменить угол съемки или проверить, загружена ли цель в CRS.

Вопрос: Каковы распространенные причины кодов ошибок Web Service API?

Ответ: Помимо 404, часто встречаются следующие коды ошибок:

  • 400 invalid appId (appKey)

    • Причина: Указанный Key неверен или не прошла проверка подписи.
    • Устранение: Убедитесь, что ваш Key скопирован из галереи CRS; содержит ли POST-запрос полную подпись; используются ли параметры запроса с Content-Type: application/json.

  • 400 invalid date

    • Причина: Неверная временная метка запроса или ее отклонение от времени сервера слишком велико (обычно допускается ±5 минут).
    • Устранение: Проверьте точность времени на устройстве (особенно настройки часового пояса).

  • 415 unsupported media type

    • Причина: В HTTP-заголовке не установлен Content-Type: application/json или неверный формат тела запроса.
    • Устранение: Убедитесь, что POST-запрос содержит в заголовке Content-Type: application/json, а тело является допустимым JSON.

Общая рекомендация: Все запросы к API CRS должны строго соответствовать документации CRS API.

Примечание: Данные Вопросы и ответы охватывают часто встречающиеся проблемы при использовании CRS. Если вы столкнулись с новой проблемой, сообщите о ней и свяжитесь с нами!