從 Mobile Vision 遷移至 Android 上的 ML Kit

本文件將說明將專案從何處遷移 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 用於執行多項偵測及篩選結果。機器學習套件 不提供這類機制，不過 。

更新 Gradle 匯入作業

按照下表，更新模組 (應用程式層級) Gradle 檔案 (通常為 app/build.gradle) 中 ML Kit 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。

變更下列類別和方法名稱：

取得說明

如有任何問題，請前往我們的社群頁面 我們整理出了可與我們聯絡的管道。