مرجع إطار عمل MLKitFaceDetection

MLKFaceDetector


@interface MLKFaceDetector : NSObject

أداة التعرّف على الوجوه التي ترصد الوجوه في إحدى الصور

  • لعرض أداة رصد الوجوه مع الخيارات المحددة.

    التعريف

    Objective-C

    + (nonnull instancetype)faceDetectorWithOptions:
        (nonnull MLKFaceDetectorOptions *)options;

    المَعلمات

    options

    خيارات إعداد أداة رصد الوجوه.

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

    أداة رصد وجه تم ضبطها باستخدام الخيارات المحدّدة.

  • لعرض أداة رصد الوجوه باستخدام الخيارات التلقائية.

    التعريف

    Objective-C

    + (nonnull instancetype)faceDetector;

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

    أداة رصد الوجوه تم إعدادها باستخدام الخيارات التلقائية

  • غير متاح: استخدِم طُرق الفئة.

    التعريف

    Objective-C

    - (nonnull instancetype)init;
  • معالجة الصورة المحددة لرصد الوجوه

    التعريف

    Objective-C

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

    المَعلمات

    image

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

    completion

    معالج لمعاودة الاتصال على سلسلة التعليمات الرئيسية مع رصد الوجوه أو حدوث خطأ

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

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

    التعريف

    Objective-C

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

    المَعلمات

    image

    الصورة المطلوبة للحصول على نتائج

    error

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

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

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