ML Kit-Modellinstallationspfade unter Android

Bei allen ML Kit-Funktionen werden standardmäßig von Google trainierte Modelle für maschinelles Lernen (Basismodelle) verwendet. 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 gekoppelt:Modelle werden über die Google Play-Dienste heruntergeladen und verwaltet.
  2. Im Bundle:Modelle sind zur Buildzeit 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 Installationspfade für Modelle von den einzelnen ML Kit-Funktionen unterstützt werden:

Nicht in Paketen enthalten Im Set Dynamisch heruntergeladen
Texterkennung v2 ✅ ✅
Gesichtserkennung ✅ ✅
Gesichts-Mesh-Erkennung ✅
Haltungserkennung ✅
Segmentierung von Selfies ✅
Barcode-Scan ✅ ✅
Bilderlabel ✅ ✅
Objekterkennung und -tracking ✅
Erkennung von digitaler Tinte ✅
Dokumentenscanner ✅
Segmentierung nach Thema ✅
Google Code Scanner ✅
Spracherkennung ✅ ✅
Translation ✅
Intelligente Antwort ✅ ✅
Entitätsextraktion ✅

API-spezifische Anleitungen zeigen, welche Installationsoptionen für die jeweilige API verfügbar sind.

Wichtige Unterschiede zwischen den Installationsoptionen

Nicht in Paketen enthalten Im Set Dynamisch heruntergeladen
Wo werden Modelle gespeichert? Befindet sich in den Google Play-Diensten und wird nicht auf den von dieser App genutzten Speicherplatz angerechnet. Nach der Installation im app-spezifischen Speicher gespeichert Nach dem Modelldownload im appspezifischen Speicher gespeichert
Wie wirkt sich die Modellgröße auf die App-Größe aus? Sie tragen 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 Speicherplatz
Wann werden Modelle aktualisiert? Automatisch aktualisiert, wenn eine neuere Version veröffentlicht wird App aktualisieren, um Modell zu aktualisieren App aktualisieren, um 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. Downloads, Aktualisierungen und Löschvorgänge von Modellen müssen manuell mit der RemoteModelManager API verwaltet werden.
Wann werden Modelle vom Gerät entfernt? Das Modell wird von Google Play-Diensten nur aus dem Speicher entfernt, wenn alle Apps deinstalliert wurden, die vom Modell abhängig sind. 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 Paket und Einzelkauf wählen

Wenn eine API sowohl die Installationsoptionen für die Bündelung als auch für die eigenständige Installation unterstützt:

  • Verwenden Sie die Option „Im Paket“, wenn Sie Folgendes priorisieren:

    • Vollständige Funktion der Funktion direkt nach der App-Installation
    • Funktionsfähigkeit der Funktionen nach der App-Installation ohne Netzwerkverbindung

  • Verwenden Sie die Option „Nicht im Paket“ für Folgendes:

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

Modelle herunterladen

Wenn Sie die Option „Unverbundenes Modell“ verwenden, können Sie angeben, wie Modelle auf das Gerät heruntergeladen werden sollen:

  • Sie können Modeldownloads bei der Installation aktivieren, indem Sie der AndroidManifest.xml-Datei Ihrer App eine Erklärung hinzufügen. Im folgenden Code-Snippet wird beispielsweise gezeigt, wie Sie Ihre App so konfigurieren, dass das Barcode-Scan-Modell automatisch heruntergeladen wird, nachdem Ihre App aus dem 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 den expliziten Download über die Google Play Services ModuleInstallClient API anfordern.

  • Wenn Sie den Download von Modellen bei der Installation nicht aktivieren oder einen 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 das Paketmodell 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 einige APIs dynamisch heruntergeladene Modelle anbieten

Einige ML Kit APIs haben zu viele Modelloptionen, um sie zu bündeln. Die Erkennung digitaler Eingaben unterstützt beispielsweise über 300 Sprachen. Es ist nicht immer erforderlich, bei der Installation alle Sprachen in die Funktion aufzunehmen. Dazu bieten wir die dritte Installationsoption an, bei der Modelle nach der Installation auf Anfrage heruntergeladen werden. Derzeit ist diese Option nur für die Erkennung digitaler Handschriften, die Übersetzung und die Entitätsextraktion verfügbar.