Percorsi di installazione del modello ML Kit su Android

Tutte le funzionalità del ML Kit utilizzano modelli di machine learning addestrati da Google (noti come modelli di base) per impostazione predefinita. Questa guida è valida solo per i modelli di base. Leggi qui per ottenere indicazioni sui modelli personalizzati.

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

  1. Non in bundle: i modelli vengono scaricati e gestiti tramite Google Play Services.
  2. In bundle: i modelli sono collegati in modo statico alla tua app al momento della creazione.
  3. Download dinamico: i modelli vengono scaricati on demand.

Percorsi di installazione supportati per ogni API

La tabella seguente mostra i percorsi di installazione del modello supportati da ogni funzionalità del kit ML:

Non in bundle In bundle Download dinamico
Riconoscimento testo v2
Rilevamento dei volti
Rilevamento mesh del volto
Rilevamento posa
Segmentazione dei selfie
Scansione di codici a barre
Etichettatura delle immagini
Rilevamento e monitoraggio degli oggetti
Riconoscimento dell'inchiostro digitale
Scanner di codici Google
Identificazione della lingua
Traduzioni
Risposta rapida
Estrazione di entità

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

Differenze chiave tra le opzioni di installazione

In bundle In bundle Download dinamico
Dove vengono archiviati i modelli? Non risiede in Google Play Services e non viene conteggiato nello spazio di archiviazione utilizzato da questa app Salvato in spazio di archiviazione specifico per l'app dopo l'installazione Salvato in spazio di archiviazione specifico per l'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 Contribuisce direttamente alle dimensioni dell'app
Quando vengono aggiornati i modelli? Si aggiorna automaticamente quando viene rilasciata una versione più recente Devi aggiornare l'app per aggiornare il modello Devi 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 è installata, pertanto sono utilizzabili immediatamente I download, gli aggiornamenti e le eliminazioni dei modelli devono essere gestiti manualmente tramite l'API RemoteModelManager
Quando vengono rimossi i modelli dal dispositivo? Google Play Services rimuoverà il modello dallo spazio di archiviazione solo se tutte le app che dipendono dal modello sono 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 gruppi e gruppi non raggruppati

Se un'API supporta le opzioni di installazione in bundle e non in bundle:

  • Utilizza l'opzione inclusa nel pacchetto se dai priorità:

    • Completa la funzionalità della funzionalità immediatamente dopo l'installazione dell'app
    • Funzionalità senza connessione di rete dopo l'installazione dell'app
  • Utilizza l'opzione Non in bundle se dai la priorità a:

    • Dimensioni app ridotte
    • Aggiornamenti automatici dei modelli di Google Play Services

Come scaricare i modelli

Quando utilizzi l'opzione di modello non in bundle, puoi specificare la modalità di download dei modelli sul dispositivo:

  • Puoi abilitare i download dei modelli al momento dell'installazione aggiungendo una dichiarazione al file AndroidManifest.xml dell'app. Ad esempio, lo snippet di codice riportato di seguito mostra come configurare l'app per scaricare automaticamente il modello Scansione di codici a barre dopo aver installato l'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 abiliti i download del modello al momento dell'installazione o non 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 relativa ai modelli scaricati dinamicamente:

  1. Aggiornare il file gradle della tua app per utilizzare la libreria client delle funzionalità di ML Kit più recente.

    dependencies {
      implementation 'com.google.mlkit:barcode-scanning: 17.1.0' // The latest version number of the API
    }
    
  2. Ricrea l'app.

Perché alcune API offrono modelli scaricati in modo dinamico

Alcune API ML Kit hanno troppe opzioni di modello per il bundle. Ad esempio, il riconoscimento digitale dell'inchiostro supporta oltre 300 lingue e non è sempre necessario inserire ogni lingua all'interno della funzionalità durante l'installazione. A questo scopo, offriamo la terza opzione di installazione, in cui i modelli vengono scaricati on demand dopo l'installazione. Al momento, solo Riconoscimento inchiostro digitale, Traduzione ed Estrazione dell'entità hanno questa opzione.