Installationspfade für ML Kit-Modelle unter Android

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

Sie können Modelle in ML Kit APIs auf drei Arten installieren:

  1. Nicht gebündelt: Modelle werden über die Google Play-Dienste heruntergeladen und verwaltet.
  2. Gebündelt: Modelle werden bei der Erstellung 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-Features unterstützt werden:

Nicht gruppiert Set Dynamisch heruntergeladen
Texterkennung ✅
Texterkennung Version 2 ✅
Gesichtserkennung ✅ ✅
Gesichtsnetzerkennung ✅
Poseerkennung ✅
Selfie-Segmentierung ✅
Barcode-Scan ✅ ✅
Bildlabels ✅ ✅
Objekterkennung und -tracking ✅
Digitale Tintenerkennung ✅
Google Codescanner ✅
Spracherkennung ✅ ✅
Translation ✅
Intelligente Antwort ✅ ✅
Entitätsextraktion ✅

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

Wichtige Unterschiede zwischen Installationsoptionen

Ungruppiert Set 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 Download 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 direkt zur App-Größe bei
Wann werden Modelle aktualisiert? 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 enthalten, wenn die App installiert wird, sodass sie sofort verwendet werden können Modelldownloads, -updates und -löschungen müssen manuell mit der RemoteModelManager API verwaltet werden
Wann werden Modelle vom Gerät entfernt? Die Google Play-Dienste entfernen das Modell nur aus dem Speicher, wenn alle vom Modell abhängigen Apps deinstalliert werden Modelle werden bei der Deinstallation der Anwendung aus dem app-spezifischen Speicher entfernt Heruntergeladene Modelle werden bei der Deinstallation der App aus dem App-spezifischen Speicher entfernt

Gebündelt und ungruppiert auswählen

Wenn eine API sowohl die gebündelte als auch die entbündelte Installationsoption unterstützt:

  • In folgenden Fällen sollten Sie die gebündelte Option verwenden:

    • Funktionen direkt nach der Installation der App fertigstellen
    • Funktion ohne Netzwerkverbindung nach der App-Installation

  • Verwenden Sie in folgenden Fällen die Option für entbündelte Produkte:

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

Modelle herunterladen

Wenn Sie die Option für entbündelte Modelle verwenden, können Sie festlegen, wie Modelle auf das Gerät heruntergeladen werden sollen:

  • Sie können Downloads von Modellen zur Installation aktivieren, indem Sie der Datei AndroidManifest.xml Ihrer Anwendung eine Deklaration hinzufügen. Das folgende Code-Snippet zeigt beispielsweise, wie Sie Ihre App so konfigurieren, dass das Barcode-Scanmodell automatisch heruntergeladen wird, nachdem die 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 einen expliziten Download über die ModuleInstallClient API der Google Play-Dienste anfordern.

  • Wenn Sie das Herunterladen von Modellen während der Installation nicht aktivieren oder einen expliziten Download anfordern, wird das Modell beim ersten Ausführen des Features heruntergeladen. Inferenzanfragen schlagen fehl, bis der Download abgeschlossen ist.

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-Clientbibliothek zu verwenden.

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

  2. Erstellen Sie Ihre Anwendung neu.

Warum einige APIs dynamisch heruntergeladene Modelle anbieten

Einige ML Kit APIs haben zu viele Modelloptionen für das Bundle. Beispielsweise unterstützt die digitale Tintenerkennung mehr als 300 Sprachen und es ist nicht erforderlich, während der Installation jede Sprache in das Feature aufzunehmen. Zu diesem Zweck bieten wir die dritte Installationsoption, bei der Modelle nach der Installation bei Bedarf heruntergeladen werden. Derzeit ist diese Option nur für die digitale Tintenerkennung, die Übersetzung und die Entitätsextraktion verfügbar.