本頁面由 Cloud Translation API 翻譯而成。

從 Mobile Vision 遷移至 iOS 上的 ML Kit

本文件說明如何將專案從 Google Mobile Vision (GMV) 遷移至 iOS 上的 ML Kit。

必要條件

開始遷移程式碼前，請確認您符合下列需求條件：

ML Kit 支援 Xcode 13.2.1 以上版本。
ML Kit 支援 iOS 10 以上版本。
ML Kit 不支援 32 位元架構 (i386 和 armv7)。ML Kit 支援 64 位元架構 (x86_64 和 arm64)。

更新 Cocoapods

在應用程式的 Podfile 中，更新 ML Kit iOS Cocoapods 的依附元件：

API	GMV 廣告連播	ML Kit Pod
條碼掃描	`GoogleMobileVision/BarcodeDetector`	`GoogleMLKit/BarcodeScanning`
臉部偵測	`GoogleMobileVision/FaceDetector`	`GoogleMLKit/FaceDetection`
文字辨識	`GoogleMobileVision/TextDetector`	`GoogleMLKit/TextRecognition`

整體 API 變更

這些異動適用於所有 API：

GMV 的推論 API 會將 UIImage 或 CMSampleBufferRef 做為輸入內容。ML Kit 會將這些模組納入 MLKVisionImage，並做為輸入內容。
GMV 會使用 NSDictionary 傳遞各種偵測工具選項。ML Kit 會為了這個目的使用專屬選項類別。
GMV 建立偵測工具時，會將偵測工具類型傳遞至單一 GMVDetector 類別。ML Kit 會使用專屬類別來建立個別的偵測工具、掃描器和辨識器執行個體。
GMV 的 API 僅支援同步偵測。可以透過同步及非同步的方式呼叫 ML Kit 的推論 API。
GMV 擴充 AVCaptureVideoDataOutput 並提供多偵測器架構，可同時執行多項偵測。ML Kit 不提供這類機制，但開發人員可視需要導入相同的功能。

API 專屬變更

本節說明每個 Vision API 的對應 GMV 和 ML Kit 類別和方法，以及如何初始化 API。

FaceDetector

如以下範例所示，重新編寫初始化作業：

GMV

NSDictionary *options = @{
    GMVDetectorFaceMode : @(GMVDetectorFaceAccurateMode),
    GMVDetectorFaceClassificationType : @(GMVDetectorFaceClassificationAll),
    GMVDetectorFaceLandmarkType : @(GMVDetectorFaceLandmarkAll)
};
GMVDetector *faceDetector =
    [GMVDetector detectorOfType:GMVDetectorTypeFace options:options];

ML Kit

MLKFaceDetectorOptions *options = [[MLKFaceDetectorOptions alloc] init];
options.performanceMode = MLKFaceDetectorPerformanceModeAccurate;
options.classificationMode = MLKFaceDetectorClassificationModeAll;
options.landmarkMode = MLKFaceDetectorLandmarkModeAll;
MLKFaceDetector *faceDetector = [MLKFaceDetector faceDetectorWithOptions:options];

GMVDetector 有兩種不同的偵測 API。兩者都是同步作業：

- (nullable NSArray<__kindof GMVFeature *> *)
    featuresInImage:(UIImage *)image
            options:(nullable NSDictionary *)options;

- (nullable NSArray<__kindof GMVFeature *> *)
    featuresInBuffer:(CMSampleBufferRef)sampleBuffer
             options:(nullable NSDictionary *)options;

將 GMVDetector 替換為 MLKFaceDetector。推論 API 可以同步或非同步呼叫。

同步

- (nullable NSArray<MLKFace *> *)
    resultsInImage:(MLKVisionImage *)image
             error:(NSError **)error;

非同步

- (void)processImage:(MLKVisionImage *)image
    Completion:
        (MLKFaceDetectionCallback)completion
    NS_SWIFT_NAME(process(_:completion:));

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

GMV	ML Kit
`GMVFaceFeature`	`MLKFace`
`GMVFaceContour`	`MLKFaceContour`
`GMVDetectorImageOrientation`	`MLKVisionImage.orientation`
`NSDictionary` 臉部偵測選項	`MLKFaceDetectorOptions`
`GMVDetectorFaceFastMode`	`Set MLKFaceDetectorOptions.performanceMode to MLKFaceDetectorPerformanceModeFast`
`GMVDetectorFaceAccurateMode`	`Set MLKFaceDetectorOptions.performanceMode to MLKFaceDetectorPerformanceModeAccurate`
`GMVDetectorFaceSelfieMode`	`Set MLKFaceDetectorOptions.contourMode to MLKFaceDetectorContourModeAll`
`GMVDetectorFaceLandmarkType`	`MLKFaceDetectorOptions.landmarkMode`
`GMVDetectorFaceLandmarkNone`	`Set MLKFaceDetectorOptions.landmarkMode to MLKFaceDetectorLandmarkModeNone`
`GMVDetectorFaceLandmarkAll`	`Set MLKFaceDetectorOptions.landmarkMode to MLKFaceDetectorLandmarkModeAll`
`GMVDetectorFaceLandmarkContour`	`Set MLKFaceDetectorOptions.contourMode to MLKFaceDetectorContourModeAll`
`GMVDetectorFaceClassificationType`	`MLKFaceDetectorOptions.classificationMode`
`GMVDetectorFaceClassificationNone`	`Set MLKFaceDetectorOptions.classificationMode to MLKFaceDetectorClassificationModeNone`
`GMVDetectorFaceClassificationAll`	`Set MLKFaceDetectorOptions.classificationMode to MLKFaceDetectorClassificationModeAll`
`GMVDetectorFaceTrackingEnabled`	`MLKFaceDetectorOptions.trackingEnabled`
`GMVDetectorProminentFaceOnly`	`Set MLKFaceDetectorOptions.contourMode to MLKFaceDetectorContourModeAll`
`GMVDetectorFaceMinSize`	`MLKFaceDetectorOptions.minFaceSize`

BarcodeDetector

如以下範例所示，重新編寫初始化作業：

GMV

NSDictionary *options = @{
    GMVDetectorBarcodeFormats : @(GMVDetectorBarcodeFormatCode128 |
                                  GMVDetectorBarcodeFormatQRCode)
};
GMVDetector *barcodeDetector =
    [GMVDetector detectorOfType:GMVDetectorTypeBarcode options:options];

ML Kit

MLKBarcodeScannerOptions *options = [[MLKBarcodeScannerOptions alloc] init];
options.formats = MLKBarcodeFormatCode128 | MLKBarcodeFormatQRCode;
MLKBarcodeScanner *barcodeScanner =
    [MLKBarcodeScanner barcodeScannerWithOptions:options];

GMVDetector 有兩個不同的偵測 API。兩者都是同步作業：

- (nullable NSArray<__kindof GMVFeature *> *)
    featuresInImage:(UIImage *)image
            options:(nullable NSDictionary *)options;

- (nullable NSArray<__kindof GMVFeature *> *)
    featuresInBuffer:(CMSampleBufferRef)sampleBuffer
             options:(nullable NSDictionary *)options;

將 GMVDetector 替換為 MLKBarcodeScanner。推論 API 可以同步或非同步呼叫。

同步

- (nullable NSArray<MLKBarcode *> *)
    resultsInImage:(MLKVisionImage *)image
             error:(NSError **)error;

非同步

- (void)processImage:(MLKVisionImage *)image
    Completion:
        (MLKBarcodeScanningCallback)completion
    NS_SWIFT_NAME(process(_:completion:));

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

GMV	ML Kit
`GMVDetectorImageOrientation`	`MLKVisionImage.orientation`
條碼偵測工具選項的 `NSDictionary`	`MLKBarcodeScannerOptions`
`GMVDetectorBarcodeFormats`	`MLKBarcodeScannerOptions.formats`
`GMVBarcodeFeature`	`MLKBarcode`
`GMVBarcodeFeatureAddress`	`MLKBarcodeAddress`
`GMVBarcodeFeatureCalendarEvent`	`MLKBarcodeCalendarEvent`
`GMVBarcodeFeatureContactInfo`	`MLKBarcodeContactInfo`
`GMVBarcodeFeatureDriverLicense`	`MLKBarcodeDriverLicense`
`GMVBarcodeFeatureEmail`	`MLKBarcodeEmail`
`GMVBarcodeFeatureGeoPoint`	`MLKBarcodeGeoPoint`
`GMVBarcodeFeaturePersonName`	`MLKBarcodePersonName`
`GMVBarcodeFeaturePhone`	`MLKBarcodePhone`
`GMVBarcodeFeatureSMS`	`MLKBarcodeSMS`
`GMVBarcodeFeatureURLBookmark`	`MLKBarcodeURLBookmark`
`GMVBarcodeFeatureWiFi`	`MLKBarcodeWiFi`

TextRecognition

如以下範例所示，重新編寫初始化作業：

GMV

GMVDetector *textDetector =
    [GMVDetector detectorOfType:GMVDetectorTypeText options:nil];

ML Kit

MLKTextRecognizer *textRecognizer = [MLKTextRecognizer textRecognizer];

GMVDetector 有兩種不同的偵測 API。兩者都是同步作業：

- (nullable NSArray<__kindof GMVFeature *> *)
    featuresInImage:(UIImage *)image
            options:(nullable NSDictionary *)options;

- (nullable NSArray<__kindof GMVFeature *> *)
    featuresInBuffer:(CMSampleBufferRef)sampleBuffer
             options:(nullable NSDictionary *)options;

將 GMVDetector 替換為 MLKTextRecognizer。推論 API 可以同步或非同步呼叫。

同步

- (nullable MLKText *)
    resultsInImage:(MLKVisionImage *)image
             error:(NSError **)error;

非同步

- (void)processImage:(MLKVisionImage *)image
    Completion:
        (MLKTextRecognitionCallback)completion
    NS_SWIFT_NAME(process(_:completion:));

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

GMV	ML Kit
`GMVDetectorImageOrientation`	`MLKVisionImage.orientation`
`GMVTextBlockFeature`	`MLKTextBlock`
`GMVTextElementFeature`	`MLKTextElement`
`GMVTextLineFeature`	`MLKTextLine`

取得協助

如果您遇到任何問題，請前往社群頁面，我們會概略介紹可與我們聯絡的頻道。