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을 반환합니다. 얼굴 인식은 호출 스레드에서 동기식으로 실행됩니다.

    UI가 차단되지 않도록 하려면 기본 스레드에서 이 메서드를 호출하는 것이 좋습니다. 따라서 이 메서드가 기본 스레드에서 호출되면 NSException이 발생합니다.

    선언

    Objective-C

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

    매개변수

    image

    결과를 가져올 이미지입니다.
    error

    결과를 가져오는 중에 오류가 발생할 때 채워지는 선택적 오류 매개변수입니다.

    반환 값

    얼굴 배열은 지정된 이미지를 반환하거나 오류가 있는 경우 nil입니다.