从 Mobile Vision 迁移到 Android 上的机器学习套件

本文档介绍了从 Google Cloud 迁移项目所需执行的步骤 将 Google 移动视觉 (GMV) 迁移到 Android 机器学习套件。

整体 API 变更

这些变更适用于所有 API：

• GMV API 会同步返回 SparseArray<T> 结果。机器学习套件 API 使用 用于异步返回结果的 Google Play 服务 Task API。
• GMV 会使用 API Surface 中的 isOperational() 调用来指明 模块已经成功下载，可以开始使用了。机器学习套件 方法。如果存在以下情况，机器学习套件会抛出 MlKitException.UNAVAILABLE 异常： 尚未下载模块。您可以捕获此异常并处理 或设置超时，然后使用当前帧重试。
• GMV 方法使用 Frame 进行输入。机器学习套件使用 InputImage。
• GMV 提供MultiDetector、MultiProcessor和FocusingProcessor 用于执行多项检测和结果过滤的框架。机器学习套件 不提供此类机制，但 由开发者实现

更新 Gradle 导入

根据下表更新模块（应用级）Gradle 文件（通常为 app/build.gradle）中 Android 版机器学习套件库的依赖项：

API 更改

本部分介绍了每个 Vision API 对应的 GMV 和机器学习套件类和方法，并介绍了如何初始化该 API。

FaceDetector

对初始化进行重新编码，如以下示例所示：

detector = new FaceDetector.Builder(context)
    .setMode(FaceDetector.ACCURATE_MODE)
    .setLandmarkType(FaceDetector.ALL_LANDMARKS)
    .setClassificationType(FaceDetector.ALL_CLASSIFICATIONS)
    .build();

FaceDetectorOptions options = new FaceDetectorOptions.Builder()
    .setPerformanceMode(FaceDetectorOptions.PERFORMANCE_MODE_ACCURATE)
    .setLandmarkMode(FaceDetectorOptions.LANDMARK_MODE_ALL)
    .setClassificationMode(FaceDetectorOptions.CLASSIFICATION_MODE_ALL)
    .build();

detector = FaceDetection.getClient(options);

更改以下类和方法名称：

BarcodeDetector

对初始化进行重新编码，如以下示例所示：

barcodeDetector = new BarcodeDetector.Builder(context).build());

barcodeScanner = BarcodeScanning.getClient();

更改以下类和方法名称：

TextRecognition

对初始化进行重新编码，如以下示例所示：

textRecognizer = new TextRecognizer.Builder(context).build();

textRecognizer = TextRecognition.getClient(TextRecognizerOptions.DEFAULT_OPTIONS);

更改以下类和方法名称：

CameraSource

如果您使用 Google Mobile Vision 提供的 CameraSource 库，则可以 轻松迁移至机器学习套件的 CameraXSource 库，前提是您的应用在最低 SDK 版本不低于 21 上运行。

更改以下类和方法名称：

获取帮助

如果您遇到任何问题，请查看我们的社区页面 ，其中介绍了与我们联系的渠道。