Table of Contents

Preguntas frecuentes de CRS

A continuación se muestran preguntas y respuestas comunes durante el uso de la función cloud image recognition.

Q: ¿CRS admite cargar modelos 3D/contenido virtual desde la nube?

A: Sí. CRS admite cargar modelos 3D/contenido virtual de las siguientes formas:

  • Propiedad meta: almacene contenido AR en el campo meta de la imagen target, en formato de archivo de texto. Los modelos 3D pueden codificarse como texto mediante Base64, o guardarse como URL de almacenamiento en la nube, como Alibaba Cloud OSS o AWS S3.
  • Proceso de carga: después de que el cliente obtiene los datos meta desde CRS, usa un 3D engine, como Unity o Three.js, para analizar y cargar el modelo.
  • Documentación de referencia: consulte Crear target de reconocimiento | POST /targets.
Nota

Para archivos grandes (>2MB), use el método URL para evitar que el request body sea demasiado grande debido a la codificación Base64.

Q: ¿CRS tiene límite de número de reconocimientos?

A: No hay límite total de número de reconocimientos, pero existen niveles de concurrency:

  • Modo básico: adecuado para aplicaciones con QPS < 50. No hay límite rígido, pero debe cumplirse el principio de fair use.
  • Modo de alta concurrency: cuando QPS >= 50, se recomienda actualizar a un servicio cloud de recursos dedicados para garantizar estabilidad de reconocimiento y baja latencia.
Importante

Si su aplicación puede enfrentar un aumento temporal de concurrency durante feriados o grandes eventos, contacte con soporte técnico de EasyAR con al menos 3 días laborables de anticipación para solicitar una actualización del servicio.

Q: ¿Por qué Web Service API devuelve 404?

A: Un error 404 normalmente indica que la ruta URL solicitada no existe o que no se encontró el recurso. Las causas comunes son:

  • Formato de URL incorrecto: se accedió a un endpoint que no existe. Por ejemplo, acceder directamente a http://your_crs_uuid.na1.crs.easyar.com:8888 no es válido. Use un endpoint completo como http://your_crs_uuid.na1.crs.easyar.com:8888/ping.
  • Resultado de reconocimiento vacío: al llamar a la interfaz /search, si no coincide ningún target, también se devuelve 404, con el message body No result: there is no matching.

Pasos de diagnóstico:

  1. Confirme que la URL esté escrita correctamente, incluidos UUID y puerto.
  2. Use la interfaz /ping para probar la disponibilidad del servicio.
  3. Compruebe si los parámetros de solicitud están completos, como datos de imagen y API Key.

Sugerencia de solución: si /search devuelve 404, significa que la imagen actual no coincide con ningún target. Puede guiar al usuario para ajustar el ángulo de captura o comprobar si el target se ha subido a CRS.

Q: ¿Cuáles son las causas comunes de los códigos de error devueltos por Web Service API?

A: Además de 404, los siguientes códigos de error son comunes:

  • 400 invalid appId (appKey)

    • Causa: el Key solicitado es incorrecto, o la verificación de firma falló.
    • Diagnóstico: confirme si su Key se copió desde la CRS image library; si la solicitud POST contiene una firma completa; y si los parámetros de solicitud usan Content-Type: application/json.

  • 400 invalid date

    • Causa: el timestamp de la solicitud es inválido o difiere demasiado de la hora del servidor, normalmente debe estar dentro de +/-5 minutos.
    • Diagnóstico: compruebe si la hora del dispositivo es correcta, prestando especial atención a la configuración de zona horaria.

  • 415 unsupported media type

    • Causa: el HTTP Header no establece Content-Type: application/json, o el formato del request body es incorrecto.
    • Diagnóstico: asegúrese de que el Header de la solicitud POST contenga Content-Type: application/json y que el Body sea JSON válido.

Sugerencia general: todas las solicitudes CRS API deben seguir estrictamente la documentación CRS API.

Nota: Las FAQ anteriores cubren problemas frecuentes en el uso de CRS. Si necesita reportar un nuevo problema, no dude en enviar feedback y contactarnos.