Sobre el proyecto

VModal AI para Android es un SDK de Kotlin sin interfaz de usuario que conecta aplicaciones Android al servicio de búsqueda de video e imágenes de VModal. Las apps pueden configurar un cliente con un ID de proyecto y una clave de API en tiempo de ejecución, limitar solicitudes a colecciones y flujos, subir videos, crear o verificar índices de imágenes, y buscar momentos visuales mediante texto semántico o imágenes. Los resultados de búsqueda se pueden resolver en lote para mostrarlos en la interfaz propia de la aplicación. El SDK maneja la comunicación con la puerta de enlace, modelos tipados de solicitud y respuesta, subidas de streaming firmadas, progreso de subida, cancelación y análisis de respuestas. Expone APIs basadas en corrutinas y flujos de subida en frío, con compatibilidad de UploadHandle basada en devoluciones de llamada para código existente. Las subidas en segundo plano se pueden integrar con AndroidX WorkManager mediante CoroutineWorker, y los archivos seleccionados por el usuario se admiten como URI de contenido:// a través del marco de acceso a almacenamiento. La biblioteca está diseñada para usarse desde Jetpack Compose, vistas clásicas de Android o sistemas de diseño personalizados. No impone pantallas de inicio de sesión, navegación, temas u otros componentes de interfaz. Las credenciales se deben proporcionar en tiempo de ejecución y mantenerse en memoria; la documentación cubre la gestión de claves de API, llamadas de identidad autenticadas, limpieza al cambiar de cuenta, fallos tipados, recolección consciente del ciclo de vida y cancelación de recursos del SDK. La documentación incluida proporciona un recetario de integración, introducción técnica, guía de corrutinas y WorkManager, recorrido de la app de búsqueda y referencia de API. El repositorio también contiene ejemplos progresivos: operaciones iniciales, una app de subida a búsqueda, una aplicación de búsqueda completa, patrones de organización de índices y un flujo de búsqueda de video callejero estilo Framebase. La cadena de herramientas documentada usa Kotlin 1.9 o superior, Java 17, Gradle 8.6, SDK de compilación 34 y un nivel mínimo de API de Android de 24. El proyecto está licenciado bajo Apache 2.0.