ImageSegmenter

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

Thực hiện phân đoạn hình ảnh trên hình ảnh.

Xin lưu ý rằng ngoài API phân đoạn chuẩn, ERROR(/segment) và ERROR(/segmentForVideo), dùng để chụp ảnh đầu vào và trả về kết quả đầu ra, nhưng liên quan đến việc sao chép sâu các kết quả trả về, ImageSegmenter cũng hỗ trợ gọi lại API, ERROR(/segmentWithResultListener) và ERROR(/segmentForVideoWithResultListener), cho phép bạn truy cập các kết quả thông qua bản sao 0.

API gọi lại hiện có sẵn cho tất cả RunningMode trong ImageSegmenter. Đặt OutputHandler.ResultListener trong ImageSegmenter.ImageSegmenterOptions đúng cách để sử dụng API callback.

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

  • Hình ảnh đầu vào MPImage
    • Hình ảnh mà trình phân đoạn hình ảnh chạy trên đó.
  • Kết quả đầu ra của ImageSegmenterResult ImageSegmenterResult
    • ImageSegmenterResult chứa các mặt nạ được phân đoạn.

Lớp lồng ghép

lớp ImageSegmenter.ImageSegmenterOptions Các tuỳ chọn để thiết lập ImageSegmenter. 
lớp ImageSegmenter.SegmentationOptions Các tuỳ chọn để định cấu hình hành vi trong thời gian chạy của ImageSegmenter. 

Phương thức công khai

tĩnh ImageSegmenter
createFromOptions(Ngữ cảnh theo ngữ cảnh, ImageSegmenter.ImageSegmenterOptions SegmenterOptions)
Tạo một thực thể ImageSegmenter từ ImageSegmenter.ImageSegmenterOptions.
List<String>
Hàm getLabels()
Lấy danh sách nhãn danh mục mà ImageSegmenter có thể nhận ra.
ImageSegmenterResult
segment(hình ảnh MPImage, ImageSegmenter.SegmentationOptions SegmentOptions)
Thực hiện phân đoạn hình ảnh trên một hình ảnh được cung cấp.
ImageSegmenterResult
segment(hình ảnh MPImage, ImageProcessingOptions imageprocessingOptions)
Thực hiện phân đoạn hình ảnh trên một hình ảnh được cung cấp.
ImageSegmenterResult
segment(hình ảnh MPImage)
Thực hiện phân đoạn hình ảnh trên một hình ảnh được cung cấp bằng các tuỳ chọn xử lý hình ảnh mặc định, tức là
void
segmentAsync(hình ảnh MPImage, ImageProcessingOptions image ProcessingOptions, long timestampMs)
Gửi dữ liệu hình ảnh trực tiếp để thực hiện phân đoạn hình ảnh và kết quả sẽ có sẵn thông qua OutputHandler.ResultListener được cung cấp trong ImageSegmenter.ImageSegmenterOptions.
void
segmentAsync(hình ảnh MPImage, ImageSegmenter.SegmentationOptions segmentsOptions, long timestampMs)
Gửi dữ liệu hình ảnh trực tiếp để thực hiện phân đoạn hình ảnh và kết quả sẽ có sẵn thông qua OutputHandler.ResultListener được cung cấp trong ImageSegmenter.ImageSegmenterOptions.
void
segmentAsync(hình ảnh MPImage, dấu thời gian dàiMs)
Gửi dữ liệu hình ảnh trực tiếp để thực hiện phân đoạn hình ảnh với các tuỳ chọn xử lý hình ảnh mặc định, tức là
ImageSegmenterResult
segmentForVideo(hình ảnh MPImage, ImageProcessingOptions imageprocessingOptions, các dấu thời gian dàiMs)
Thực hiện phân đoạn hình ảnh trên khung video đã cung cấp.
ImageSegmenterResult
segmentForVideo(hình ảnh MPImage, dấu thời gian dàiMs)
Thực hiện phân đoạn hình ảnh trên khung video được cung cấp bằng các tuỳ chọn xử lý hình ảnh mặc định, tức là
ImageSegmenterResult
segmentForVideo(hình ảnh MPImage, ImageSegmenter.SegmentationOptions segmentsOptions, long timestampMs)
Thực hiện phân đoạn hình ảnh trên khung video đã cung cấp.
void
segmentForVideoWithResultListener(hình ảnh MPImage, ImageProcessingOptions imageprocessingOptions, dấu thời gian dàiMs)
Thực hiện phân đoạn hình ảnh trên khung video đã cung cấp và cung cấp kết quả không sao chép thông qua OutputHandler.ResultListener trong ImageSegmenter.ImageSegmenterOptions.
void
segmentForVideoWithResultListener(hình ảnh MPImage, tuỳ chọn phân đoạn ImageSegmenter.SegmentationOptions, long timestampMs)
Thực hiện phân đoạn hình ảnh trên khung video đã cung cấp và cung cấp kết quả không sao chép thông qua OutputHandler.ResultListener trong ImageSegmenter.ImageSegmenterOptions.
void
segmentForVideoWithResultListener(hình ảnh MPImage, dấu thời gian dàiMs)
Thực hiện phân đoạn hình ảnh trên khung video được cung cấp bằng các tuỳ chọn xử lý hình ảnh mặc định, tức là
void
segmentWithResultListener(hình ảnh MPImage, ImageProcessingOptions imageprocessingOptions)
Thực hiện phân đoạn hình ảnh trên một hình ảnh được cung cấp và cung cấp kết quả không sao chép thông qua OutputHandler.ResultListener trong ImageSegmenter.ImageSegmenterOptions.
void
segmentWithResultListener(hình ảnh MPImage)
Thực hiện phân đoạn hình ảnh trên một hình ảnh được cung cấp bằng các tuỳ chọn xử lý hình ảnh mặc định, tức là
void
segmentWithResultListener(hình ảnh MPImage, tùy chọn phân đoạn ImageSegmenter.SegmentationOptions)
Thực hiện phân đoạn hình ảnh trên một hình ảnh được cung cấp và cung cấp kết quả không sao chép thông qua OutputHandler.ResultListener trong ImageSegmenter.ImageSegmenterOptions.

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

Phương thức công khai

công khai tĩnh ImageSegmenter createFromOptions (ContextContext, ImageSegmenter.ImageSegmenterOptions segmenterOptions)

Tạo một thực thể ImageSegmenter từ ImageSegmenter.ImageSegmenterOptions.

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

công khai Danh sách<Chuỗi> getLabels ()

Lấy danh sách nhãn danh mục mà ImageSegmenter có thể nhận ra. Đối với loại CATEGORY_Mask, chỉ mục trong mặt nạ danh mục tương ứng với danh mục trong danh sách nhãn. Đối với loại CONFIDENCE_Mask, danh sách mặt nạ đầu ra tại chỉ mục tương ứng với danh mục trong danh sách nhãn.

Nếu tệp mô hình không cung cấp labelmap, danh sách nhãn trống sẽ được trả về.

công khai ImageSegmenterResult segment (MPImage hình ảnh, ImageSegmenter.SegmentationOptionssegmentationOptions)

Thực hiện phân đoạn hình ảnh trên một hình ảnh được cung cấp. Chỉ sử dụng phương thức này khi ImageSegmenter đượ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.

ImageSegmenter 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ý.
segmentationOptions ImageSegmenter.SegmentationOptions dùng để định cấu hình hành vi trong thời gian chạy của ImageSegmenter.
Gửi
nếu có lỗi nội bộ. Hoặc nếu ImageSegmenter được tạo bằng OutputHandler.ResultListener.

công khai ImageSegmenterResult segment (MPImage ảnh, ImageProcessingOptions imageprocessingOptions)

Thực hiện phân đoạn hình ảnh trên một hình ảnh được cung cấp. Mặt nạ đầu ra có cùng kích thước với hình ảnh đầu vào. Chỉ sử dụng phương thức này khi ImageSegmenter đượ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.

ImageSegmenter 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ộ. Hoặc nếu ImageSegmenter được tạo bằng OutputHandler.ResultListener.

công khai ImageSegmenterResult phân đoạn (MPImage)

Thực hiện phân đoạn hình ảnh trên một hình ảnh được cung cấp với các tùy chọn xử lý hình ảnh mặc định, nghĩa là không áp dụng bất kỳ chế độ xoay nào. Mặt nạ đầu ra có cùng kích thước với hình ảnh đầu vào. Chỉ sử dụng phương thức này khi ImageSegmenter đượ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.

ImageSegmenter 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ộ. Hoặc nếu ImageSegmenter được tạo bằng OutputHandler.ResultListener.

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

Gửi dữ liệu hình ảnh trực tiếp để thực hiện phân đoạn hình ảnh và kết quả sẽ có sẵn thông qua OutputHandler.ResultListener được cung cấp trong ImageSegmenter.ImageSegmenterOptions. Mặt nạ đầu ra có cùng kích thước với hình ảnh đầu vào. Chỉ sử dụng phương thức này khi ImageSegmenter đượ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ân đoạn hình ảnh. Dấu thời gian đầu vào phải tăng đơn điệu.

ImageSegmenter 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 khoảng trống segmentAsync (Hình ảnh MPImage, ImageSegmenter.SegmentationOptionssegmentOptions, long timestampMs)

Gửi dữ liệu hình ảnh trực tiếp để thực hiện phân đoạn hình ảnh và kết quả sẽ có sẵn thông qua OutputHandler.ResultListener được cung cấp trong ImageSegmenter.ImageSegmenterOptions. Chỉ sử dụng phương thức này khi ImageSegmenter đượ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ân đoạn hình ảnh. Dấu thời gian đầu vào phải tăng đơn điệu.

ImageSegmenter 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ý.
segmentationOptions ImageSegmenter.SegmentationOptions dùng để định cấu hình hành vi trong thời gian chạy của ImageSegmenter.
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 trống segmentAsync (Hình ảnh MPImage, dấu thời gian dàiMs)

Gửi dữ liệu hình ảnh trực tiếp để thực hiện phân đoạn hình ảnh 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 và kết quả sẽ có qua OutputHandler.ResultListener được cung cấp trong ImageSegmenter.ImageSegmenterOptions. Mặt nạ đầu ra có cùng kích thước với hình ảnh đầu vào. Chỉ sử dụng phương thức này khi ImageSegmenter đượ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ân đoạn hình ảnh. Dấu thời gian đầu vào phải tăng đơn điệu.

ImageSegmenter 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 ImageSegmenterResult segmentForVideo (MPImage hình ảnh, ImageProcessingOptions imageprocessingOptions, long timestampMs)

Thực hiện phân đoạn hình ảnh trên khung video đã cung cấp. Mặt nạ đầu ra có cùng kích thước với hình ảnh đầu vào. Chỉ sử dụng phương thức này khi ImageSegmenter đượ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.

ImageSegmenter 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ộ. Hoặc nếu ImageSegmenter được tạo bằng OutputHandler.ResultListener.

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

Thực hiện phân đoạn hình ảnh trên khung video được cung cấp với các tuỳ chọn xử lý hình ảnh mặc định, nghĩa là không áp dụng bất kỳ chế độ xoay nào. Mặt nạ đầu ra có cùng kích thước với hình ảnh đầu vào. Chỉ sử dụng phương thức này khi ImageSegmenter đượ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.

ImageSegmenter 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ộ. Hoặc nếu ImageSegmenter được tạo bằng OutputHandler.ResultListener.

công khai ImageSegmenterResult segmentForVideo (MPImage hình ảnh, ImageSegmenter.SegmentationOptions segmentsOptions, long timestampMs)

Thực hiện phân đoạn hình ảnh trên khung video đã cung cấp. Chỉ sử dụng phương thức này khi ImageSegmenter đượ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.

ImageSegmenter 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ý.
segmentationOptions ImageSegmenter.SegmentationOptions dùng để định cấu hình hành vi trong thời gian chạy của ImageSegmenter.
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ộ. Hoặc nếu ImageSegmenter được tạo bằng OutputHandler.ResultListener.

công khai vô hiệu segmentForVideoWithResultListener (hình ảnh MPImage, ImageProcessingOptions imageprocessingOptions, dấu thời gian dàiMs)

Thực hiện phân đoạn hình ảnh trên khung video đã cung cấp và cung cấp kết quả không sao chép thông qua OutputHandler.ResultListener trong ImageSegmenter.ImageSegmenterOptions. Mặt nạ đầu ra có cùng kích thước với hình ảnh đầu vào. Chỉ sử dụng phương thức này khi ImageSegmenter đượ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.

ImageSegmenter 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
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ộ. Hoặc nếu ImageSegmenter không được tạo bằng OutputHandler.ResultListener được đặt trong ImageSegmenter.ImageSegmenterOptions.

công khai void segmentForVideoWithResultListener (hình ảnh MPImage, ImageSegmenter.SegmentationOptionssegmentOptions, long timestampMs)

Thực hiện phân đoạn hình ảnh trên khung video đã cung cấp và cung cấp kết quả không sao chép thông qua OutputHandler.ResultListener trong ImageSegmenter.ImageSegmenterOptions. Chỉ sử dụng phương thức này khi ImageSegmenter đượ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.

ImageSegmenter 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ý.
segmentationOptions ImageSegmenter.SegmentationOptions dùng để định cấu hình hành vi trong thời gian chạy của ImageSegmenter.
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ộ. Hoặc nếu ImageSegmenter không được tạo bằng OutputHandler.ResultListener được đặt trong ImageSegmenter.ImageSegmenterOptions.

công khai trống segmentForVideoWithResultListener (Hình ảnh MPImage, dấu thời gian dàiMs)

Thực hiện phân đoạn hình ảnh 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 và cung cấp kết quả không sao chép thông qua OutputHandler.ResultListener trong ImageSegmenter.ImageSegmenterOptions. Mặt nạ đầu ra có cùng kích thước với hình ảnh đầu vào. Chỉ sử dụng phương thức này khi ImageSegmenter đượ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.

ImageSegmenter 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ộ. Hoặc nếu ImageSegmenter không được tạo bằng OutputHandler.ResultListener được đặt trong ImageSegmenter.ImageSegmenterOptions.

công khai void segmentWithResultListener (Hình ảnh MPImage, ImageProcessingOptions imageprocessingOptions)

Thực hiện phân đoạn hình ảnh trên một hình ảnh được cung cấp và cung cấp kết quả không sao chép thông qua OutputHandler.ResultListener trong ImageSegmenter.ImageSegmenterOptions. Mặt nạ đầu ra có cùng kích thước với hình ảnh đầu vào. Chỉ sử dụng phương thức này khi ImageSegmenter đượ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.

ImageSegmenter 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ộ. Hoặc nếu ImageSegmenter không được tạo bằng OutputHandler.ResultListener được đặt trong ImageSegmenter.ImageSegmenterOptions.

công khai void segmentWithResultListener (Hình ảnh MPImage)

Thực hiện phân đoạn hình ảnh trên một hình ảnh được cung cấp với các tùy 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 và cung cấp kết quả không sao chép thông qua OutputHandler.ResultListener trong ImageSegmenter.ImageSegmenterOptions. Mặt nạ đầu ra có cùng kích thước với hình ảnh đầu vào. Chỉ sử dụng phương thức này khi ImageSegmenter đượ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.

ImageSegmenter 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ộ. Hoặc nếu ImageSegmenter không được tạo bằng OutputHandler.ResultListener được đặt trong ImageSegmenter.ImageSegmenterOptions.

công khai void segmentWithResultListener (Hình ảnh MPImage, ImageSegmenter.SegmentationOptionssegmentationOptions)

Thực hiện phân đoạn hình ảnh trên một hình ảnh được cung cấp và cung cấp kết quả không sao chép thông qua OutputHandler.ResultListener trong ImageSegmenter.ImageSegmenterOptions. Chỉ sử dụng phương thức này khi ImageSegmenter đượ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.

ImageSegmenter 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ý.
segmentationOptions ImageSegmenter.SegmentationOptions dùng để định cấu hình hành vi trong thời gian chạy của ImageSegmenter.
Gửi
nếu có lỗi nội bộ. Hoặc nếu ImageSegmenter không được tạo bằng OutputHandler.ResultListener được đặt trong ImageSegmenter.ImageSegmenterOptions.