Percorsi di installazione dei modelli ML Kit su Android

Per impostazione predefinita, tutte le funzionalità di ML Kit utilizzano modelli di machine learning addestrati da Google (noti come modelli di base). Questa guida è applicabile solo ai modelli di base. Leggi qui per indicazioni sui modelli personalizzati.

I modelli nelle API ML Kit possono essere installati in tre modi:

  1. Sganciati:i modelli vengono scaricati e gestiti tramite Google Play Services.
  2. In bundle: i modelli sono collegati in modo statico alla tua app in fase di compilazione.
  3. Scaricare dinamicamente:i modelli vengono scaricati su richiesta.

Percorsi di installazione supportati per ogni API

La tabella seguente mostra i percorsi di installazione dei modelli supportati da ogni funzionalità di MLKit:

Senza pacchetti In bundle Scaricate dinamicamente
Riconoscimento del testo v2 ✅ ✅
Rilevamento dei volti ✅ ✅
Rilevamento della mesh del viso ✅
Rilevamento della posizione ✅
Segmentazione dei selfie ✅
Scansione di codici a barre ✅ ✅
Etichettatura delle immagini ✅ ✅
Rilevamento e monitoraggio degli oggetti ✅
Riconoscimento dell'inchiostro digitale ✅
Scanner di documenti ✅
Segmentazione degli argomenti ✅
Scanner codici Google ✅
Identificazione della lingua ✅ ✅
Traduzioni ✅
Risposta rapida ✅ ✅
Estrazione di entità ✅

Le guide specifiche per l'API mostrano le opzioni di installazione disponibili per l'API in questione.

Differenze principali tra le opzioni di installazione

Senza pacchetti In bundle Scaricata dinamicamente
Dove vengono archiviati i modelli? Risiede in Google Play Services e non viene conteggiato ai fini dello spazio di archiviazione utilizzato da questa app Salvati nello spazio di archiviazione specifico dell'app dopo l'installazione Salvato nello spazio di archiviazione specifico dell'app dopo il download del modello
In che modo le dimensioni del modello influiscono sulle dimensioni dell'app? Non contribuisce alle dimensioni dell'app Contribuisce direttamente alle dimensioni dell'app Non contribuisce alle dimensioni dell'app, ma aumenta lo spazio di archiviazione specifico dell'app
Quando vengono aggiornati i modelli? Aggiornato automaticamente quando viene rilasciata una versione più recente È necessario aggiornare l'app per aggiornare il modello È necessario aggiornare l'app per aggiornare il modello
Quando vengono scaricati i modelli? I modelli devono essere scaricati prima dell'uso Tutti i modelli e le funzionalità sono inclusi quando l'app viene installata, quindi sono utilizzabili immediatamente I download, gli aggiornamenti e le eliminazioni dei modelli devono essere gestiti manualmente utilizzando l'API RemoteModelManager.
Quando i modelli vengono rimossi dal dispositivo? Google Play Services rimuoverà il modello dallo spazio di archiviazione solo se tutte le app che dipendono dal modello vengono disinstallate I modelli vengono rimossi dallo spazio di archiviazione specifico dell'app quando l'app viene disinstallata I modelli scaricati vengono rimossi dallo spazio di archiviazione specifico dell'app quando l'app viene disinstallata

Come scegliere tra pacchetti e singoli prodotti

Se un'API supporta sia le opzioni di installazione in bundle che quelle non in bundle:

  • Utilizza l'opzione in bundle se dai la priorità a:

    • Funzionalità completa della funzionalità immediatamente dopo l'installazione dell'app
    • Funzionalità della funzionalità senza connessione di rete dopo l'installazione dell'app

  • Utilizza l'opzione non in bundle se dai la priorità a:

    • Dimensioni dell'app più piccole
    • Aggiornamenti automatici del modello da parte di Google Play Services

Come scaricare i modelli

Quando utilizzi l'opzione del modello non aggregato, puoi specificare come devono essere scaricati i modelli sul dispositivo:

  • Puoi attivare i download dei modelli al momento dell'installazione aggiungendo una dichiarazione al file AndroidManifest.xml della tua app. Ad esempio, lo snippet di codice riportato di seguito mostra come configurare l'app in modo che scarichi automaticamente il modello di scansione dei codici a barre dopo l'installazione dell'app dal 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>

  • Puoi richiedere il download esplicito tramite l'API ModuleInstallClient di Google Play Services.

  • Se non attivi i download dei modelli al momento dell'installazione o richiedi il download esplicito, il modello verrà scaricato la prima volta che esegui la funzionalità. Fino al completamento del download, le richieste di inferenza non andranno a buon fine.

Come aggiornare i modelli

Per aggiornare i modelli quando utilizzi il modello in bundle o l'opzione per i modelli scaricati dinamicamente:

  1. Aggiorna il file gradle dell'app per utilizzare la libreria client della funzionalità ML Kit più recente.

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

  2. Ricostruisci l'app.

Perché alcune API offrono modelli scaricati dinamicamente

Alcune API ML Kit hanno troppe opzioni di modello da raggruppare. Ad esempio, il riconoscimento della scrittura digitale supporta oltre 300 lingue e non è sempre necessario inserire tutte le lingue all'interno della funzionalità durante l'installazione. A questo scopo, forniamo la terza opzione di installazione, in cui i modelli vengono scaricati on demand dopo l'installazione. Al momento, solo le funzionalità di riconoscimento della scrittura digitale, traduzione ed estrazione di entità dispongono di questa opzione.