Phát hiện điểm mốc trên tay trên hình ảnh.
API này yêu cầu một gói thành phần mô hình địa danh đã được huấn luyện trước. Hãy xem
- Hình ảnh đầu vào
MPImage
- Hình ảnh khi phát hiện điểm mốc chạy trên đó.
- Dữ liệu đầu ra HandLandmarkerResult
HandLandmarkerResult
- TayLandmarkerResult chứa các điểm mốc trên kim tay.
Lớp lồng ghép
lớp | HandLandmarker.HandLandmarkerOptions | Các tuỳ chọn để thiết lập HandLandmarker . |
Trường
công khai tĩnh cuối cùng Đặt<Kết nối> | HAND_CONNECTIONS | |
công khai tĩnh cuối cùng Đặt<Kết nối> | HAND_INDEX_FINGER_CONNECTIONS | |
công khai tĩnh cuối cùng Đặt<Kết nối> | HAND_MIDDLE_FINGER_CONNECTIONS | |
công khai tĩnh cuối cùng Đặt<Kết nối> | HAND_PALM_CONNECTIONS | |
công khai tĩnh cuối cùng Đặt<Kết nối> | HAND_PINKY_FINGER_CONNECTIONS | |
công khai tĩnh cuối cùng Đặt<Kết nối> | HAND_RING_FINGER_CONNECTIONS | |
công khai tĩnh cuối cùng Đặt<Kết nối> | HAND_THUMB_CONNECTIONS |
Phương thức công khai
tĩnh HandLandmarker |
createFromBuffer(Ngữ cảnh theo bối cảnh, ByteBuffer modelBuffer)
Tạo một thực thể
HandLandmarker từ vùng đệm mô hình và HandLandmarker.HandLandmarkerOptions mặc định. |
tĩnh HandLandmarker |
createFromFile(Ngữ cảnh, String modelPath)
Tạo một thực thể
HandLandmarker từ tệp mô hình và HandLandmarker.HandLandmarkerOptions mặc định. |
tĩnh HandLandmarker |
createFromFile(Ngữ cảnh ngữ cảnh, Tệp modelFile)
Tạo một thực thể
HandLandmarker từ tệp mô hình và HandLandmarker.HandLandmarkerOptions mặc định. |
tĩnh HandLandmarker |
createFromOptions(Ngữ cảnh theo bối cảnh, HandLandmarker.HandLandmarkerOptions mốcerOptions)
Tạo một thực thể
HandLandmarker từ HandLandmarker.HandLandmarkerOptions . |
HandLandmarkerResult | |
HandLandmarkerResult |
detect(hình ảnh MPImage, ImageProcessingOptions imageprocessingOptions)
Phát hiện các điểm mốc trên tay 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 điểm mốc trên tay và kết quả sẽ có qua
OutputHandler.ResultListener được cung cấp trong HandLandmarker.HandLandmarkerOptions . |
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 điểm mốc trên tay với các tuỳ chọn xử lý hình ảnh mặc định, tức là
|
HandLandmarkerResult |
detectForVideo(hình ảnh MPImage, ImageProcessingOptions imageprocessingOptions, long timestampMs)
Phát hiện điểm mốc trên tay trên khung hình video được cung cấp.
|
HandLandmarkerResult |
detectForVideo(hình ảnh MPImage, dấu thời gian dàiMs)
Phát hiện điểm mốc trên tay 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
Phương thức công khai
công khai tĩnh HandLandmarker createFromBuffer (Ngữ cảnh ngữ cảnh, ByteBuffer modelBuffer)
Tạo một thực thể HandLandmarker
từ vùng đệm mô hình và HandLandmarker.HandLandmarkerOptions
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 HandLandmarker .
|
công khai tĩnh HandLandmarker createFromFile (Ngữ cảnh ngữ cảnh, Chuỗi mô hìnhPath)
Tạo một thực thể HandLandmarker
từ tệp mô hình và HandLandmarker.HandLandmarkerOptions
mặc định.
Thông số
bối cảnh | một ERROR(/Context) trên Android. |
---|---|
modelPath | đường dẫn đến mô hình điểm mốc trong ví dụ có siêu dữ liệu trong tài sản. |
Gửi
nếu có lỗi trong quá trình tạo HandLandmarker .
|
công khai tĩnh HandLandmarker createFromFile (Ngữ cảnh ngữ cảnh, Tệp mô hìnhFile)
Tạo một thực thể HandLandmarker
từ tệp mô hình và HandLandmarker.HandLandmarkerOptions
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 mốc kim. |
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 HandLandmarker .
|
công khai tĩnh HandLandmarker createFromOptions (Ngữ cảnh theo bối cảnh, HandLandmarker.HandLandmarkerOptions Khách sạn của tùy chọn)
Tạo một thực thể HandLandmarker
từ HandLandmarker.HandLandmarkerOptions
.
Thông số
bối cảnh | một ERROR(/Context) trên Android. |
---|---|
landmarkerOptions | một thực thể HandLandmarker.HandLandmarkerOptions . |
Gửi
nếu có lỗi trong quá trình tạo HandLandmarker .
|
công khai HandLandmarkerResult detect (MPImage)
Phát hiện điểm mốc kim 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 bất kỳ chế độ xoay nào. Chỉ sử dụng phương thức này khi HandLandmarker
đượ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.
HandLandmarker
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 HandLandmarkerResult detect (MPImage hình ảnh, ImageProcessingOptions imageprocessingOptions)
Phát hiện các điểm mốc trên tay trên một hình ảnh được cung cấp. Chỉ sử dụng phương thức này khi HandLandmarker
đượ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.
HandLandmarker
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 điểm mốc trên tay và kết quả sẽ có qua OutputHandler.ResultListener
được cung cấp trong HandLandmarker.HandLandmarkerOptions
. Chỉ sử dụng phương thức này khi HandLandmarker
đượ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 trên kim chỉ. Dấu thời gian đầu vào phải tăng đơn điệu.
HandLandmarker
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 điểm mốc trên tay 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 HandLandmarker.HandLandmarkerOptions
. Chỉ sử dụng phương thức này khi HandLandmarker
đượ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 trên kim chỉ. Dấu thời gian đầu vào phải tăng đơn điệu.
HandLandmarker
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 HandLandmarkerResult detectForVideo (MPImage hình ảnh, ImageProcessingOptions imageprocessingOptions, dấu thời gian dàiMs)
Phát hiện điểm mốc trên tay trên khung hình video được cung cấp. Chỉ sử dụng phương thức này khi HandLandmarker
đượ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.
HandLandmarker
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 HandLandmarkerResult detectForVideo (MPImage hình ảnh, dấu thời gian dàiMs)
Phát hiện điểm mốc kim 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 HandLandmarker
đượ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.
HandLandmarker
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ộ. |