HandLandmarker

公開最終類別 HandLandmarker

對圖片執行手部地標偵測。

這個 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
HandLandmarkerResult
detect(MPImage 圖片)
透過預設圖片處理選項 (即
HandLandmarkerResult
detect(MPImage 圖片、ImageProcessingOptions imageProcessingOptions)
對提供的單一圖片執行手部地標偵測。
void
detectAsync(MPImage 圖片、ImageProcessingOptions imageProcessingOptions、long timestampM)
傳送即時圖片資料,以便偵測手部地標,而結果會透過 HandLandmarker.HandLandmarkerOptions 提供的 OutputHandler.ResultListener 取得。
void
detectAsync(MPImage 圖片、長時間戳記 M)
傳送即時圖片資料,透過預設的圖片處理選項執行手地標偵測,例如
HandLandmarkerResult
detectForVideo(MPImage 圖片、ImageProcessingOptions imageProcessingOptions、long timestampM)
對提供的視訊影格執行手部地標偵測。
HandLandmarkerResult
detectForVideo(MPImage 圖片、長時間戳記 M)
透過預設的影像處理選項,對提供的影片影格執行手繪地標偵測。

繼承的方法

欄位

public static final 設定<Connection> HAND_CONNECTIONS

public static final 設定<Connection> HAND_INDEX_FINGER_CONNECTIONS

public static final 設定<Connection> HAND_MIDDLE_FINGER_CONNECTIONS

public static final 設定<Connection> HAND_PALM_CONNECTIONS

public static final 設定<Connection> HAND_PINKY_FINGER_CONNECTIONS

public static final 設定<Connection> HAND_RING_FINGER_CONNECTIONS

public static final 設定<Connection> HAND_THUMB_CONNECTIONS

公用方法

公開 靜態 HandLandmarker createFromBuffer (背景資訊結構定義、ByteBuffer modelBuffer)

從模型緩衝區和預設的 HandLandmarker.HandLandmarkerOptions 建立 HandLandmarker 例項。

參數
context Android ERROR(/Context)
modelBuffer 直接 ByteBufferERROR(/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 輸入時間戳記 (以毫秒為單位)。
擲回