مهاجرت از Mobile Vision به کیت ML در iOS

این سند مراحلی را که باید برای انتقال پروژه‌های خود از Google Mobile Vision (GMV) به ML Kit در iOS انجام دهید، پوشش می‌دهد.

پیش‌نیازها

قبل از شروع به انتقال کد خود، مطمئن شوید که این الزامات را برآورده می‌کنید:

  • کیت ML از Xcode نسخه ۱۳.۲.۱ یا بالاتر پشتیبانی می‌کند.
  • ML Kit از iOS نسخه ۱۵.۵ یا بالاتر پشتیبانی می‌کند.
  • ML Kit از معماری‌های ۳۲ بیتی (i386 و armv7) پشتیبانی نمی‌کند. ML Kit از معماری‌های ۶۴ بیتی (x86_64 و arm64) پشتیبانی می‌کند.
کاکائوپادها را به‌روزرسانی کنید

وابستگی‌های cocoapods مربوط به ML Kit iOS را در Podfile برنامه خود به‌روزرسانی کنید:

رابط برنامه‌نویسی کاربردی غلاف GMV پاد کیت ML
اسکن بارکد GoogleMobileVision/BarcodeDetector GoogleMLKit/BarcodeScanning
تشخیص چهره GoogleMobileVision/FaceDetector GoogleMLKit/FaceDetection
تشخیص متن GoogleMobileVision/TextDetector GoogleMLKit/TextRecognition
تغییرات کلی API

این تغییرات برای همه APIها اعمال می‌شود:

  • APIهای استنتاج GMV، UIImage یا CMSampleBufferRef را به عنوان ورودی دریافت می‌کنند. ML Kit آنها را درون یک MLKVisionImage قرار می‌دهد و آن را به عنوان ورودی دریافت می‌کند.
  • GMV از NSDictionary برای ارسال گزینه‌های مختلف آشکارساز استفاده می‌کند. ML Kit از کلاس‌های گزینه‌های اختصاصی برای این منظور استفاده می‌کند.
  • GMV هنگام ایجاد یک آشکارساز، نوع آشکارساز را به کلاس GMVDetector منتقل می‌کند. ML Kit از کلاس‌های اختصاصی برای ایجاد نمونه‌های جداگانه آشکارساز، اسکنر و تشخیص‌دهنده استفاده می‌کند.
  • APIهای GMV فقط از تشخیص همزمان پشتیبانی می‌کنند. APIهای استنتاج ML Kit را می‌توان به صورت همزمان و غیرهمزمان فراخوانی کرد.
  • GMV، AVCaptureVideoDataOutput را توسعه می‌دهد و یک چارچوب چند آشکارسازی برای انجام چندین تشخیص به طور همزمان ارائه می‌دهد. ML Kit چنین مکانیسم‌هایی را ارائه نمی‌دهد، اما در صورت تمایل، توسعه‌دهنده می‌تواند همین عملکرد را پیاده‌سازی کند.
تغییرات خاص API

این بخش کلاس‌ها و متدهای مربوط به GMV و ML Kit را برای هر Vision API شرح می‌دهد و نحوه مقداردهی اولیه API را نشان می‌دهد.

آشکارساز چهره

مقداردهی اولیه را همانطور که در این مثال نشان داده شده است، بازنویسی کنید:

جی ام وی 
NSDictionary *options = @{
    GMVDetectorFaceMode : @(GMVDetectorFaceAccurateMode),
    GMVDetectorFaceClassificationType : @(GMVDetectorFaceClassificationAll),
    GMVDetectorFaceLandmarkType : @(GMVDetectorFaceLandmarkAll)
};
GMVDetector *faceDetector =
    [GMVDetector detectorOfType:GMVDetectorTypeFace options:options];
کیت ML 
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:));

کلاس‌ها، متدها و نام‌های زیر را تغییر دهید:

جی ام وی کیت ML
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
آشکارساز بارکد

مقداردهی اولیه را همانطور که در این مثال نشان داده شده است، بازنویسی کنید:

جی ام وی 
NSDictionary *options = @{
    GMVDetectorBarcodeFormats : @(GMVDetectorBarcodeFormatCode128 |
                                  GMVDetectorBarcodeFormatQRCode)
};
GMVDetector *barcodeDetector =
    [GMVDetector detectorOfType:GMVDetectorTypeBarcode options:options];
کیت ML 
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 جایگزین کنید. رابط برنامه‌نویسی استنتاج (inference API) را می‌توان به صورت همزمان یا غیرهمزمان فراخوانی کرد.

همزمان 
- (nullable NSArray<MLKBarcode *> *)
    resultsInImage:(MLKVisionImage *)image
             error:(NSError **)error;
ناهمزمان 
- (void)processImage:(MLKVisionImage *)image
    Completion:
        (MLKBarcodeScanningCallback)completion
    NS_SWIFT_NAME(process(_:completion:));

کلاس‌ها، متدها و نام‌های زیر را تغییر دهید:

جی ام وی کیت ML
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
تشخیص متن

مقداردهی اولیه را همانطور که در این مثال نشان داده شده است، بازنویسی کنید:

جی ام وی 
GMVDetector *textDetector =
    [GMVDetector detectorOfType:GMVDetectorTypeText options:nil];
کیت ML 
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 جایگزین کنید. رابط برنامه‌نویسی استنتاج می‌تواند به صورت همزمان یا غیرهمزمان فراخوانی شود.

همزمان 
- (nullable MLKText *)
    resultsInImage:(MLKVisionImage *)image
             error:(NSError **)error;
ناهمزمان 
- (void)processImage:(MLKVisionImage *)image
    Completion:
        (MLKTextRecognitionCallback)completion
    NS_SWIFT_NAME(process(_:completion:));

کلاس‌ها، متدها و نام‌های زیر را تغییر دهید:

جی ام وی کیت ML
GMVDetectorImageOrientation MLKVisionImage.orientation
GMVTextBlockFeature MLKTextBlock
GMVTextElementFeature MLKTextElement
GMVTextLineFeature MLKTextLine
دریافت کمک

اگر با هرگونه مشکلی مواجه شدید، به صفحه انجمن ما مراجعه کنید، جایی که کانال‌های موجود برای ارتباط با ما را شرح داده‌ایم.