對圖片執行手部地標偵測。
這個 API 會使用預先訓練的手持地標模型資產包。請參閱
- 輸入圖片
MPImage
- 手持地標偵測功能的圖片執行。
- 輸出 ComLandmarkerResult
HandLandmarkerResult
- 包含手地標的 HandLandmarkerResult。
巢狀類別
類別 | HandLandmarker.HandLandmarkerOptions | 設定 HandLandmarker 的選項。 |
欄位
公開靜態最終 Set<Connection> | HAND_CONNECTIONS | |
公開靜態最終 Set<Connection> | HAND_INDEX_FINGER_CONNECTIONS | |
公開靜態最終 Set<Connection> | HAND_MIDDLE_FINGER_CONNECTIONS | |
公開靜態最終 Set<Connection> | HAND_PALM_CONNECTIONS | |
公開靜態最終 Set<Connection> | HAND_PINKY_FINGER_CONNECTIONS | |
公開靜態最終 Set<Connection> | HAND_RING_FINGER_CONNECTIONS | |
公開靜態最終 Set<Connection> | HAND_THUMB_CONNECTIONS |
公用方法
靜態標記 HandLandmarker |
createFromBuffer(背景資訊、ByteBuffer modelBuffer)
從模型緩衝區和預設的
HandLandmarker.HandLandmarkerOptions 建立 HandLandmarker 例項。 |
靜態標記 HandLandmarker |
createFromFile(背景資訊、String modelPath)
從模型檔案和預設的
HandLandmarker.HandLandmarkerOptions 建立 HandLandmarker 例項。 |
靜態標記 HandLandmarker |
createFromFile(背景資訊、檔案 modelFile)
從模型檔案和預設的
HandLandmarker.HandLandmarkerOptions 建立 HandLandmarker 例項。 |
靜態標記 HandLandmarker |
createFromOptions(內容結構定義、HandLandmarker.HandLandmarkerOptions地方標記選項)
|
HandLandmarkerResult | |
HandLandmarkerResult | |
void |
detectAsync(MPImage 圖片、ImageProcessingOptions imageProcessingOptions、long timestampM)
傳送即時圖片資料,以便偵測手部地標,而結果會透過
HandLandmarker.HandLandmarkerOptions 提供的 OutputHandler.ResultListener 取得。 |
void | |
HandLandmarkerResult |
detectForVideo(MPImage 圖片、ImageProcessingOptions imageProcessingOptions、long timestampM)
對提供的視訊影格執行手部地標偵測。
|
HandLandmarkerResult |
繼承的方法
欄位
公用方法
公開 靜態 HandLandmarker createFromBuffer (背景資訊結構定義、ByteBuffer modelBuffer)
從模型緩衝區和預設的 HandLandmarker.HandLandmarkerOptions
建立 HandLandmarker
例項。
參數
context | Android ERROR(/Context) 。 |
---|---|
modelBuffer | 直接 ByteBuffer 或 ERROR(/MappedByteBuffer) 偵測模型。 |
擲回
如果 HandLandmarker 建立期間發生錯誤。
|
公開 靜態 HandLandmarker createFromFile (背景資訊結構定義、String modelPath)
從模型檔案和預設的 HandLandmarker.HandLandmarkerOptions
建立 HandLandmarker
例項。
參數
context | Android ERROR(/Context) 。 |
---|---|
modelPath | 到手地標模型路徑,且該模型含有資產的中繼資料。 |
擲回
如果 HandLandmarker 建立期間發生錯誤。
|
公開 靜態 HandLandmarker createFromFile (內容結構定義、檔案 modelFile)
從模型檔案和預設的 HandLandmarker.HandLandmarkerOptions
建立 HandLandmarker
例項。
參數
context | Android ERROR(/Context) 。 |
---|---|
modelFile | 這裡的手界位置會模擬 File 例項。 |
擲回
IOException | 在開啟 tflite 模型檔案時發生 I/O 錯誤時。 |
---|---|
如果 HandLandmarker 建立期間發生錯誤。
|
public static HandLandmarker createFromOptions (內容結構定義、HandLandmarker.HandLandmarkerOptionsmarkerOptions)
參數
context | Android ERROR(/Context) 。 |
---|---|
landmarkerOptions | HandLandmarker.HandLandmarkerOptions 執行個體。 |
擲回
如果 HandLandmarker 建立期間發生錯誤。
|
public HandLandmarkerResult detect (MPImage 圖片)
透過預設的圖片處理選項 (即不套用任何旋轉),對提供的單一圖片執行手部地標偵測。只有在使用 ERROR(/RunningMode.IMAGE)
建立 HandLandmarker
時,才能使用這個方法。TODO 為輸入圖片格式更新 Java 文件。
HandLandmarker
支援下列色彩空間類型:
參數
圖片 | 要處理的 MediaPipe MPImage 物件。 |
---|
擲回
。 |
public HandLandmarkerResult detect (MPImage 圖片、ImageProcessingOptions imageProcessingOptions)
對提供的單一圖片執行手部地標偵測。只有在使用 ERROR(/RunningMode.IMAGE)
建立 HandLandmarker
時,才能使用這個方法。TODO 為輸入圖片格式更新 Java 文件。
HandLandmarker
支援下列色彩空間類型:
參數
圖片 | 要處理的 MediaPipe MPImage 物件。 |
---|---|
imageProcessingOptions | 用於指定在執行推論之前如何處理輸入圖片的 ImageProcessingOptions 。請注意,這項工作「不」支援搜尋區域:指定 ImageProcessingOptions.regionOfInterest() 會導致這個方法擲回 IllegalArgumentException。 |
擲回
IllegalArgumentException | 表示 ImageProcessingOptions 指定搜尋區域。 |
---|---|
。 |
public void detectAsync (MPImage image、ImageProcessingOptions imageProcessingOptions、long timestampMs)
傳送即時圖片資料,以便偵測手部地標,而結果會透過 HandLandmarker.HandLandmarkerOptions
提供的 OutputHandler.ResultListener
取得。只有在使用 ERROR(/RunningMode.LIVE_STREAM)
建立 HandLandmarker
時,才能使用這個方法。
必須提供時間戳記 (以毫秒為單位),指出輸入圖片傳送至手部位置標記的時間。輸入時間戳記必須單純遞增。
HandLandmarker
支援下列色彩空間類型:
參數
圖片 | 要處理的 MediaPipe MPImage 物件。 |
---|---|
imageProcessingOptions | 用於指定在執行推論之前如何處理輸入圖片的 ImageProcessingOptions 。請注意,這項工作「不」支援搜尋區域:指定 ImageProcessingOptions.regionOfInterest() 會導致這個方法擲回 IllegalArgumentException。 |
timestampMs | 輸入時間戳記 (以毫秒為單位)。 |
擲回
IllegalArgumentException | 表示 ImageProcessingOptions 指定搜尋區域。 |
---|---|
。 |
public void detectAsync (MPImage 圖片、長 timestampM)
傳送即時圖片資料,透過預設圖片處理選項 (即未套用任何旋轉) 偵測手部地標,而結果會透過 HandLandmarker.HandLandmarkerOptions
提供的 OutputHandler.ResultListener
取得。只有在使用 ERROR(/RunningMode.LIVE_STREAM)
建立 HandLandmarker
時,才能使用這個方法。
必須提供時間戳記 (以毫秒為單位),指出輸入圖片傳送至手部位置標記的時間。輸入時間戳記必須單純遞增。
HandLandmarker
支援下列色彩空間類型:
參數
圖片 | 要處理的 MediaPipe MPImage 物件。 |
---|---|
timestampMs | 輸入時間戳記 (以毫秒為單位)。 |
擲回
。 |
public HandLandmarkerResult detectForVideo (MPImage image、ImageProcessingOptions imageProcessingOptions, long timestampMs)
對提供的視訊影格執行手部地標偵測。只有在使用 ERROR(/RunningMode.VIDEO)
建立 HandLandmarker
時,才能使用這個方法。
您必須提供影片影格的時間戳記 (以毫秒為單位)。輸入時間戳記必須單純遞增。
HandLandmarker
支援下列色彩空間類型:
參數
圖片 | 要處理的 MediaPipe MPImage 物件。 |
---|---|
imageProcessingOptions | 用於指定在執行推論之前如何處理輸入圖片的 ImageProcessingOptions 。請注意,這項工作「不」支援搜尋區域:指定 ImageProcessingOptions.regionOfInterest() 會導致這個方法擲回 IllegalArgumentException。 |
timestampMs | 輸入時間戳記 (以毫秒為單位)。 |
擲回
IllegalArgumentException | 表示 ImageProcessingOptions 指定搜尋區域。 |
---|---|
。 |
public HandLandmarkerResult detectForVideo (MPImage 圖片、長 timestampM)
透過預設的影像處理選項 (即不套用任何旋轉),對提供的影片影格執行手繪地標偵測。只有在使用 ERROR(/RunningMode.VIDEO)
建立 HandLandmarker
時,才能使用這個方法。
您必須提供影片影格的時間戳記 (以毫秒為單位)。輸入時間戳記必須單純遞增。
HandLandmarker
支援下列色彩空間類型:
參數
圖片 | 要處理的 MediaPipe MPImage 物件。 |
---|---|
timestampMs | 輸入時間戳記 (以毫秒為單位)。 |
擲回
。 |