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

本文档介绍了将项目从 Google Mobile Vision (GMV) 迁移到 Android 版 ML Kit 所需的步骤。

总体 API 变更

这些更改适用于所有 API：

• GMV API 会同步返回 SparseArray<T> 结果。ML Kit API 使用 Google Play 服务的 Task API 异步返回结果。
• GMV 使用 API 界面中的 isOperational() 调用来指示模块是否已成功下载并可供使用。ML Kit 没有此类方法。如果模块尚未下载，ML Kit 会抛出 MlKitException.UNAVAILABLE 异常。您可以捕获此异常并处理下一帧，也可以设置超时时间并重试当前帧。
• GMV 方法使用 Frame 作为输入。ML Kit 使用 InputImage。
• GMV 提供 MultiDetector、MultiProcessor 和 FocusingProcessor 框架，用于执行多次检测和结果过滤。ML Kit 不提供此类机制，但开发者可以根据需要实现相同的功能。

更新 Gradle 导入

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

API 更改

本部分介绍了每个 Vision API 对应的 GMV 和 ML Kit 类及方法，并展示了如何初始化 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 库，则可以轻松迁移到 ML Kit 的 CameraXSource 库，前提是您的应用运行在最低 SDK 版本 >= 21 的设备上。

更改了以下类和方法名称：

获取帮助

如果您遇到任何问题，请访问我们的社区页面，其中列出了可用于与我们联系的渠道。