默认情况下,机器学习套件的所有功能都使用 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 多种语言,因此在安装过程中,并不总是需要在功能中添加所有语言。为此,我们提供了第三种安装选项,在安装后按需下载模型。目前,只有数字墨水识别、翻译和实体提取具有此选项。