MLKitFaceDetection 프레임워크 참조

FaceDetector

class FaceDetector : NSObject

이미지에서 얼굴을 인식하는 얼굴 감지기입니다.

  • 지정된 옵션으로 얼굴 인식기를 반환합니다.

    선언

    Swift

    class func faceDetector(options: MLKFaceDetectorOptions) -> Self

    매개변수

    options

    얼굴 감지기 구성을 위한 옵션입니다.

    반환 값

    특정 옵션으로 구성된 얼굴 감지기입니다.

  • 기본 옵션으로 얼굴 인식기를 반환합니다.

    선언

    Swift

    class func faceDetector() -> Self

    반환 값

    기본 옵션으로 구성된 얼굴 감지기입니다.

  • 사용할 수 없습니다. 클래스 메서드를 사용합니다.

  • 얼굴 인식을 위해 지정된 이미지를 처리합니다.

    선언

    Swift

    func process(_ image: MLKitCompatibleImage, completion: @escaping FaceDetectionCallback)

    매개변수

    image

    처리할 이미지입니다.

    completion

    얼굴이 감지되었거나 오류가 있는 기본 스레드에서 콜백하는 핸들러입니다.

  • 지정된 이미지의 얼굴 결과를 반환하거나 오류가 있으면 nil을 반환합니다. 얼굴 인식은 호출 스레드에서 동기식으로 실행됩니다.

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

    선언

    Swift

    func results(in image: MLKitCompatibleImage) throws -> [MLKFace]

    매개변수

    image

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

    error

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

    반환 값

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