Android 上的 ML Kit 模型安裝路徑

所有 ML Kit 功能都會使用 Google 訓練的機器學習模型 (也就是 基礎模型)。本指南僅適用於基礎模型。詳情請參閱這裡 說明如何自訂模型

你可以透過下列三種方式安裝 ML Kit API 中的模型：

  1. 未組合：透過 Google Play 服務下載及管理模型。
  2. 組合：模型會在建構期間以靜態方式連結至您的應用程式。
  3. 動態下載：模型可隨選下載。

各 API 支援的安裝路徑

下表列出各項機器學習支援的模型安裝路徑 Kit 功能：

未組合 套裝組合 動態下載
文字辨識 v2 ✅ ✅
臉部偵測 ✅ ✅
臉部網格偵測 ✅
姿勢偵測 ✅
自拍區隔 ✅
條碼掃描 ✅ ✅
為圖片加上標籤 ✅ ✅
偵測及追蹤物件 ✅
數位墨水辨識 ✅
文件掃描器 ✅
主體區隔 ✅
Google 圖碼掃描器 ✅
語言識別 ✅ ✅
翻譯 ✅
智慧回覆 ✅ ✅
實體擷取 ✅

API 專屬指南會針對指定的 也能使用 Google Cloud CLI 或 Compute Engine API

安裝選項的主要差異

未分類 套裝組合 動態下載
模型會儲存在哪裡？ 留在 Google Play 服務中，不計入儲存空間 供這個應用程式使用 已儲存在應用程式專屬儲存空間中 安裝完成後 已儲存在應用程式專屬儲存空間中 模型下載後
模型大小對應用程式大小有何影響？ 不會影響應用程式大小 直接貢獻應用程式大小 不會影響應用程式大小，但增加 應用程式專屬儲存空間
模型何時會更新？ 有新版本推出時自動更新 需要更新應用程式以更新模型 需要更新應用程式以更新模型
模型何時會下載？ 模型必須先下載才能使用 安裝應用程式後可使用所有型號和功能，因此可立即使用 您必須手動管理模型下載、更新及刪除作業，方法是使用 RemoteModelManager API (應用程式介面)
何時會從裝置上移除型號？ 只有在所有應用程式的情況下，Google Play 服務才會將模型從儲存空間中移除 系統就會解除安裝需要處理的模型 模型會從應用程式專屬儲存空間中移除 解除安裝應用程式時 下載的模型會從應用程式專屬儲存空間中移除 解除安裝應用程式時

如何選擇分類郵件和未分類郵件

如果 API 同時支援封裝和未封裝的安裝選項：

  • 如為優先順序，請使用套裝組合選項：

    • 應用程式安裝完成後立即完成功能
    • 應用程式安裝後的功能沒有網路連線

  • 如果您排定優先順序，請使用未分類郵件選項：

    • 縮減應用程式大小
    • Google Play 服務提供的自動化模型更新功能

如何下載模型

使用未組合的模型選項時，您可以指定模型的 下載到裝置：

  • 如要啟用安裝期間模型下載功能，請在 應用程式的 AndroidManifest.xml 檔案。例如，下方的程式碼片段 示範如何將應用程式設定為自動下載條碼 從 Play 商店安裝應用程式後的掃描模型：

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

  • 你可以透過 Google Play 服務要求明確下載 ModuleInstallClient API。

  • 如果不啟用安裝期間模型下載功能或要求明確指定 ，在您首次執行功能時，系統會下載模型。 在下載完成之前，推論要求會失敗。

如何更新模型

在使用隨附模型或動態下載的模型時更新模型 模型選項：

  1. 請更新應用程式的 Gradle 檔案，以便使用最新的 ML Kit 功能用戶端 資源庫。

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

  2. 重新建構應用程式。

為何某些 API 提供動態下載的模型

部分 ML Kit API 的模型選項過多。例如「Digital ink」 辨識支援 300 歲以上 語言，還未提供 安裝時一定要將每個語言放入功能中。 為此，我們提供第三個安裝選項， 安裝後隨選下載目前僅支援數位墨水 辨識， 翻譯和實體 擷取選項，即可採用這個選項。