iOS'te Mobil Vizyon'dan ML Kiti'ne geçiş

Bu dokümanda, projelerinizi Google Mobile Vision'dan (GMV) iOS'teki ML Kit'e taşımak için uygulamanız gereken adımlar açıklanmaktadır.

Ön koşullar

Kodunuzu taşımaya başlamadan önce, aşağıdaki gereksinimleri karşıladığınızdan emin olun:

• ML Kit, Xcode 13.2.1 veya sonraki sürümlerini destekler.
• ML Kit, iOS 10 veya sonraki sürümleri destekler.
• Makine Öğrenimi Kiti, 32 bit mimarileri (i386 ve armv7) desteklemez. ML Kit, 64 bit mimarileri (x86_64 ve arm64) destekler.

Cocoapod'ları güncelleme

Uygulamanızın Podfile dosyasında ML Kit iOS cocoapod'larının bağımlılıklarını güncelleyin:

Genel API değişiklikleri

Bu değişiklikler tüm API'ler için geçerlidir:

• GMV'nin çıkarım API'leri giriş olarak UIImage veya CMSampleBufferRef değerini alır. Makine Öğrenimi Kiti, bunları bir MLKVisionImage içine alır ve giriş olarak kullanır.
• GMV, çeşitli algılayıcı seçeneklerini iletmek için NSDictionary özelliğini kullanır. ML Kit bu amaçla özel seçenek sınıfları kullanır.
• GMV, bir algılayıcı oluşturduğunda algılayıcı türünü tek GMVDetector sınıfına iletir. ML Kit ayrı algılayıcı, tarayıcı ve tanıyıcı örnekleri oluşturmak için özel sınıflar kullanır.
• GMV'nin API'leri yalnızca eşzamanlı algılamayı destekler. ML Kit'in çıkarım API'leri eşzamanlı ve eşzamansız olarak çağrılabilir.
• GMV, AVCaptureVideoDataOutput'in kapsamını genişletir ve aynı anda birden fazla algılama gerçekleştirmenizi sağlayan bir birden fazla algılayıcı çerçevesi sağlar. ML Kit bu tür mekanizmalar sunmamaktadır, ancak istenirse aynı işlevler geliştirici tarafından uygulanabilir.

API'ye özel değişiklikler

Bu bölümde, her Vision API için ilgili GMV ve ML Kit sınıfları ile yöntemleri açıklanmakta ve API'nin nasıl başlatılacağı gösterilmektedir.

FaceDetector

Başlatma işlemini aşağıdaki örnekte gösterildiği gibi yeniden kodlayın:

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

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

GMVDetector iki farklı algılama API'sine sahiptir. Her ikisi de eşzamanlı işlemlerdir:

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

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

GMVDetector değerini MLKFaceDetector ile değiştirin. Çıkarım API'si eşzamanlı veya eşzamansız olarak çağrılabilir.

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

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

Aşağıdaki sınıfları, yöntemleri ve adları değiştirin:

BarcodeDetector

Başlatma işlemini aşağıdaki örnekte gösterildiği gibi yeniden kodlayın:

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

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

GMVDetector iki farklı algılama API'sine sahiptir. Her ikisi de eşzamanlı işlemlerdir:

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

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

GMVDetector değerini MLKBarcodeScanner ile değiştirin. Çıkarım API'si eşzamanlı veya eşzamansız olarak çağrılabilir.

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

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

Aşağıdaki sınıfları, yöntemleri ve adları değiştirin:

TextRecognition

Başlatma işlemini aşağıdaki örnekte gösterildiği gibi yeniden kodlayın:

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

MLKTextRecognizer *textRecognizer = [MLKTextRecognizer textRecognizer];

GMVDetector iki farklı algılama API'sine sahiptir. Her ikisi de eşzamanlı işlemlerdir:

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

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

GMVDetector değerini MLKTextRecognizer ile değiştirin. Çıkarım API'si eşzamanlı veya eşzamansız olarak çağrılabilir.

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

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

Aşağıdaki sınıfları, yöntemleri ve adları değiştirin:

Yardım alma

Herhangi bir sorunla karşılaşırsanız bize ulaşmak için kullanılabilecek kanalların açıklandığı Topluluk sayfamıza göz atın.