ML Kit-Modellinstallationspfade unter Android

Alle ML Kit-Funktionen verwenden standardmäßig von Google trainierte Modelle für maschinelles Lernen (sogenannte Basismodelle). Dieser Leitfaden gilt nur für Basismodelle. Weitere Informationen zu benutzerdefinierten Modellen.

Modelle in ML Kit APIs können auf drei Arten installiert werden:

  1. Nicht gebündelt: Modelle werden über Google Play-Dienste heruntergeladen und verwaltet.
  2. Gebündelt: Modelle werden zur Build-Zeit statisch mit Ihrer App verknüpft.
  3. Dynamisch heruntergeladen: Modelle werden bei Bedarf heruntergeladen.

Unterstützte Installationspfade für jede API

In der folgenden Tabelle sehen Sie, welche Modellinstallationspfade von den einzelnen ML Kit-Funktionen unterstützt werden:

Nicht gebündelt Gebündelt Dynamisch heruntergeladen
Texterkennung v2 ✅ ✅
Gesichtserkennung ✅ ✅
Gesichtserkennung mit Mesh ✅
Posenerkennung ✅
Selfie-Segmentierung ✅
Barcode-Scanning ✅ ✅
Bildlabeling ✅ ✅
Objekterkennung und -tracking ✅
Handschrifterkennung ✅
Dokumentenscanner ✅
Subjektsegmentierung ✅
Google Code Scanner ✅
Spracherkennung ✅ ✅
Translation ✅
Intelligente Antwort ✅ ✅
Entitätsextraktion ✅

In den API-spezifischen Leitfäden wird gezeigt, welche Installationsoptionen für die jeweilige API verfügbar sind.

Wichtige Unterschiede zwischen den Installationsoptionen

Nicht gebündelt Gebündelt Dynamisch heruntergeladen
Wo werden Modelle gespeichert? In Google Play-Diensten. Sie werden nicht auf den von dieser App verwendeten Speicherplatz angerechnet. Nach der Installation im app-spezifischen Speicher gespeichert Nach dem Herunterladen des Modells im app-spezifischen Speicher gespeichert
Wie wirkt sich die Modellgröße auf die App-Größe aus? Trägt nicht zur App-Größe bei Trägt direkt zur App-Größe bei Trägt nicht zur App-Größe bei, erhöht aber den app-spezifischen Speicher
Wann werden Modelle aktualisiert? Automatisch aktualisiert, wenn eine neuere Version veröffentlicht wird Sie müssen die App aktualisieren, um das Modell zu aktualisieren Sie müssen die App aktualisieren, um das Modell zu aktualisieren
Wann werden Modelle heruntergeladen? Modelle müssen vor der Verwendung heruntergeladen werden Alle Modelle und Funktionen sind bei der Installation der App enthalten und können sofort verwendet werden Modell-Downloads, ‑Updates und ‑Löschungen müssen manuell mit der RemoteModelManager API verwaltet werden
Wann werden Modelle vom Gerät entfernt? Google Play-Dienste entfernen das Modell nur dann aus dem Speicher, wenn alle Apps die von dem Modell abhängen, deinstalliert werden Modelle werden aus dem app-spezifischen Speicher entfernt, wenn die App deinstalliert wird Heruntergeladene Modelle werden aus dem app-spezifischen Speicher entfernt, wenn die App deinstalliert wird

Zwischen gebündelt und nicht gebündelt wählen

Wenn eine API sowohl die gebündelte als auch die nicht gebündelte Installationsoption unterstützt, gilt Folgendes:

  • Verwenden Sie die gebündelte Option, wenn Sie Folgendes priorisieren:

    • Vollständige Funktionsweise der Funktion sofort nach der Installation der App
    • Funktionsweise der Funktion ohne Netzwerkverbindung nach der Installation der App

  • Verwenden Sie die nicht gebündelte Option, wenn Sie Folgendes priorisieren:

    • Kleinere App-Größe
    • Automatische Modellupdates durch Google Play-Dienste

Modelle herunterladen

Wenn Sie die nicht gebündelte Modelloption verwenden, können Sie angeben, wie Modelle auf das Gerät heruntergeladen werden sollen:

  • Sie können Modell-Downloads bei der Installation aktivieren, indem Sie der Datei Ihrer App AndroidManifest.xml eine Deklaration hinzufügen. Das folgende Code-Snippet zeigt beispielsweise, wie Sie Ihre App so konfigurieren, dass das Modell für das Barcode Scanning automatisch heruntergeladen wird, nachdem Ihre App im Play Store installiert wurde:

    <application ...>
      ...
      <meta-data
          android:name="com.google.mlkit.vision.DEPENDENCIES"
          android:value="barcode" >
      <!-- To use multiple models: android:value="barcode,model2,model3" -->
</application>

  • Sie können einen expliziten Download anfordern über die Google Play-Dienste ModuleInstallClient API.

  • Wenn Sie keine Modell-Downloads bei der Installation aktivieren oder keinen expliziten Download anfordern, wird das Modell beim ersten Ausführen der Funktion heruntergeladen. Bis der Download abgeschlossen ist, schlagen Inferenzanfragen fehl.

Modelle aktualisieren

So aktualisieren Sie Ihre Modelle, wenn Sie die gebündelte Modelloption oder die Option für dynamisch heruntergeladene Modelle verwenden:

  1. Aktualisieren Sie die Gradle-Datei Ihrer App, um die neueste Clientbibliothek für ML Kit-Funktionen zu verwenden.

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

  2. Erstellen Sie Ihre App neu.

Warum bieten einige APIs dynamisch heruntergeladene Modelle an?

Einige ML Kit APIs haben zu viele Modelloptionen, um sie zu bündeln. Die Handschrifterkennung unterstützt beispielsweise mehr als 300 Sprachen. Es ist nicht immer erforderlich, alle Sprachen während der Installation in die Funktion aufzunehmen. Aus diesem Grund bieten wir die dritte Installationsoption an, bei der Modelle nach der Installation bei Bedarf heruntergeladen werden. Derzeit ist diese Option nur für die Handschrifterkennung, Translation und Entitätsextraktion verfügbar.