Table of Contents

Часто задаваемые вопросы CRS

Ниже приведены распространенные вопросы и ответы при использовании функции cloud image recognition.

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

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

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

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

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

A: Общего ограничения на количество распознаваний нет, но существуют уровни concurrency:

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

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

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

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

  • Неверный формат URL: был выполнен доступ к несуществующему endpoint. Например, прямой доступ к http://your_crs_uuid.na1.crs.easyar.com:8888 недействителен. Используйте полный endpoint, например 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.

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

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

  • 400 invalid appId (appKey)

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

  • 400 invalid date

    • Причина: timestamp запроса недействителен или слишком сильно отличается от времени сервера, обычно требуется в пределах +/-5 минут.
    • Проверка: проверьте точность времени устройства, особенно настройки часового пояса.

  • 415 unsupported media type

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

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

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