FaceLandmarker

공개 최종 클래스 FaceLandmarker

이미지에서 얼굴 랜드마크 인식을 수행합니다.

이 API에는 선행 학습된 얼굴 특징 모델 애셋 번들이 필요합니다. 을 참조하세요.

  • 입력 이미지 MPImage
    • 랜드마크 인식을 향한 이미지가 실행됩니다.
  • 출력 FaceLandmarkerResult
    • 얼굴 랜드마크가 포함된 Face랜드erResult입니다.

중첩된 클래스

클래스 FaceLandmarker.FaceLandmarkerOptions FaceLandmarker 설정 옵션 

입력란

공개 정적 최종 Set<Connection> FACE_LANDMARKS_CONNECTORS
공개 정적 최종 Set<Connection> FACE_LANDMARKS_FACE_OVAL
공개 정적 최종 Set<Connection> FACE_LANDMARKS_LEFT_EYE
공개 정적 최종 Set<Connection> FACE_LANDMARKS_LEFT_EYE_BROW
공개 정적 최종 Set<Connection> FACE_LANDMARKS_LEFT_IRIS
공개 정적 최종 Set<Connection> FACE_LANDMARKS_LIPS
공개 정적 최종 Set<Connection> FACE_LANDMARKS_RIGHT_EYE
공개 정적 최종 Set<Connection> FACE_LANDMARKS_RIGHT_EYE_BROW
공개 정적 최종 Set<Connection> FACE_LANDMARKS_RIGHT_IRIS
공개 정적 최종 Set<Connection> FACE_LANDMARKS_TESSELATION

공개 메서드

정적 FaceLandmarker
createFromBuffer(컨텍스트 컨텍스트, ByteBuffer modelAssetBuffer)
모델 애셋 번들 버퍼와 기본 FaceLandmarker.FaceLandmarkerOptions에서 FaceLandmarker 인스턴스를 생성합니다.
정적 FaceLandmarker
createFromFile(컨텍스트 컨텍스트, String modelAssetPath)
모델 애셋 번들 경로와 기본 FaceLandmarker.FaceLandmarkerOptions에서 FaceLandmarker 인스턴스를 생성합니다.
정적 FaceLandmarker
createFromFile(컨텍스트 컨텍스트, File modelAssetFile)
모델 애셋 번들 파일과 기본 FaceLandmarker.FaceLandmarkerOptions에서 FaceLandmarker 인스턴스를 생성합니다.
정적 FaceLandmarker
createFromOptions(컨텍스트 컨텍스트, FaceLandmarker.FaceLandmarkerOptions 랜드마크인 옵션)를 입력하세요.
FaceLandmarker.FaceLandmarkerOptions에서 FaceLandmarker 인스턴스를 생성합니다.
FaceLandmarkerResult
detect(MPImage 이미지)
기본 이미지 처리 옵션(예:)을 사용하여 제공된 단일 이미지에서 얼굴 랜드마크 인식을 수행합니다.
FaceLandmarkerResult
detect(MPImage 이미지, ImageProcessingOptions imageProcessingOptions)
제공된 단일 이미지에서 얼굴 랜드마크 인식을 수행합니다.
void
detectAsync(MPImage image, ImageProcessingOptions imageProcessingOptions, long timestampMs)
실시간 이미지 데이터를 전송하여 얼굴 랜드마크 인식을 수행합니다. 결과는 FaceLandmarker.FaceLandmarkerOptions에 제공된 OutputHandler.ResultListener를 통해 확인할 수 있습니다.
void
detectAsync(MPImage 이미지, 긴 timestampMs)
실시간 이미지 데이터를 전송하여 기본 이미지 처리 옵션(예:
FaceLandmarkerResult
detectForVideo(MPImage 이미지, ImageProcessingOptions imageProcessingOptions, long timestampMs)
제공된 동영상 프레임에서 얼굴 랜드마크 인식을 실행합니다.
FaceLandmarkerResult
detectForVideo(MPImage 이미지, 긴 timestampMs)
기본 이미지 처리 옵션, 즉

상속된 메서드

입력란

공개 정적 최종 설정<연결> FACE_LANDMARKS_CONNECTORS

공개 정적 최종 설정<연결> FACE_LANDMARKS_FACE_OVAL

public static Final Set<Connection> FACE_LANDMARKS_LEFT_EYE

public static Final Set<Connection> FACE_LANDMARKS_LEFT_EYE_BROW

public static Final Set<Connection> FACE_LANDMARKS_LEFT_IRIS

public static Final Set<Connection> FACE_LANDMARKS_LIPS

public static Final Set<Connection> FACE_LANDMARKS_RIGHT_EYE

public static Final Set<Connection> FACE_LANDMARKS_RIGHT_EYE_BROW

public static Final Set<Connection> FACE_LANDMARKS_RIGHT_IRIS

public static Final Set<Connection> FACE_LANDMARKS_TESSELATION

공개 메서드

public static FaceLandmarker createFromBuffer (Context context, ByteBuffer modelAssetBuffer)

모델 애셋 번들 버퍼와 기본 FaceLandmarker.FaceLandmarkerOptions에서 FaceLandmarker 인스턴스를 생성합니다.

매개변수
context Android ERROR(/Context)
modelAssetBuffer
생성 값
FaceLandmarker 생성 중 오류가 발생하는 경우

public static FaceLandmarker createFromFile (Context context, String modelAssetPath)

모델 애셋 번들 경로와 기본 FaceLandmarker.FaceLandmarkerOptions에서 FaceLandmarker 인스턴스를 생성합니다.

매개변수
context Android ERROR(/Context)
modelAssetPath 애셋에 메타데이터가 있는 얼굴 랜드마크 모델의 경로입니다.
생성 값
FaceLandmarker 생성 중 오류가 발생하는 경우

public static FaceLandmarker createFromFile (컨텍스트 컨텍스트, 파일 modelAssetFile)

모델 애셋 번들 파일과 기본 FaceLandmarker.FaceLandmarkerOptions에서 FaceLandmarker 인스턴스를 생성합니다.

매개변수
context Android ERROR(/Context)
modelAssetFile 얼굴 랜드마크 모델 File 인스턴스
생성 값
IOException tflite 모델 파일을 열 때 I/O 오류가 발생하는지 여부
FaceLandmarker 생성 중 오류가 발생하는 경우

PublicFaceLandmarker createFromOptionsFaceLandmarker.FaceLandmarkerOptions

FaceLandmarker.FaceLandmarkerOptions에서 FaceLandmarker 인스턴스를 생성합니다.

매개변수
context Android ERROR(/Context)
landmarkerOptions FaceLandmarker.FaceLandmarkerOptions 인스턴스
생성 값
FaceLandmarker 생성 중 오류가 발생하는 경우

공개 FaceLandmarkerResult detect (MPImage 이미지)

기본 이미지 처리 옵션을 사용하여(예: 회전은 적용되지 않음) 제공된 단일 이미지에서 얼굴 랜드마크 인식을 수행합니다. ERROR(/RunningMode.IMAGE)를 사용하여 FaceLandmarker를 만들 때만 이 메서드를 사용합니다. 입력 이미지 형식의 TODO 업데이트 자바 문서

FaceLandmarker는 다음 색상 공간 유형을 지원합니다.

매개변수
이미지 처리할 MediaPipe MPImage 객체입니다.
생성 값
내부 오류가 있는 경우

공개 FaceLandmarkerResult detect (MPImage 이미지, ImageProcessingOptions imageProcessingOptions)

제공된 단일 이미지에서 얼굴 랜드마크 인식을 수행합니다. FaceLandmarker가 ERROR(/RunningMode.IMAGE)로 생성된 경우에만 이 메서드를 사용합니다. 입력 이미지 형식의 TODO 업데이트 자바 문서입니다.

FaceLandmarker는 다음 색상 공간 유형을 지원합니다.

매개변수
이미지 처리할 MediaPipe MPImage 객체입니다.
imageProcessingOptions 추론을 실행하기 전에 입력 이미지를 처리하는 방법을 지정하는 ImageProcessingOptions입니다. 관심 지역은 이 작업에서 지원되지 않습니다. ImageProcessingOptions.regionOfInterest()를 지정하면 이 메서드에서 IllegalArgumentException이 발생합니다.
생성 값
IllegalArgumentException ImageProcessingOptions가 관심 지역을 지정하는 경우입니다.
내부 오류가 있는 경우

public void detectAsync (MPImage 이미지, ImageProcessingOptions imageProcessingOptions, long timestampMs)

실시간 이미지 데이터를 전송하여 얼굴 랜드마크 인식을 수행합니다. 결과는 FaceLandmarker.FaceLandmarkerOptions에 제공된 OutputHandler.ResultListener를 통해 확인할 수 있습니다. FaceLandmarker가 ERROR(/RunningMode.LIVE_STREAM)로 생성된 경우에만 이 메서드를 사용합니다.

입력 이미지가 얼굴 랜드마크 기계로 전송되는 시점을 나타내는 타임스탬프 (밀리초)를 제공해야 합니다. 입력 타임스탬프는 단조 증가해야 합니다.

FaceLandmarker는 다음 색상 공간 유형을 지원합니다.

매개변수
이미지 처리할 MediaPipe MPImage 객체입니다.
imageProcessingOptions 추론을 실행하기 전에 입력 이미지를 처리하는 방법을 지정하는 ImageProcessingOptions입니다. 관심 지역은 이 작업에서 지원되지 않습니다. ImageProcessingOptions.regionOfInterest()를 지정하면 이 메서드에서 IllegalArgumentException이 발생합니다.
timestampMs 입력 타임스탬프 (밀리초)입니다.
생성 값
IllegalArgumentException ImageProcessingOptions가 관심 지역을 지정하는 경우입니다.
내부 오류가 있는 경우

public void detectAsync (MPImage 이미지, long timestampMs)

실시간 이미지 데이터를 전송하여 기본 이미지 처리 옵션으로 얼굴 특징 인식을 수행합니다(예: 회전 적용 없이). 결과는 FaceLandmarker.FaceLandmarkerOptions에 제공된 OutputHandler.ResultListener를 통해 확인할 수 있습니다. FaceLandmarker가 ERROR(/RunningMode.LIVE_STREAM)로 생성된 경우에만 이 메서드를 사용합니다.

입력 이미지가 얼굴 랜드마크 기계로 전송되는 시점을 나타내는 타임스탬프 (밀리초)를 제공해야 합니다. 입력 타임스탬프는 단조 증가해야 합니다.

FaceLandmarker는 다음 색상 공간 유형을 지원합니다.

매개변수
이미지 처리할 MediaPipe MPImage 객체입니다.
timestampMs 입력 타임스탬프 (밀리초)입니다.
생성 값
내부 오류가 있는 경우

공개 FaceLandmarkerResult detectForVideo (MPImage 이미지, ImageProcessingOptions imageProcessingOptions, long timestampMs)

제공된 동영상 프레임에서 얼굴 랜드마크 인식을 실행합니다. FaceLandmarker가 ERROR(/RunningMode.VIDEO)로 생성된 경우에만 이 메서드를 사용합니다.

동영상 프레임의 타임스탬프 (밀리초)를 제공해야 합니다. 입력 타임스탬프는 단조 증가해야 합니다.

FaceLandmarker는 다음 색상 공간 유형을 지원합니다.

매개변수
이미지 처리할 MediaPipe MPImage 객체입니다.
imageProcessingOptions 추론을 실행하기 전에 입력 이미지를 처리하는 방법을 지정하는 ImageProcessingOptions입니다. 관심 지역은 이 작업에서 지원되지 않습니다. ImageProcessingOptions.regionOfInterest()를 지정하면 이 메서드에서 IllegalArgumentException이 발생합니다.
timestampMs 입력 타임스탬프 (밀리초)입니다.
생성 값
IllegalArgumentException ImageProcessingOptions가 관심 지역을 지정하는 경우입니다.
내부 오류가 있는 경우

공개 FaceLandmarkerResult detectForVideo (MPImage 이미지, 긴 timestampMs)

기본 이미지 처리 옵션을 사용하여(예: 회전은 적용되지 않음) 제공된 동영상 프레임에서 얼굴 랜드마크 인식을 실행합니다. ERROR(/RunningMode.VIDEO)를 사용하여 FaceLandmarker를 만들 때만 이 메서드를 사용합니다.

동영상 프레임의 타임스탬프 (밀리초)를 제공해야 합니다. 입력 타임스탬프는 단조 증가해야 합니다.

FaceLandmarker는 다음 색상 공간 유형을 지원합니다.

매개변수
이미지 처리할 MediaPipe MPImage 객체입니다.
timestampMs 입력 타임스탬프 (밀리초)입니다.
생성 값
내부 오류가 있는 경우