FaceDetector

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

Thực hiện phát hiện khuôn mặt trên hình ảnh.

API yêu cầu phiên bản TFLite có Siêu dữ liệu mô hình TFLite.

  • Hình ảnh đầu vào MPImage
    • Hình ảnh mà trình phát hiện khuôn mặt chạy trên đó.
  • Đầu ra FaceDetectorResult FaceDetectorResult
    • Một FaceDetectorResult chứa các khuôn mặt được phát hiện.

Lớp lồng ghép

lớp FaceDetector.FaceDetectorOptions Các tuỳ chọn thiết lập FaceDetector. 

Phương thức công khai

Tĩnh FaceDetector
createFromBuffer(Ngữ cảnh theo bối cảnh, ByteBuffer modelBuffer)
Tạo một thực thể FaceDetector từ vùng đệm mô hình và FaceDetector.FaceDetectorOptions mặc định.
Tĩnh FaceDetector
createFromFile(Ngữ cảnh, String modelPath)
Tạo một thực thể FaceDetector từ tệp mô hình và FaceDetector.FaceDetectorOptions mặc định.
Tĩnh FaceDetector
createFromFile(Ngữ cảnh ngữ cảnh, Tệp modelFile)
Tạo một thực thể FaceDetector từ tệp mô hình và FaceDetector.FaceDetectorOptions mặc định.
Tĩnh FaceDetector
createFromOptions(Ngữ cảnh ngữ cảnh, FaceDetector.FaceDetectorOptions detectOptions)
Tạo một thực thể FaceDetector từ FaceDetector.FaceDetectorOptions.
FaceDetectorResult
detect(hình ảnh MPImage)
Phát hiện 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à
FaceDetectorResult
detect(hình ảnh MPImage, ImageProcessingOptions imageprocessingOptions)
Phát hiện 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 khuôn mặt, và kết quả sẽ có qua OutputHandler.ResultListener được cung cấp trong FaceDetector.FaceDetectorOptions.
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 khuôn mặt với các tuỳ chọn xử lý hình ảnh mặc định, tức là
FaceDetectorResult
detectForVideo(hình ảnh MPImage, ImageProcessingOptions imageprocessingOptions, long timestampMs)
Phát hiện khuôn mặt trên khung hình video được cung cấp.
FaceDetectorResult
detectForVideo(hình ảnh MPImage, dấu thời gian dàiMs)
Phát hiện 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

Phương thức công khai

công khai tĩnh FaceDetector createFromBuffer (Ngữ cảnh ngữ cảnh, ByteBuffer modelBuffer)

Tạo một thực thể FaceDetector từ vùng đệm mô hình và FaceDetector.FaceDetectorOptions mặc định.

Thông số
bối cảnh một ERROR(/Context) trên Android.
modelBuffer ByteBuffer trực tiếp hoặc ERROR(/MappedByteBuffer) của mô hình phát hiện.
Gửi
nếu có lỗi trong quá trình tạo FaceDetector.

công khai tĩnh FaceDetector createFromFile (Ngữ cảnh ngữ cảnh, String modelPath)

Tạo một thực thể FaceDetector từ tệp mô hình và FaceDetector.FaceDetectorOptions mặc định.

Thông số
bối cảnh một ERROR(/Context) trên Android.
modelPath đến mô hình phát hiện có siêu dữ liệu trong tài sản.
Gửi
nếu có lỗi trong quá trình tạo FaceDetector.

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

Tạo một thực thể FaceDetector từ tệp mô hình và FaceDetector.FaceDetectorOptions mặc định.

Thông số
bối cảnh một ERROR(/Context) trên Android.
modelFile thực thể File của mô hình phát hiện.
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 FaceDetector.

công khai tĩnh FaceDetector createFromOptions (Ngữ cảnh ngữ cảnh, FaceDetector.FaceDetectorOptionsdetectOptions)

Tạo một thực thể FaceDetector từ FaceDetector.FaceDetectorOptions.

Thông số
bối cảnh một ERROR(/Context) trên Android.
detectorOptions một thực thể FaceDetector.FaceDetectorOptions.
Gửi
nếu có lỗi trong quá trình tạo FaceDetector.

công khai FaceDetectorResult detect (MPImage)

Phát hiện 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 FaceDetector được tạo bằng ERROR(/RunningMode.IMAGE).

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

Thông 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 FaceDetectorResult detect (MPImage ảnh, ImageProcessingOptions imageprocessingOptions)

Phát hiện 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 FaceDetector được tạo bằng ERROR(/RunningMode.IMAGE).

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

Thông 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 khuôn mặt, và kết quả sẽ có qua OutputHandler.ResultListener được cung cấp trong FaceDetector.FaceDetectorOptions. Chỉ sử dụng phương thức này khi FaceDetector đượ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 trình phát hiện khuôn mặt. Dấu thời gian đầu vào phải tăng đơn điệu.

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

Thông 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 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 FaceDetector.FaceDetectorOptions. Chỉ sử dụng phương thức này khi FaceDetector đượ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 trình phát hiện khuôn mặt. Dấu thời gian đầu vào phải tăng đơn điệu.

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

Thông 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 FaceDetectorResult detectForVideo (MPImage hình ảnh, ImageProcessingOptions image ProcessingOptions, long timestampMs)

Phát hiệ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 FaceDetector đượ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.

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

Thông 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 FaceDetectorResult detectForVideo (MPImage hình ảnh, dấu thời gian dàiMs)

Phát hiện khuôn mặt trên khung hình 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 FaceDetector đượ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.

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

Thông 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ộ.