مرجع إطار عمل MLKitText learning Common

MLKTextRecognizer


@interface MLKTextRecognizer : NSObject

أداة للتعرّف على النص في الصورة

  • لعرض أداة التعرّف على النص بالخيارات المحددة.

    الاستخدام المتزامن لمثيلات TextRecognizer متعددة بلغة مختلفة لا يُنصح باستخدامها، لأنّها قد تؤدي إلى تدهور الأداء.

    بيان الإفصاح

    Objective-C

    + (nonnull instancetype)textRecognizerWithOptions:
        (nonnull MLKCommonTextRecognizerOptions *)options;

    المعلمات

    options

    خيارات ضبط أداة التعرّف على النص

    القيمة المعروضة

    أداة التعرّف على النص التي تم ضبطها مع الخيارات المحدّدة.

  • لمعالجة الصورة المحددة للتعرّف على النص.

    بيان الإفصاح

    Objective-C

    - (void)processImage:(nonnull id<MLKCompatibleImage>)image
              completion:(nonnull MLKTextRecognitionCallback)completion;

    المعلمات

    image

    الصورة المطلوب معالجتها

    completion

    يمكن للمعالج معاودة الاتصال في قائمة الانتظار الرئيسية عند اكتمال التعرف على النص.

  • عرض نتيجة التعرف على النص في الصورة المحددة أو nil إذا كان هناك خطأ. النص التعرف على الهوية بشكل متزامن في سلسلة الاتصال.

    يُنصح باستدعاء هذه الطريقة خارج سلسلة التعليمات الرئيسية لتجنّب حظر واجهة المستخدم. نتيجة لذلك، أُنشئت مكتبة مات بلوت ليب في النتيجة، يتم رفع NSException إذا تم استدعاء هذه الطريقة في سلسلة التعليمات الرئيسية.

    بيان الإفصاح

    Objective-C

    - (nullable MLKText *)resultsInImage:(nonnull id<MLKCompatibleImage>)image
                                   error:(NSError *_Nullable *_Nullable)error;

    المعلمات

    image

    الصورة التي يتم الحصول على نتائج فيها.

    error

    مَعلمة خطأ اختيارية تتمّ تعبئتها عند حدوث خطأ في الحصول على النتائج.

    القيمة المعروضة

    ينتج عن التعرّف على النص الصورة المحدّدة أو nil إذا كان هناك خطأ.