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:
- Desagrupado:os modelos são transferidos por download e gerenciados pelo Google Play Services.
- Agrupados:os modelos são vinculados estaticamente ao app no tempo de compilação.
- 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:
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 }
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.