Table of Contents

Solución de problemas: el contenido no se muestra/activa

Al utilizar el reconocimiento de imágenes en la nube, puede encontrarse con un problema en el que el contenido virtual no se muestra o no se activa. Este artículo proporciona un método sistemático de solución de problemas. Tenga en cuenta que, en la mayoría de los casos, las causas del fallo del reconocimiento de imágenes en la nube son exactamente las mismas que las del fallo del reconocimiento local. Puede consultar la sección Solución de problemas del seguimiento de imágenes planas. Aquí solo se añaden problemas y soluciones específicos del reconocimiento en la nube.

Causas comunes y métodos de solución de problemas

Problemas de conexión de red

Síntoma: No hay respuesta después de enviar una solicitud de reconocimiento, o se devuelve un código de error.
Métodos de solución de problemas:

  • Compruebe si el dispositivo está conectado a la red (Wi-Fi/4G/5G) e intente abrir una página web para verificarlo.
  • Compruebe si la aplicación tiene habilitado el permiso de red.
  • Capture logs de errores de red en el código.
  • Pruebe la conectividad de CRS API en un navegador (referencia: Health check | GET /ping).

Sugerencias de mejora:

  • Añada detección del estado de red en la aplicación y muestre avisos cuando la red sea débil.
  • Configure un timeout de solicitud y luego reintente o cambie a seguimiento local.

Errores de configuración del servicio

Síntoma: La solicitud de reconocimiento se rechaza y devuelve Unauthorized o Invalid Key.
Métodos de solución de problemas:

  • Compruebe si el CRS API Key y el Secret rellenados en el código son correctos.
  • Compruebe que el Client-end URL rellenado en el código no sea incorrecto (por ejemplo, introducido por error como Server-end URL).
  • Confirme que el License Key esté activado y no haya caducado (compruébelo en el centro de cuenta del sitio web oficial de EasyAR).

Sugerencias de mejora:

  • Use el botón Copy en la CRS image library para copiar la configuración de servicio relacionada y asegurarse de que se rellene correctamente.

Errores de configuración de la biblioteca de targets/aplicación

Síntoma: Una imagen target se reconocía correctamente antes, pero ahora la solicitud de reconocimiento falla.
Métodos de solución de problemas:

  • Obtenga el estado del target mediante CRS API y confirme que la imagen target está en estado "activated" ("active":"1").
  • Compruebe si el target ID coincide exactamente con el del código (distingue mayúsculas y minúsculas).

Sugerencias de mejora:

  • Cuando la biblioteca de imágenes en la nube se actualice/cambie, asegúrese de que los targets específicos usados por la aplicación estén siempre activados.
  • Revise cuidadosamente el código.

Error de carga local en modo híbrido

Síntoma: El reconocimiento en la nube tiene éxito, pero el seguimiento local no se inicia y el contenido no se muestra.
Métodos de solución de problemas:

  • Confirme que no se lance ninguna excepción al cargar el ImageTarget local (revise los logs).
  • Verifique si ImageTracker está habilitado.

Sugerencias de mejora:

  • Envuelva la lógica de carga local con try-catch, capture excepciones y reintente.
  • Asegúrese de que el contenido virtual sea un objeto hijo de ImageTarget y no esté deshabilitado.

Resumen y mejores prácticas

Los problemas en los que el contenido de reconocimiento en la nube no se muestra se concentran principalmente en tres aspectos: red, configuración del servicio y estado del target. En modo híbrido también debe prestarse atención a la carga local. Se recomienda solucionar problemas en el siguiente orden:

  1. Compruebe la conexión de red y confirme la conectividad del servicio CRS;
  2. Compruebe la configuración del servicio, como License, API Key/Secret y Client-end URL.
  3. Compruebe el estado de la imagen target en CRS image library y asegúrese de que la biblioteca de imágenes coincida con el target ID de la aplicación;

Si el problema es complejo, habilite los logs de depuración de EasyAR o contacte con el soporte técnico.