Table of Contents

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

Al utilizar el reconocimiento en la nube de imágenes, puede encontrar problemas donde el contenido virtual no se muestra o activa. Este artículo proporciona un método sistemático de solución de problemas. Es importante recordar que, en la mayoría de los casos, las razones del fallo del reconocimiento en la nube son idénticas a las del fallo del reconocimiento local. Consulte el capítulo Solución de problemas del seguimiento de imágenes planas. Aquí solo se complementan los 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: La solicitud de reconocimiento se envía sin respuesta o devuelve un código de error.
Método de solución:

  • Verifique si el dispositivo está conectado a Internet (Wi-Fi/4G/5G), intente abrir una página web para confirmar.
  • Compruebe si la aplicación tiene permisos de acceso a Internet activados.
  • Capture registros de errores de red en el código.
  • Pruebe la conectividad de la API CRS en un navegador (consulte: Comprobación de estado | GET /ping).

Sugerencias de mejora:

  • Añadir detección del estado de la red dentro de la aplicación, con avisos en caso de red débil.
  • Configurar reintentos tras tiempo de espera agotado o degradación al seguimiento local.

Error de configuración del servicio

Síntoma: La solicitud de reconocimiento es rechazada, devuelve Unauthorized o Invalid Key.
Método de solución:

  • Verifique que la CRS API Key y Secret ingresadas en el código sean correctas.
  • Asegúrese de que la URL de Client-end ingresada en el código no sea incorrecta (por ejemplo, que no se haya ingresado por error la URL de Server-end).
  • Confirme que la License Key está activa y no ha expirado (ver en el centro de cuentas del sitio web de EasyAR).

Sugerencias de mejora:

  • Utilice el botón Copiar en la galería CRS para copiar su configuración de servicio relevante, asegurando que se ingrese correctamente.

Error de configuración de biblioteca de objetivos/aplicación

Síntoma: Una imagen objetivo que antes se reconocía sin problemas, ahora falla al solicitar reconocimiento.
Método de solución:

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

Sugerencias de mejora:

  • Cuando haya actualizaciones/cambios en la galería en la nube, asegúrese de que el objetivo específico de la aplicación esté siempre activo.
  • Verificación cuidadosa del código.

Fallo de carga local en modo híbrido

Síntoma: El reconocimiento en la nube es exitoso, pero el seguimiento local no se inicia y el contenido no se muestra.
Método de solución:

  • Confirme que la carga local del ImageTarget no lanzó excepciones (revise los registros).
  • Verifique si el ImageTracker está habilitado.

Sugerencias de mejora:

  • Envuelva la lógica de carga local en try-catch para capturar excepciones y reintentar.
  • Asegúrese de que el contenido virtual sea un objeto secundario de ImageTarget y no esté deshabilitado.

Resumen y mejores prácticas

Los problemas de contenido no mostrado en el reconocimiento en la nube se centran principalmente en tres aspectos: red, configuración del servicio y estado del objetivo. El modo híbrido requiere atención adicional al proceso de carga local. Se recomienda priorizar la solución de problemas en este orden:

  1. Verificar la conexión de red y la conectividad con el servicio CRS;
  2. Comprobar la configuración del servicio: License, API Key/Secret, URL de Client-end.
  3. Verificar el estado de la imagen objetivo en la galería CRS, asegurando que el ID del objetivo coincida entre la galería y la aplicación;

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