ML Kit-Modellinstallationspfade unter Android

Alle ML Kit-Funktionen basieren auf von Google trainierten Modellen für maschinelles Lernen, Basismodelle) standardmäßig verwenden. Dieser Leitfaden gilt nur für Basismodelle. Hier ansehen finden Sie eine Anleitung zu benutzerdefinierten Modellen.

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

  1. Ungebündelt:Die Modelle werden über die Google Play-Dienste heruntergeladen und verwaltet.
  2. Gebündelt:Die Modelle werden bei der Build-Erstellung statisch mit Ihrer App verknüpft.
  3. Dynamisch heruntergeladen:Die Modelle werden bei Bedarf heruntergeladen.

Unterstützte Installationspfade für jede API

In der folgenden Tabelle sehen Sie, welche Pfade für die Modellinstallation von den einzelnen ML-Modellen unterstützt werden Kit-Funktion:

Ungruppiert Gebündelt Dynamisch heruntergeladen
Texterkennung v2 ✅ ✅
Gesichtserkennung ✅ ✅
Face-Mesh-Erkennung ✅
Pose-Erkennung ✅
Selfie-Segmentierung ✅
Barcode scannen ✅ ✅
Bildlabel ✅ ✅
Objekterkennung und -tracking ✅
Digitale Tintenerkennung ✅
Dokumentenscanner ✅
Themensegmentierung ✅
Google Code Scanner ✅
Spracherkennung ✅ ✅
Translation ✅
Intelligente Antwort ✅ ✅
Entitätsextraktion ✅

API-spezifische Leitfäden zeigen, welche Installationsoptionen für die jeweilige der API erstellen.

Hauptunterschiede zwischen den Installationsoptionen

Ungruppiert Im Set Dynamisch heruntergeladen
Wo werden Modelle gespeichert? Nutzer ist in den Google Play-Diensten enthalten und wird nicht auf den Speicherplatz angerechnet. von dieser App verwendet Im appspezifischen Speicher gespeichert nach der Installation Im appspezifischen Speicher gespeichert nach Modelldownload
Wie wirkt sich die Modellgröße auf die App-Größe aus? Beeinflusst nicht die App-Größe Trägt direkt zur App-Größe bei Trägt nicht zur App-Größe bei, erhöht aber app-spezifischer Speicher
Wann werden Modelle aktualisiert? Automatische Aktualisierung, wenn eine neuere Version veröffentlicht wird Die App muss aktualisiert werden, um das Modell zu aktualisieren Die 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 daher sofort genutzt werden. Modelldownloads, -aktualisierungen und -löschungen müssen manuell mit RemoteModelManager API
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ängig sind, Modelle werden aus dem appspezifischen Speicher entfernt Die App wird deinstalliert. Heruntergeladene Modelle werden aus dem appspezifischen Speicher entfernt Die App wird deinstalliert.

So wählen Sie zwischen gruppiert und nicht gebündelt

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

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

    • Funktionsfunktionen werden sofort nach der App-Installation ausgeführt
    • Funktionalität ohne Netzwerkverbindung nach der App-Installation

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

    • 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 angeben, auf das Gerät heruntergeladen:

  • Sie können das Herunterladen von Modellen für die Installationszeit aktivieren, indem Sie eine Deklaration hinzufügen. die AndroidManifest.xml-Datei Ihrer App. Das Code-Snippet unten zeigt, wie du deine App so konfigurierst, dass der Barcode automatisch heruntergeladen wird Nach der Installation deiner App aus dem Play Store wird das Modell gescannt:

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

  • Du kannst über die Google Play-Dienste einen expliziten Download anfordern. ModuleInstallClient API.

  • Modelldownloads bei der Installation aktivieren oder explizite Anfragen stellen herunterladen, wird das Modell heruntergeladen, wenn Sie das Feature zum ersten Mal ausführen. Bis zum Abschluss des Downloads schlagen Inferenzanfragen fehl.

Modelle aktualisieren

Um Ihre Modelle zu aktualisieren, wenn Sie das gebündelte oder das dynamisch heruntergeladene Modell verwenden, Models-Option:

  1. Aktualisieren Sie die Gradle-Datei Ihrer App, um den neuesten ML Kit-Featureclient zu verwenden Bibliothek.

    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

Für einige ML Kit APIs sind zu viele Modelloptionen verfügbar, um sie bündeln zu können. Beispiel: Digitale Tinte Erkennung unterstützt über 300 Sprachen und es ist nicht Bei der Installation muss immer jede Sprache in der Funktion angegeben werden. Zu diesem Zweck bieten wir die dritte Installationsoption an, bei der Modelle und werden nach der Installation on demand heruntergeladen. Derzeit ist nur digitale Tinte Erkennung, Translation und Entity Extraktion haben diese Option.