Caminhos de instalação de modelos do kit de ML no Android

Todos os recursos do Kit de ML usam modelos de machine learning treinados pelo Google (conhecidos como modelos básicos) por padrão. Este guia é aplicável apenas a modelos básicos. Confira aqui as orientações sobre modelos personalizados.

Os modelos nas APIs do Kit de ML podem ser instalados de três maneiras:

  1. Não agrupados:os modelos são baixados e gerenciados pelo Google Play Services.
  2. Agrupados:os modelos são vinculados estaticamente ao app no tempo de build.
  3. Baixados dinamicamente:os modelos são baixados sob demanda.

Caminhos de instalação compatíveis com cada API

A tabela abaixo mostra quais caminhos de instalação de modelo são compatíveis com cada recurso do Kit de ML:

Não agrupados Agrupados Baixados dinamicamente
Reconhecimento de texto v2 ✅ ✅
Detecção facial ✅ ✅
Detecção de malha facial ✅
Detecção de poses ✅
Segmentação de selfie ✅
Leitura de código de barras ✅ ✅
Rotulagem de imagens ✅ ✅
Detecção e rastreamento de objetos ✅
Reconhecimento de tinta digital ✅
Scanner de documentos ✅
Segmentação de assuntos ✅
Leitor de código do Google ✅
Identificação de idioma ✅ ✅
Tradução ✅
Resposta inteligente ✅ ✅
Extração de entidades ✅

Os guias específicos da API mostram quais opções de instalação estão disponíveis para a API em questão.

Principais diferenças entre as opções de instalação

Não agrupados Agrupados Baixados dinamicamente
Onde os modelos são armazenados? Reside no Google Play Services e não é contabilizado no armazenamento usado por esse app Salvo no armazenamento específico do app após a instalação Salvo no armazenamento específico do app após o download do modelo
Como o tamanho do modelo afeta o tamanho do app? Não contribui para o tamanho do app Contribui diretamente para o tamanho do app Não contribui para o tamanho do app, mas aumenta o armazenamento específico do app
Quando os modelos são atualizados? Atualizado automaticamente quando uma versão mais recente é lançada É necessário atualizar o app para atualizar o modelo É necessário atualizar o app para atualizar o modelo
Quando os modelos são baixados? Os modelos precisam ser baixados antes do uso Todos os modelos e recursos são incluídos quando o app é instalado, então podem ser usados imediatamente Os downloads, atualizações e exclusões de modelos precisam ser gerenciados manualmente usando a RemoteModelManager
Quando os modelos são removidos do dispositivo? O Google Play Services só remove o modelo do armazenamento se todos os apps que dependem dele forem desinstalados Os modelos são removidos do armazenamento específico do app quando o app é desinstalado Os modelos baixados são removidos do armazenamento específico do app quando o app é desinstalado

Como escolher entre agrupados e não agrupados

Se uma API oferece suporte às opções de instalação agrupada e não agrupada:

  • Use a opção agrupada se você priorizar:

    • Funcionalidade completa do recurso imediatamente após a instalação do app
    • Funcionalidade do recurso sem conexão de rede após a instalação do app

  • Use a opção não agrupada se você priorizar:

    • Menos espaço ocupado pelos apps.
    • Atualizações automáticas de modelos pelo Google Play Services

Como baixar modelos

Ao usar a opção de modelo não agrupado, é possível especificar como os modelos serão baixados para o dispositivo:

  • É possível ativar os downloads de modelos no momento da instalação adicionando uma declaração ao arquivo AndroidManifest.xml do app. Por exemplo, o snippet de código abaixo mostra como configurar o app para baixar automaticamente o modelo de leitura de código de barras depois que o app for instalado na Google Play Store:

    <application ...>
      ...
      <meta-data
          android:name="com.google.mlkit.vision.DEPENDENCIES"
          android:value="barcode" >
      <!-- To use multiple models: android:value="barcode,model2,model3" -->
</application>

  • É possível solicitar o download explícito pela API ModuleInstallClient do Google Play Services.

  • Se você não ativar os downloads de modelos no momento da instalação ou solicitar o download explícito, o modelo será baixado na primeira vez em que você executar o recurso. Até que o download seja concluído, as solicitações de inferência vão falhar.

Como atualizar modelos

Para atualizar seus modelos ao usar a opção de modelo agrupado ou de modelos baixados dinamicamente:

  1. Atualize o arquivo Gradle do app para usar a biblioteca de cliente de recursos do Kit de ML mais recente.

    dependencies {
  implementation 'com.google.mlkit:barcode-scanning: 17.3.0' // The latest version number of the API
}

  2. Recompile o app.

Por que algumas APIs oferecem modelos baixados dinamicamente

Algumas APIs do Kit de ML têm muitas opções de modelo para agrupar. Por exemplo, o reconhecimento de tinta digital oferece suporte a mais de 300 idiomas, e nem sempre é necessário colocar todos os idiomas no recurso durante a instalação. Para isso, oferecemos a terceira opção de instalação, em que os modelos são baixados sob demanda após a instalação. Atualmente, apenas o reconhecimento de tinta digital, a tradução e a extração de entidades têm essa opção.