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

Todos os atributos do Kit de ML usam modelos de machine learning treinados pelo Google, conhecidos como modelos básicos) por padrão. Este guia se aplica apenas a modelos base. Confira aqui para orientações sobre modelos personalizados.

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

  1. Desagrupados:os modelos são transferidos por download e gerenciados pelo Google Play Services.
  2. Agrupado:os modelos são vinculados estaticamente ao app no tempo de build.
  3. Download dinâmico:o download dos modelos é feito 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 ML Recurso do kit:

Desagrupado Agrupado Download dinâmico
Reconhecimento de texto v2
Detecção facial
Detecção de malha facial
Detecção de posição
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 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 as opções de instalação disponíveis para os 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. usados por este 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 Contribuem 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? Atualizada automaticamente quando uma versão mais recente é lançada É preciso atualizar o app para atualizar o modelo É preciso atualizar o app para atualizar o modelo
Quando é feito o download dos modelos? É preciso fazer o download dos modelos antes do uso Todos os modelos e recursos são incluídos quando o app é instalado, por isso podem ser usados imediatamente Downloads, atualizações e exclusões de modelos precisam ser gerenciados manualmente o método RemoteModelManager API
Quando os modelos são removidos do dispositivo? O Google Play Services só vai remover o modelo do armazenamento se todos os apps que dependem do modelo são desinstalados Os modelos são removidos do armazenamento específico do app quando o app é desinstalado Os modelos transferidos por download são removidos do armazenamento específico do app quando o app é desinstalado

Como escolher entre agrupado e desagrupado

Se uma API for compatível com as opções de instalação em pacote e desagrupado:

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

    • Conclua a funcionalidade do recurso imediatamente após a instalação do app
    • Recurso de funcionalidade 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 automáticas de modelos 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 os modelos sejam baixados no dispositivo:

  • É possível ativar os downloads do modelo de tempo de instalação adicionando uma declaração ao o arquivo AndroidManifest.xml do app. Por exemplo, o snippet de código abaixo mostra como configurar seu aplicativo para fazer o download automático do código de barras Modelo de verificação após a instalação do app da 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 um download com linguagem explícita pelo Google Play Services API ModuleInstallClient.

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

Como atualizar modelos

Para atualizar seus modelos usando o modelo empacotado ou o download dinâmico de modelos de machine learning:

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

    dependencies {
      implementation 'com.google.mlkit:barcode-scanning: 17.3.0' // The latest version number of the API
    }
    
  2. Recrie 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, Tinta digital reconhecimento de marca suporta mais de 300 idiomas e não é é sempre necessário inserir todos os idiomas no recurso durante a instalação. Para isso, fornecemos a terceira opção de instalação, em que os modelos são transferidos por download sob demanda após a instalação. No momento, somente tinta digital reconhecimento de marca, Tradução e Entidade têm essa opção.