Table of Contents

Introducción a la Cloud Recognition de imágenes

Esta guía presenta los principios básicos de la función de Cloud Recognition de EasyAR CRS (Cloud Recognition Service), sus resultados esperados y sus diferencias con el seguimiento local de imágenes planas, para ayudar a los desarrolladores a entender sus escenarios de uso y limitaciones.

Principios básicos

Cloud Recognition es una solución que traslada el proceso de reconocimiento a la nube, adecuada para escenarios con grandes bibliotecas de objetivos o que requieren actualizaciones dinámicas. Su flujo principal es el siguiente:

Gestión de la biblioteca

  1. Crear una biblioteca: sube tus imágenes objetivo en la consola de CRS. El sistema calculará automáticamente las características visuales de la imagen objetivo y la añadirá como un Target a la base de datos de backend.
  2. Operaciones CRUD: en la consola de CRS puedes crear, eliminar, modificar y consultar tu biblioteca de objetivos. Una vez realizadas las operaciones, el cliente puede seguir usándose sin actualizar la aplicación.
Importante

Los requisitos de calidad de imagen para las imágenes objetivo usadas en Cloud Recognition son exactamente los mismos que en el seguimiento local de imágenes planas. Consulta Buenas prácticas para imágenes objetivo.

Flujo de reconocimiento

  1. Subida de imagen: el cliente captura la imagen actual con la cámara y envía los datos de imagen al servicio EasyAR CRS.
  2. Coincidencia en la nube: el servidor busca rápidamente en la biblioteca de objetivos en la nube y coincide con los datos Target prealmacenados (es decir, las imágenes objetivo subidas por el desarrollador).
  3. Devolución del resultado: cuando la coincidencia tiene éxito, la nube devuelve al cliente el resultado del reconocimiento (ID del objetivo, imagen objetivo, etc.), y el cliente lo usa para mostrar contenido virtual o continuar con el seguimiento posterior usando la imagen.

Diferencias con el seguimiento local de imágenes planas

Característica Seguimiento local de imágenes planas Cloud Recognition
Cálculo del reconocimiento Se realiza localmente en el dispositivo Se realiza en el servidor en la nube
Tamaño de la biblioteca Limitado por la memoria y el tiempo de carga; normalmente no se recomienda superar 100 imágenes Hasta 100.000 imágenes objetivo por biblioteca, ampliable a escala de cientos de millones
Actualización de objetivos Requiere volver a empaquetar y distribuir la aplicación Se sube en tiempo real y surte efecto de inmediato
Dependencia de red No requiere red (usable sin conexión) Requiere conexión (las solicitudes de reconocimiento necesitan red)
Enfoque funcional Reconoce y sigue de forma continua (salida de pose 6DoF) Reconocimiento puntual (coincidencia de objetivos)

Aclaraciones clave:

  • Reconocimiento: solo completa la coincidencia de “qué objetivo es este” y no proporciona seguimiento continuo. Si necesitas seguimiento, debes combinarlo con el seguimiento local de imágenes planas.
  • Escenarios de uso: muchos objetivos (por ejemplo, catálogos de productos o libros infantiles), actualizaciones frecuentes (por ejemplo, carteles de eventos) o una necesidad funcional simple (por ejemplo, solo reconocer y no seguir).

Uso y gestión del servicio

EasyAR CRS ofrece una solución de gestión de objetivos en la nube flexible y segura, que cubre desde desarrolladores individuales hasta aplicaciones empresariales.

Aislamiento y seguridad de bibliotecas

  • Soporte de múltiples bibliotecas: puedes crear varias bibliotecas CRS independientes; están completamente aisladas entre sí y los objetivos no entran en conflicto. Por ejemplo:
    • Biblioteca A: para campañas de marketing, almacena carteles de productos.
    • Biblioteca B: para formación educativa, almacena ilustraciones didácticas.
  • Mecanismo de seguridad: cada biblioteca se accede con una API Key y un Secret únicos, lo que garantiza la seguridad de los datos.

Selección del modo de concurrencia

Según la escala de la aplicación y las necesidades de escaneo, CRS ofrece dos modos de concurrencia:

Modo Escenario Características Método de activación
Concurrencia básica Aplicaciones AR con QPS < 50, escaneo general Activación autoservicio, estable y fiable Solicitud en línea en la consola de CRS
Alta concurrencia Aplicaciones AR con QPS ≥ 50, gran volumen de escaneos Recursos dedicados y baja latencia Contacta con soporte técnico de EasyAR para evaluación y activación
Consejo

En proyectos nuevos o en fase de pruebas puedes elegir el modo básico; tras el lanzamiento, decide si actualizar según el tráfico real (por ejemplo, monitorizando el QPS de solicitudes de reconocimiento).

Gestión de bibliotecas y API

  • Gestión de bibliotecas: para operaciones diarias como crear, eliminar o subir objetivos, consulta la sección Gestión de bibliotecas, que incluye pasos detallados y capturas de pantalla.
  • CRS API: proporciona una rica API REST que admite los siguientes escenarios:
    • Comprobación de salud: consulta el estado del servicio mediante API.
    • Automatización: subida, eliminación, modificación y consulta masiva de objetivos.
    • Herramientas útiles: puntuación de reconocimiento del objetivo y comprobación de conflictos de similitud.
Nota

CRS admite integración mediante SDK, mini programas de WeChat, Web y otros métodos. La integración mediante SDK solo admite EasyAR Sense v2.0.0 y versiones superiores.

Resultados esperados

Entender el comportamiento real de Cloud Recognition ayuda a los desarrolladores a fijar objetivos de proyecto razonables. A continuación se describen efectos típicos en escenarios comunes.

Resultado ideal

  • Reconocimiento rápido: retardo inferior a 1 segundo desde la captura hasta la devolución del resultado (con buena red).
  • Alta precisión: en condiciones de imagen clara y red estable, la precisión supera el 98%.
  • Soporte para bibliotecas grandes: una sola biblioteca puede gestionar hasta 100.000 imágenes objetivo.
  • Actualización en tiempo real: tras subir un nuevo objetivo, el cliente puede reconocerlo sin actualizarse (solo necesita conexión).

Situaciones no ideales y respuesta

Fenómeno Causa Percepción del usuario Solución
Latencia alta Mala red, subida lenta de la imagen Hay que esperar varios segundos para ver el resultado Mostrar avisos adecuados en la aplicación
Fallo de reconocimiento Imagen borrosa, el objetivo no se subió a la nube El contenido virtual no aparece Revisar el estado de la biblioteca CRS y guiar al usuario para estabilizar el dispositivo
Conflicto de objetivos Demasiadas imágenes similares en la biblioteca Se reconoce el objetivo equivocado Optimizar la imagen objetivo para aumentar la diferenciación, o gestionar imágenes similares en bibliotecas separadas

Método de validación de resultados esperados

  • Fase de desarrollo: sube objetivos de prueba en la consola de EasyAR CRS, valida primero el flujo de reconocimiento con el ejemplo HelloARCRS y familiarízate con la lógica de la aplicación, y luego intégralo en tu propia aplicación.
  • Fase de pruebas: usa tu propia aplicación para probar la tasa de éxito del reconocimiento en distintas condiciones, como redes débiles, actualización dinámica de imágenes objetivo y aumento del tamaño de la biblioteca en la nube.

Buenas prácticas

Cloud Recognition amplía la capacidad de la biblioteca de objetivos y la capacidad de actualización dinámica mediante computación en la nube, pero sacrifica la capacidad offline y el seguimiento en tiempo real. Los desarrolladores deben elegir la solución según los requisitos del proyecto (cantidad de objetivos, frecuencia de actualización, entorno de red, etc.): seguimiento local para escenarios estáticos a pequeña escala, Cloud Recognition para escenarios dinámicos a gran escala.

Al usar CRS, se recomienda desarrollar con este flujo:

  • Fase de pruebas: usa el modo de concurrencia básica y sube pocos objetivos para validar el flujo.
  • Antes del lanzamiento: evalúa la concurrencia esperada y contacta con soporte técnico con antelación para actualizar al modo de alta concurrencia (requiere 1 a 2 días laborables).
  • Operación y mantenimiento: usa API de forma periódica para supervisar el estado de salud de la biblioteca y asegurar la estabilidad del servicio.
Importante

Aviso por picos estacionales de tráfico: si tu aplicación puede sufrir un aumento temporal de concurrencia durante festivos, grandes eventos o campañas de marketing, contacta con el soporte técnico de EasyAR con al menos 3 días laborables de antelación para solicitar una mejora del servicio y evitar restricciones en el uso del servicio de reconocimiento.

Además, si tu aplicación necesita una biblioteca grande y también requiere seguimiento de imágenes objetivo, puedes combinar Cloud Recognition con el seguimiento local de imágenes planas. Puedes consultar la sección Combinar con seguimiento local de imágenes planas para más detalles.

Guía por plataforma