Caminhos de instalação do modelo do Kit de ML no Android

Todos os recursos do kit de ML usam modelos de machine learning treinados pelo Google (conhecidos como modelos base) por padrão. Este guia é aplicável somente a modelos base. Clique aqui para ver orientações sobre modelos personalizados.

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

1. Desagrupado:os modelos são transferidos por download e gerenciados pelo Google Play Services.
2. Agrupados:os modelos são vinculados estaticamente ao app no tempo de compilação.
3. Download dinâmico: os modelos são transferidos por download sob demanda.

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

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

	Desagrupado	Agrupado	Download dinâmico
Reconhecimento de texto	✅
Reconhecimento de texto v2		✅
Detecção facial	✅	✅
Detecção de malha de rosto		✅
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			✅
Leitor de código do Google	✅
Identificação de idioma	✅	✅
Tradução			✅
Resposta inteligente	✅	✅
Extração de entidade			✅

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

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

	Desagrupado	Agrupado	Download dinâmico
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 com o tamanho do app	Contribui diretamente com o tamanho do app
Quando os modelos são atualizados?	Atualizada 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 é feito o download dos modelos?	É preciso fazer o download dos modelos antes do uso	Como todos os modelos e recursos são incluídos quando o app é instalado, é possível usá-los imediatamente	Downloads, atualizações e exclusões de modelos precisam ser gerenciados manualmente usando a API RemoteModelManager.
Quando os modelos são removidos do dispositivo?	O Google Play Services só removerá o modelo do armazenamento se todos os apps que dependem do modelo forem desinstalados.	Os modelos são removidos do armazenamento específico do app quando o app é desinstalado	Os modelos salvos são removidos do armazenamento específico do app quando o app é desinstalado.

Como escolher entre pacotes e desagrupados

Se uma API oferecer suporte às opções de instalação empacotada e desagrupada:

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

  • Conclua a funcionalidade imediatamente após a instalação do app
  • Recurso sem conexão de rede após a instalação do app

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

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

Como fazer o download de modelos

Ao usar a opção de modelo desagrupado, é possível especificar como você quer que o download dos modelos seja feito no dispositivo:

• É possível ativar downloads do modelo 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 seu app para fazer o download automaticamente do modelo de leitura de código de barras após a instalação do app na 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>
  

• Você pode solicitar o download explícito com a API ModuleInstallClient do Google Play Services.

• Se você não ativar os downloads do modelo de tempo de instalação ou solicitar um download explícito, o modelo será transferido na primeira vez em que você executar o recurso. As solicitações de inferência vão falhar até que o download seja concluído.

Como atualizar modelos

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

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

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

2. Recrie seu app.

Por que algumas APIs oferecem modelos baixados

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 dentro do recurso durante a instalação. Para isso, fornecemos a terceira opção de instalação, em que os modelos são transferidos por download 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.