Sobre o projeto

O VModal AI para Android é um SDK Kotlin sem IU que conecta aplicativos Android ao serviço de pesquisa de vídeo e imagem VModal. Os aplicativos podem configurar um cliente com um ID de projeto e uma chave de API de tempo de execução, definir escopo de solicitações para coleções e streams, fazer upload de vídeos, criar ou verificar índices de imagem e pesquisar momentos visuais por texto semântico ou imagens. Os resultados da pesquisa podem ser resolvidos em lote para exibição na própria interface do aplicativo. O SDK lida com comunicação de gateway, modelos de solicitação e resposta tipados, uploads de streaming assinados, progresso de upload, cancelamento e análise de resposta. Ele expõe APIs baseadas em corrotinas e Flows de upload frios, com compatibilidade de UploadHandle baseada em callback mencionada para código existente. Uploads em segundo plano podem ser integrados com o AndroidX WorkManager através do CoroutineWorker, e arquivos selecionados pelo usuário são suportados como URIs content:// através do Storage Access Framework. A biblioteca foi projetada para ser usada a partir do Jetpack Compose, Android Views clássicos ou sistemas de design personalizados. Ela não impõe telas de login, navegação, temas ou outros componentes de IU. As credenciais devem ser fornecidas em tempo de execução e mantidas na memória; a documentação cobre gerenciamento de chaves de API, chamadas de identidade autenticadas, limpeza de troca de conta, falhas tipadas, coleta com reconhecimento de ciclo de vida e cancelamento de recursos do SDK. A documentação incluída fornece um livro de receitas de integração, introdução técnica, orientação sobre corrotinas e WorkManager, passo a passo de aplicativo de pesquisa e referência de API. O repositório também contém exemplos progressivos: operações iniciais, um aplicativo de upload para pesquisa, um aplicativo de pesquisa completo, padrões de organização de índices e um fluxo de pesquisa de vídeo de rua no estilo Framebase. O conjunto de ferramentas documentado usa Kotlin 1.9 ou mais recente, Java 17, Gradle 8.6, SDK de compilação 34 e um nível mínimo de API Android de 24. O projeto é licenciado sob Apache 2.0.