默认情况下,机器学习套件的所有功能均使用 Google 训练的机器学习模型(称为基本模型)。本指南仅适用于基本模型。如需有关自定义模型的指导,请参阅此处。
机器学习套件 API 中的模型可以通过以下三种方式之一安装:
- 未捆绑:通过 Google Play 服务下载和管理模型。
- 捆绑式:模型在构建时静态关联到您的应用。
- 动态下载:按需下载模型。
每个 API 支持的安装路径
下表显示了每个机器学习套件功能支持的模型安装路径:
未捆绑 | 捆绑 | 动态下载 | |
文字识别 v2 | ✅ | ✅ | |
人脸检测 | ✅ | ✅ | |
人脸网格检测 | ✅ | ||
姿势检测 | ✅ | ||
自拍分割 | ✅ | ||
条形码扫描 | ✅ | ✅ | |
为图片加标签 | ✅ | ✅ | |
对象检测和跟踪 | ✅ | ||
数字手写识别 | ✅ | ||
文件扫描器 | ✅ | ||
主题细分 | ✅ | ||
Google 扫码器 | ✅ | ||
语言识别 | ✅ | ✅ | |
翻译 | ✅ | ||
智能回复 | ✅ | ✅ | |
实体提取 | ✅ |
API 专属指南显示了适用于给定 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 文件以使用最新的机器学习套件功能客户端库。
dependencies { implementation 'com.google.mlkit:barcode-scanning: 17.2.0' // The latest version number of the API }
重新构建您的应用。
为什么某些 API 会提供动态下载的模型
某些机器学习套件 API 包含过多的模型选项,无法捆绑。例如,数字墨水识别支持 300 多种语言,但在安装过程中不一定需要将每种语言都添加到该功能中。为此,我们提供了第三种安装选项,即在安装后按需下载模型。目前,只有数字墨水识别、翻译和实体提取具有此选项。