所有 ML Kit 功能都會使用 Google 訓練的機器學習模型 (也就是 基礎模型)。本指南僅適用於基礎模型。詳情請參閱這裡 說明如何自訂模型
你可以透過下列三種方式安裝 ML Kit API 中的模型:
- 未組合:透過 Google Play 服務下載及管理模型。
- 組合:模型會在建構期間以靜態方式連結至您的應用程式。
- 動態下載:模型可隨選下載。
各 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。
如果不啟用安裝期間模型下載功能或要求明確指定 ,在您首次執行功能時,系統會下載模型。 在下載完成之前,推論要求會失敗。
如何更新模型
在使用隨附模型或動態下載的模型時更新模型 模型選項:
請更新應用程式的 Gradle 檔案,以便使用最新的 ML Kit 功能用戶端 資源庫。
dependencies { implementation 'com.google.mlkit:barcode-scanning: 17.3.0' // The latest version number of the API }
重新建構應用程式。
為何某些 API 提供動態下載的模型
部分 ML Kit API 的模型選項過多。例如「Digital ink」 辨識支援 300 歲以上 語言,還未提供 安裝時一定要將每個語言放入功能中。 為此,我們提供第三個安裝選項, 安裝後隨選下載目前僅支援數位墨水 辨識, 翻譯和實體 擷取選項,即可採用這個選項。