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

TextRecognizer

class TextRecognizer : NSObject

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

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

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

    بيان الإفصاح

    Swift

    class func textRecognizer(options: MLKCommonTextRecognizerOptions) -> Self

    المعلمات

    options

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

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

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

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

    بيان الإفصاح

    Swift

    func process(_ image: MLKitCompatibleImage) async throws -> MLKText

    المعلمات

    image

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

    completion

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

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

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

    بيان الإفصاح

    Swift

    func results(in image: MLKitCompatibleImage) throws -> MLKText

    المعلمات

    image

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

    error

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

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

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