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

TextRecognizer

class TextRecognizer : NSObject

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

• textRecognizer(options:)

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

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

  التعريف

  Swift

  class func textRecognizer(options: MLKCommonTextRecognizerOptions) -> Self

  المَعلمات

  options

  خيارات تهيئة أداة التعرف على النص.

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

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

• process(_:)

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

  التعريف

  Swift

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

  المَعلمات

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

• results(in:)

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

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

  التعريف

  Swift

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

  المَعلمات

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

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

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