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

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

整体 API 变更

以下更改适用于所有 API：

• GMV API 会同步返回 SparseArray<T> 结果。ML Kit API 使用 Google Play 服务 Task API 异步返回结果。
• GMV 会在 API 接口中使用 isOperational() 调用来指明模块是否已成功下载且可以使用。机器学习套件没有此类方法。如果模块尚未下载，机器学习套件会抛出 MlKitException.UNAVAILABLE 异常。您可以捕获此异常并处理下一帧，也可以设置超时并针对当前帧重试。
• GMV 方法使用 Frame 作为输入。机器学习套件使用 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 或更高版本。

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

获取帮助

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