FaceLandmarker

lớp cuối cùng công khai FaceLandmarker

Phát hiện các mốc khuôn mặt trên hình ảnh.

API này yêu cầu một gói thành phần mô hình điểm mốc cho khuôn mặt được huấn luyện trước. Hãy xem .

  • Hình ảnh đầu vào MPImage
    • Hình ảnh khi chạy tính năng phát hiện điểm mốc.
  • Đầu ra FaceLandmarkerResult
    • FaceLandmarkerResult chứa các điểm mốc trên khuôn mặt.

Lớp lồng ghép

lớp FaceLandmarker.FaceLandmarkerOptions Các tuỳ chọn để thiết lập FaceLandmarker

Trường

công khai tĩnh cuối cùng Đặt<Kết nối> FACE_LANDMARKS_CONNECTORS
công khai tĩnh cuối cùng Đặt<Kết nối> FACE_LANDMARKS_FACE_OVAL
công khai tĩnh cuối cùng Đặt<Kết nối> FACE_LANDMARKS_LEFT_EYE
công khai tĩnh cuối cùng Đặt<Kết nối> FACE_LANDMARKS_LEFT_EYE_BROW
công khai tĩnh cuối cùng Đặt<Kết nối> FACE_LANDMARKS_LEFT_IRIS
công khai tĩnh cuối cùng Đặt<Kết nối> FACE_LANDMARKS_LIPS
công khai tĩnh cuối cùng Đặt<Kết nối> FACE_LANDMARKS_RIGHT_EYE
công khai tĩnh cuối cùng Đặt<Kết nối> FACE_LANDMARKS_RIGHT_EYE_BROW
công khai tĩnh cuối cùng Đặt<Kết nối> FACE_LANDMARKS_RIGHT_IRIS
công khai tĩnh cuối cùng Đặt<Kết nối> FACE_LANDMARKS_TESSELATION

Phương thức công khai

tĩnh FaceLandmarker
createFromBuffer(Ngữ cảnh theo bối cảnh, ByteBuffer modelAssetBuffer)
Tạo một thực thể FaceLandmarker từ vùng đệm gói thành phần mô hình và FaceLandmarker.FaceLandmarkerOptions mặc định.
tĩnh FaceLandmarker
createFromFile(Ngữ cảnh ngữ cảnh, Chuỗi modelAssetPath)
Tạo một thực thể FaceLandmarker từ đường dẫn gói thành phần mô hình và FaceLandmarker.FaceLandmarkerOptions mặc định.
tĩnh FaceLandmarker
createFromFile(Ngữ cảnh ngữ cảnh, Tệp modelAssetFile)
Tạo một thực thể FaceLandmarker từ tệp gói thành phần mô hình và FaceLandmarker.FaceLandmarkerOptions mặc định.
tĩnh FaceLandmarker
createFromOptions(Ngữ cảnh theo bối cảnh, FaceLandmarker.FaceLandmarkerOptions mốcerOptions)
FaceLandmarkerResult
detect(hình ảnh MPImage)
Phát hiện mốc khuôn mặt trên một hình ảnh được cung cấp với các tuỳ chọn xử lý hình ảnh mặc định, tức là
FaceLandmarkerResult
detect(hình ảnh MPImage, ImageProcessingOptions imageprocessingOptions)
Phát hiện các mốc khuôn mặt trên một hình ảnh được cung cấp.
void
detectAsync(hình ảnh MPImage, ImageProcessingOptions imageprocessingOptions, long timestampMs)
Gửi dữ liệu hình ảnh trực tiếp để phát hiện các điểm mốc trên khuôn mặt. Bạn sẽ nhận được kết quả thông qua OutputHandler.ResultListener được cung cấp trong FaceLandmarker.FaceLandmarkerOptions.
void
detectAsync(hình ảnh MPImage, dấu thời gian dàiMs)
Gửi dữ liệu hình ảnh trực tiếp để phát hiện mốc khuôn mặt với các tuỳ chọn xử lý hình ảnh mặc định, tức là
FaceLandmarkerResult
detectForVideo(hình ảnh MPImage, ImageProcessingOptions imageprocessingOptions, long timestampMs)
Phát hiện các điểm mốc trên khuôn mặt trên khung hình video được cung cấp.
FaceLandmarkerResult
detectForVideo(hình ảnh MPImage, dấu thời gian dàiMs)
Phát hiện điểm mốc khuôn mặt trên khung video được cung cấp với các tuỳ chọn xử lý hình ảnh mặc định, tức là

Các phương thức kế thừa

Trường

công khai tĩnh cuối cùng Đặt<Kết nối> FACE_LANDMARKS_CONNECTORS

công khai tĩnh cuối cùng Đặt<Kết nối> FACE_LANDMARKS_FACE_OVAL

công khai tĩnh cuối cùng Đặt<Kết nối> FACE_LANDMARKS_LEFT_EYE

công khai tĩnh cuối cùng Đặt<Kết nối> FACE_LANDMARKS_LEFT_EYE_BROW

công khai tĩnh cuối cùng Đặt<Kết nối> FACE_LANDMARKS_LEFT_IRIS

công khai tĩnh cuối cùng Đặt<Kết nối> FACE_LANDMARKS_LIPS

công khai tĩnh cuối cùng Đặt<Kết nối> FACE_LANDMARKS_RIGHT_EYE

công khai tĩnh cuối cùng Đặt<Kết nối> FACE_LANDMARKS_RIGHT_EYE_BROW

công khai tĩnh cuối cùng Đặt<Kết nối> FACE_LANDMARKS_RIGHT_IRIS

công khai tĩnh cuối cùng Đặt<Kết nối> FACE_LANDMARKS_TESSELATION

Phương thức công khai

công khai tĩnh FaceLandmarker createFromBuffer (Ngữ cảnh ngữ cảnh, ByteBuffer modelAssetBuffer)

Tạo một thực thể FaceLandmarker từ vùng đệm gói thành phần mô hình và FaceLandmarker.FaceLandmarkerOptions mặc định.

Tham số
bối cảnh một ERROR(/Context) trên Android.
modelAssetBuffer
Gửi
nếu có lỗi trong quá trình tạo FaceLandmarker.

công khai tĩnh FaceLandmarker createFromFile (Ngữ cảnh theo bối cảnh, String modelAssetPath)

Tạo một thực thể FaceLandmarker từ đường dẫn gói thành phần mô hình và FaceLandmarker.FaceLandmarkerOptions mặc định.

Tham số
bối cảnh một ERROR(/Context) trên Android.
modelAssetPath đường dẫn đến mô hình điểm khuôn mặt với siêu dữ liệu trong tài sản.
Gửi
nếu có lỗi trong quá trình tạo FaceLandmarker.

công khai tĩnh FaceLandmarker createFromFile (Ngữ cảnh theo ngữ cảnh, File modelAssetFile)

Tạo một thực thể FaceLandmarker từ tệp gói thành phần mô hình và FaceLandmarker.FaceLandmarkerOptions mặc định.

Tham số
bối cảnh một ERROR(/Context) trên Android.
modelAssetFile thực thể File của mô hình mốc khuôn mặt.
Gửi
IOException nếu xảy ra lỗi I/O khi mở tệp mô hình tflite.
nếu có lỗi trong quá trình tạo FaceLandmarker.

công khai tĩnh FaceLandmarker createFromOptions (Ngữ cảnh theo ngữ cảnh, FaceLandmarker.FaceLandmarkerOptions Khách sạn,)

Tham số
bối cảnh một ERROR(/Context) trên Android.
landmarkerOptions một thực thể FaceLandmarker.FaceLandmarkerOptions.
Gửi
nếu có lỗi trong quá trình tạo FaceLandmarker.

công khai FaceLandmarkerResult detect (MPImage)

Phát hiện mốc khuôn mặt trên một hình ảnh được cung cấp với các tuỳ chọn xử lý hình ảnh mặc định, tức là không áp dụng chế độ xoay nào. Chỉ sử dụng phương thức này khi FaceLandmarker được tạo bằng ERROR(/RunningMode.IMAGE). VIỆC CẦN LÀM cập nhật tài liệu java cho định dạng hình ảnh đầu vào.

FaceLandmarker hỗ trợ các loại hệ màu sau:

Tham số
hình ảnh một đối tượng MPImage MediaPipe để xử lý.
Gửi
nếu có lỗi nội bộ.

công khai FaceLandmarkerResult detect (MPImage hình ảnh, ImageProcessingOptions imageprocessingOptions)

Phát hiện các mốc khuôn mặt trên một hình ảnh được cung cấp. Chỉ sử dụng phương thức này khi FaceLandmarker được tạo bằng ERROR(/RunningMode.IMAGE). VIỆC CẦN LÀM cập nhật tài liệu java cho định dạng hình ảnh đầu vào.

FaceLandmarker hỗ trợ các loại hệ màu sau:

Tham số
hình ảnh một đối tượng MPImage MediaPipe để xử lý.
imageProcessingOptions ImageProcessingOptions xác định cách xử lý hình ảnh đầu vào trước khi chạy suy luận. Lưu ý rằng tác vụ này không hỗ trợ khu vực quan tâm: việc chỉ định ImageProcessingOptions.regionOfInterest() sẽ dẫn đến việc phương thức này gửi một IllegalArgumentException.
Gửi
IllegalArgumentException nếu ImageProcessingOptions chỉ định một khu vực quan tâm.
nếu có lỗi nội bộ.

công khai vô hiệu detectAsync (MPImage hình ảnh, ImageProcessingOptions imageprocessingOptions, long timestampMs)

Gửi dữ liệu hình ảnh trực tiếp để phát hiện các điểm mốc trên khuôn mặt. Bạn sẽ nhận được kết quả thông qua OutputHandler.ResultListener được cung cấp trong FaceLandmarker.FaceLandmarkerOptions. Chỉ sử dụng phương thức này khi FaceLandmarker được tạo bằng ERROR(/RunningMode.LIVE_STREAM).

Bạn phải cung cấp dấu thời gian (tính bằng mili giây) để cho biết thời điểm hình ảnh đầu vào được gửi đến điểm mốc khuôn mặt. Dấu thời gian đầu vào phải tăng đơn điệu.

FaceLandmarker hỗ trợ các loại hệ màu sau:

Tham số
hình ảnh một đối tượng MPImage MediaPipe để xử lý.
imageProcessingOptions ImageProcessingOptions xác định cách xử lý hình ảnh đầu vào trước khi chạy suy luận. Lưu ý rằng tác vụ này không hỗ trợ khu vực quan tâm: việc chỉ định ImageProcessingOptions.regionOfInterest() sẽ dẫn đến việc phương thức này gửi một IllegalArgumentException.
timestampMs dấu thời gian nhập (tính bằng mili giây).
Gửi
IllegalArgumentException nếu ImageProcessingOptions chỉ định một khu vực quan tâm.
nếu có lỗi nội bộ.

công khai trống detectAsync (Hình ảnh MPImage, long timestampMs)

Gửi dữ liệu hình ảnh trực tiếp để phát hiện mốc khuôn mặt với các tuỳ chọn xử lý hình ảnh mặc định (tức là không áp dụng chế độ xoay nào) và kết quả sẽ có qua OutputHandler.ResultListener được cung cấp trong FaceLandmarker.FaceLandmarkerOptions. Chỉ sử dụng phương thức này khi FaceLandmarker được tạo bằng ERROR(/RunningMode.LIVE_STREAM).

Bạn phải cung cấp dấu thời gian (tính bằng mili giây) để cho biết thời điểm hình ảnh đầu vào được gửi đến điểm mốc khuôn mặt. Dấu thời gian đầu vào phải tăng đơn điệu.

FaceLandmarker hỗ trợ các loại hệ màu sau:

Tham số
hình ảnh một đối tượng MPImage MediaPipe để xử lý.
timestampMs dấu thời gian nhập (tính bằng mili giây).
Gửi
nếu có lỗi nội bộ.

công khai FaceLandmarkerResult detectForVideo (MPImage hình ảnh, ImageProcessingOptions imageprocessingOptions, long timestampMs)

Phát hiện các điểm mốc trên khuôn mặt trên khung hình video được cung cấp. Chỉ sử dụng phương thức này khi FaceLandmarker được tạo bằng ERROR(/RunningMode.VIDEO).

Bạn phải cung cấp dấu thời gian của khung hình video (tính bằng mili giây). Dấu thời gian đầu vào phải tăng đơn điệu.

FaceLandmarker hỗ trợ các loại hệ màu sau:

Tham số
hình ảnh một đối tượng MPImage MediaPipe để xử lý.
imageProcessingOptions ImageProcessingOptions xác định cách xử lý hình ảnh đầu vào trước khi chạy suy luận. Lưu ý rằng tác vụ này không hỗ trợ khu vực quan tâm: việc chỉ định ImageProcessingOptions.regionOfInterest() sẽ dẫn đến việc phương thức này gửi một IllegalArgumentException.
timestampMs dấu thời gian nhập (tính bằng mili giây).
Gửi
IllegalArgumentException nếu ImageProcessingOptions chỉ định một khu vực quan tâm.
nếu có lỗi nội bộ.

công khai FaceLandmarkerResult detectForVideo (hình ảnh MPImage, dấu thời gian dàiMs)

Phát hiện điểm mốc khuôn mặt trên khung video được cung cấp với các tuỳ chọn xử lý hình ảnh mặc định, tức là không áp dụng bất kỳ chế độ xoay nào. Chỉ sử dụng phương thức này khi FaceLandmarker được tạo bằng ERROR(/RunningMode.VIDEO).

Bạn phải cung cấp dấu thời gian của khung hình video (tính bằng mili giây). Dấu thời gian đầu vào phải tăng đơn điệu.

FaceLandmarker hỗ trợ các loại hệ màu sau:

Tham số
hình ảnh một đối tượng MPImage MediaPipe để xử lý.
timestampMs dấu thời gian nhập (tính bằng mili giây).
Gửi
nếu có lỗi nội bộ.