Table of Contents

Preguntas frecuentes de CRS

A continuación se presentan preguntas y respuestas comunes sobre el uso de la función de reconocimiento de imágenes en la nube.

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

R: Sí, CRS admite cargar modelos 3D/contenido virtual mediante:

  • Propiedad meta: Almacenar contenido AR en el campo meta de la imagen objetivo como archivo de texto. Los modelos 3D pueden codificarse en texto mediante Base64 o guardarse como URL en almacenamiento en la nube (por ejemplo, Alibaba Cloud OSS, AWS S3).
  • Flujo de carga: Después de que el cliente obtenga los datos meta de CRS, utiliza un motor 3D (como Unity, Three.js) para analizar y cargar el modelo.
  • Documentación de referencia: Consulte Crear objetivo de reconocimiento | POST /targets.
Nota

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

Q: ¿CRS tiene límite de veces de reconocimiento?

R: No hay un límite total de reconocimientos, pero existen niveles de concurrencia:

  • Modo básico: Adecuado para aplicaciones con QPS < 50. Sin límites estrictos, pero debe cumplir con el principio de uso justo.
  • Modo de alta concurrencia: Cuando QPS ≥ 50, se recomienda actualizar al servicio en la nube con recursos dedicados para garantizar la estabilidad y baja latencia del reconocimiento.
Importante

Si su aplicación puede enfrentar picos temporales de concurrencia durante festivos o eventos importantes, contacte al soporte técnico de Easyar con al menos 3 días hábiles de anticipación para solicitar una actualización del servicio.

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

R: El error 404 generalmente indica que la ruta URL solicitada no existe o que no se encontró el recurso. Causas comunes:

  • Formato de URL incorrecto: Acceso a un endpoint inexistente. Ejemplo: Acceder directamente a http://your_crs_uuid.na1.crs.easyar.com:8888 es inválido; debe usar endpoints completos como http://your_crs_uuid.na1.crs.easyar.com:8888/ping.
  • Resultados de reconocimiento vacíos: Al llamar a la interfaz /search, si no se encuentra ningún objetivo coincidente, también devolverá 404 con el cuerpo No result: there is no matching.

Pasos para diagnosticar:

  1. Confirme que la URL esté escrita correctamente, incluyendo UUID y puerto.
  2. Use la interfaz /ping para probar la disponibilidad del servicio.
  3. Verifique que los parámetros de la solicitud estén completos (por ejemplo, datos de imagen, API Key).

Solución recomendada: Si /search devuelve 404, significa que la imagen actual no coincide con ningún objetivo. Guíe al usuario para ajustar el ángulo de captura o verifique si el objetivo se ha subido a CRS.

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

R: Además del 404, estos códigos son comunes:

  • 400 invalid appId (appKey)

    • Causa: La Key solicitada es incorrecta o falló la verificación de firma.
    • Diagnóstico: Confirme si su Key se copió desde la galería CRS; si la solicitud POST incluye firma completa; si los parámetros usan Content-Type: application/json.

  • 400 invalid date

    • Causa: La marca de tiempo de la solicitud es inválida o tiene una desviación excesiva con el servidor (generalmente se requiere ±5 minutos).
    • Diagnóstico: Verifique la precisión de la hora del dispositivo (especialmente la zona horaria).

  • 415 unsupported media type

    • Causa: El encabezado HTTP no tiene Content-Type: application/json o el cuerpo de la solicitud tiene formato incorrecto.
    • Diagnóstico: Asegúrese de que las solicitudes POST incluyan Content-Type: application/json en el encabezado y que el cuerpo sea JSON válido.

Recomendación general: Todas las solicitudes a la API CRS deben seguir estrictamente la Documentación de la API CRS.

Nota: Estas preguntas frecuentes cubren problemas comunes de CRS. Para reportar nuevos problemas, ¡contáctenos en contactus!