PoseLandmarker

公開最終類別 PoseLandmarker

對圖片執行姿勢地標偵測。

這個 API 會使用預先訓練的姿勢地標模型素材資源組合。請參閱

  • 輸入圖片 MPImage
    • 擺動地標偵測功能的圖片開始執行。
  • 輸出 PoseLandmarkerResult PoseLandmarkerResult
    • 包含姿勢地標的 PoseLandmarkerResult。

巢狀類別

類別 PoseLandmarker.PoseLandmarkerOptions 設定 PoseLandmarker 的選項。 

欄位

公開靜態最終 Set<Connection> POSE_LANDMARKS

公用方法

Static PoseLandmarker
createFromBuffer(背景資訊、ByteBuffer modelBuffer)
從模型緩衝區和預設的 PoseLandmarker.PoseLandmarkerOptions 建立 PoseLandmarker 例項。
Static PoseLandmarker
createFromFile(背景資訊、String modelPath)
從模型檔案和預設的 PoseLandmarker.PoseLandmarkerOptions 建立 PoseLandmarker 例項。
Static PoseLandmarker
createFromFile(背景資訊、檔案 modelFile)
從模型檔案和預設的 PoseLandmarker.PoseLandmarkerOptions 建立 PoseLandmarker 例項。
Static PoseLandmarker
PoseLandmarkerResult
detect(MPImage 圖片)
透過預設圖片處理選項 (即
PoseLandmarkerResult
detect(MPImage 圖片、ImageProcessingOptions imageProcessingOptions)
對提供的單一圖片執行姿勢地標偵測。
void
detectAsync(MPImage 圖片、ImageProcessingOptions imageProcessingOptions、long timestampM)
傳送即時圖片資料來執行姿勢地標偵測,並透過 PoseLandmarker.PoseLandmarkerOptions 提供的 OutputHandler.ResultListener 取得結果。
void
detectAsync(MPImage 圖片、長時間戳記 M)
傳送即時圖片資料,透過預設的圖片處理選項 (即
PoseLandmarkerResult
detectForVideo(MPImage 圖片、ImageProcessingOptions imageProcessingOptions、long timestampM)
對提供的視訊畫面執行姿勢地標偵測功能。
PoseLandmarkerResult
detectForVideo(MPImage 圖片、長時間戳記 M)
透過預設影像處理選項 (即

繼承的方法

欄位

public static final 設定<Connection> POSE_LANDMARKS

公用方法

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

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

參數
context Android ERROR(/Context)
modelBuffer 直接 ByteBufferERROR(/MappedByteBuffer) 偵測模型。
擲回
如果 PoseLandmarker 建立期間發生錯誤。

公開 靜態 PoseLandmarker createFromFile (內容結構定義、String modelPath)

從模型檔案和預設的 PoseLandmarker.PoseLandmarkerOptions 建立 PoseLandmarker 例項。

參數
context Android ERROR(/Context)
modelPath 位置地標模型路徑,該標籤含有資產的中繼資料。
擲回
如果 PoseLandmarker 建立期間發生錯誤。

公開 靜態 PoseLandmarker createFromFile (內容結構定義、檔案 modelFile)

從模型檔案和預設的 PoseLandmarker.PoseLandmarkerOptions 建立 PoseLandmarker 例項。

參數
context Android ERROR(/Context)
modelFile 位置地標模型 File 例項。
擲回
IOException 在開啟 tflite 模型檔案時發生 I/O 錯誤時。
如果 PoseLandmarker 建立期間發生錯誤。

public static PoseLandmarker createFromOptions (內容結構定義、PoseLandmarker.PoseLandmarkerOptionsmarkerOptions)

參數
context Android ERROR(/Context)
landmarkerOptions PoseLandmarker.PoseLandmarkerOptions 執行個體。
擲回
如果 PoseLandmarker 建立期間發生錯誤。

public PoseLandmarkerResult detect (MPImage 圖片)

使用預設圖片處理選項 (即不套用任何旋轉),對提供的單一圖片執行姿勢地標偵測。只有在使用 ERROR(/RunningMode.IMAGE) 建立 PoseLandmarker 時,才能使用這個方法。TODO 為輸入圖片格式更新 Java 文件。

PoseLandmarker 支援下列色彩空間類型:

參數
圖片 要處理的 MediaPipe MPImage 物件。
擲回

public PoseLandmarkerResult detect (MPImage 圖片、ImageProcessingOptions imageProcessingOptions)

對提供的單一圖片執行姿勢地標偵測。只有在使用 ERROR(/RunningMode.IMAGE) 建立 PoseLandmarker 時,才能使用這個方法。TODO 為輸入圖片格式更新 Java 文件。

PoseLandmarker 支援下列色彩空間類型:

參數
圖片 要處理的 MediaPipe MPImage 物件。
imageProcessingOptions 用於指定在執行推論之前如何處理輸入圖片的 ImageProcessingOptions。請注意,這項工作「不」支援搜尋區域:指定 ImageProcessingOptions.regionOfInterest() 會導致這個方法擲回 IllegalArgumentException。
擲回
IllegalArgumentException 表示 ImageProcessingOptions 指定搜尋區域。

public void detectAsync (MPImage image、ImageProcessingOptions imageProcessingOptions、long timestampMs)

傳送即時圖片資料來執行姿勢地標偵測,並透過 PoseLandmarker.PoseLandmarkerOptions 提供的 OutputHandler.ResultListener 取得結果。只有在使用 ERROR(/RunningMode.LIVE_STREAM) 建立 PoseLandmarker 時,才能使用這個方法。

必須提供時間戳記 (以毫秒為單位),指出輸入圖片傳送至手勢地標的時間。輸入時間戳記必須單純遞增。

PoseLandmarker 支援下列色彩空間類型:

參數
圖片 要處理的 MediaPipe MPImage 物件。
imageProcessingOptions 用於指定在執行推論之前如何處理輸入圖片的 ImageProcessingOptions。請注意,這項工作「不」支援搜尋區域:指定 ImageProcessingOptions.regionOfInterest() 會導致這個方法擲回 IllegalArgumentException。
timestampMs 輸入時間戳記 (以毫秒為單位)。
擲回
IllegalArgumentException 表示 ImageProcessingOptions 指定搜尋區域。

public void detectAsync (MPImage 圖片、長 timestampM)

傳送即時圖片資料,透過預設圖片處理選項 (即未套用任何旋轉) 偵測姿勢地標,並透過 PoseLandmarker.PoseLandmarkerOptions 提供的 OutputHandler.ResultListener 取得結果。只有在使用 ERROR(/RunningMode.LIVE_STREAM) 建立 PoseLandmarker 時,才能使用這個方法。

必須提供時間戳記 (以毫秒為單位),指出輸入圖片傳送至手勢地標的時間。輸入時間戳記必須單純遞增。

PoseLandmarker 支援下列色彩空間類型:

參數
圖片 要處理的 MediaPipe MPImage 物件。
timestampMs 輸入時間戳記 (以毫秒為單位)。
擲回

public PoseLandmarkerResult detectForVideo (MPImage image、ImageProcessingOptions imageProcessingOptions, long timestampMs)

對提供的視訊畫面執行姿勢地標偵測功能。只有在使用 ERROR(/RunningMode.VIDEO) 建立 PoseLandmarker 時,才能使用這個方法。

您必須提供影片影格的時間戳記 (以毫秒為單位)。輸入時間戳記必須單純遞增。

PoseLandmarker 支援下列色彩空間類型:

參數
圖片 要處理的 MediaPipe MPImage 物件。
imageProcessingOptions 用於指定在執行推論之前如何處理輸入圖片的 ImageProcessingOptions。請注意,這項工作「不」支援搜尋區域:指定 ImageProcessingOptions.regionOfInterest() 會導致這個方法擲回 IllegalArgumentException。
timestampMs 輸入時間戳記 (以毫秒為單位)。
擲回
IllegalArgumentException 表示 ImageProcessingOptions 指定搜尋區域。

public PoseLandmarkerResult detectForVideo (MPImage 圖片、長 timestampM)

透過預設影像處理選項 (即不套用任何旋轉),對提供的影片影格執行姿勢地標偵測。只有在使用 ERROR(/RunningMode.VIDEO) 建立 PoseLandmarker 時,才能使用這個方法。

您必須提供影片影格的時間戳記 (以毫秒為單位)。輸入時間戳記必須單純遞增。

PoseLandmarker 支援下列色彩空間類型:

參數
圖片 要處理的 MediaPipe MPImage 物件。
timestampMs 輸入時間戳記 (以毫秒為單位)。
擲回