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. Ungebündelt: Modelle werden über die Google Play-Dienste heruntergeladen und verwaltet.
  2. Gebündelt: Modelle werden beim Erstellen 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:

Unbundled Gebündelt Dynamisch heruntergeladen
Texterkennung v2 ✅ ✅
Gesichtserkennung ✅ ✅
Gesichtsnetz-Erkennung ✅
Haltungserkennung ✅
Selfie-Segmentierung ✅
Scannen von Barcodes ✅ ✅
Bild-Labeling ✅ ✅
Objekterkennung und -tracking ✅
Erkennung digitaler Tinte ✅
Dokumentenscanner ✅
Motivsegmentierung ✅
Google Code Scanner ✅
Spracherkennung ✅ ✅
Translation ✅
Intelligente Antwort ✅ ✅
Entitätsextraktion ✅

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

Wichtige Unterschiede zwischen den Installationsoptionen

Unbundled Gebündelt Dynamisch heruntergeladen
Wo werden Modelle gespeichert? Befindet sich in den Google Play-Diensten und wird nicht auf den von dieser App verwendeten Speicherplatz angerechnet Nach der Installation im App-spezifischen Speicher gespeichert Nach dem Herunterladen des Modells im appspezifischen 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? Wird automatisch aktualisiert, wenn eine neuere Version veröffentlicht wird App muss aktualisiert werden, um das Modell zu aktualisieren App muss aktualisiert werden, 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. Das Herunterladen, Aktualisieren und Löschen von Modellen muss manuell über die RemoteModelManager API verwaltet werden.
Wann werden Modelle vom Gerät entfernt? Die Google Play-Dienste entfernen das Modell nur dann aus dem Speicher, wenn alle Apps, die vom Modell abhängen, deinstalliert wurden. Modelle werden aus dem App-spezifischen Speicher entfernt, wenn die App deinstalliert wird. Heruntergeladene Modelle werden beim Deinstallieren der App aus dem App-spezifischen Speicher entfernt.

Zwischen gebündelten und ungebündelten Produkten wählen

Wenn eine API sowohl die gebündelte als auch die ungebündelte Installation unterstützt:

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

    • Vollständige Funktionalität sofort nach der App-Installation
    • Funktionsweise ohne Netzwerkverbindung nach der App-Installation

  • Verwenden Sie die Option „Ungebündelt“, wenn Sie Folgendes priorisieren:

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

Modelle herunterladen

Wenn Sie die Option für nicht gebündelte Modelle 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 AndroidManifest.xml Ihrer App eine Deklaration hinzufügen. Das folgende Code-Snippet zeigt beispielsweise, wie Sie Ihre App so konfigurieren, dass das Barcode-Scanmodell automatisch heruntergeladen wird, nachdem Ihre App aus dem Google 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>

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

  • Wenn Sie den Download von Modellen bei der Installation nicht 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 das gebündelte Modell oder die Option für dynamisch heruntergeladene Modelle verwenden:

  1. Aktualisieren Sie die Gradle-Datei Ihrer App, um die neueste ML Kit-Feature-Clientbibliothek 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 Digital Ink-Erkennung unterstützt beispielsweise mehr als 300 Sprachen. Es ist nicht immer erforderlich, alle Sprachen bei der Installation in die Funktion aufzunehmen. Für diesen Zweck bieten wir die dritte Installationsoption an, bei der Modelle nach der Installation bei Bedarf heruntergeladen werden. Derzeit ist diese Option nur für die Digital Ink-Erkennung, die Übersetzung und die Entitätsextraktion verfügbar.