GestureRecognizer

公開最終類別 GestureRecognizer

對圖片執行手勢辨識。

這個 API 預期有預先訓練的手勢模型素材資源組合，或是使用 Model Maker 建立的自訂手勢。請參閱。

  • 輸入圖片 MPImage
    • 執行手勢辨識的圖片。
  • 輸出 GestureRecognizerResult GestureRecognizerResult
    • GestureRecognizerResult 含有手勢地標和已辨識的手勢。

巢狀類別

類別 GestureRecognizer.GestureRecognizerOptions 設定 GestureRecognizer 的選項。 

公用方法

靜態 GestureRecognizer
createFromBuffer(背景資訊、ByteBuffer modelBuffer)
從模型緩衝區和預設的 GestureRecognizer.GestureRecognizerOptions 建立 GestureRecognizer 例項。
靜態 GestureRecognizer
createFromFile(背景資訊、String modelPath)
從模型檔案和預設的 GestureRecognizer.GestureRecognizerOptions 建立 GestureRecognizer 例項。
靜態 GestureRecognizer
createFromFile(背景資訊、檔案 modelFile)
從模型檔案和預設的 GestureRecognizer.GestureRecognizerOptions 建立 GestureRecognizer 例項。
靜態 GestureRecognizer
createFromOptions(情境結構定義、GestureRecognizer.GestureRecognizerOptions RecognitionrOptions)
從 GestureRecognizer.GestureRecognizerOptions 建立 GestureRecognizer 例項。
GestureRecognizerResult
recognize(MPImage 圖片)
使用預設圖片處理選項 (即
GestureRecognizerResult
recognize(MPImage 圖片、ImageProcessingOptions imageProcessingOptions)
對提供的單一圖片執行手勢辨識。
void
recognizeAsync(MPImage 圖片、長 timestampM)
傳送即時圖片資料，以便使用預設圖片處理選項執行手勢辨識，例如
void
recognizeAsync(MPImage 圖片、ImageProcessingOptions imageProcessingOptions、long timestampM)
傳送即時圖片資料來執行手勢辨識，並透過 GestureRecognizer.GestureRecognizerOptions 提供的 OutputHandler.ResultListener 取得結果。
GestureRecognizerResult
recognizeForVideo(MPImage 圖片、長 timestampM)
透過預設的圖片處理選項，對提供的影片畫面執行手勢辨識，例如
GestureRecognizerResult
recognizeForVideo(MPImage 圖片、ImageProcessingOptions imageProcessingOptions、long timestampM)
對提供的視訊畫面執行手勢辨識。

繼承的方法

公用方法

公開 靜態 GestureRecognizer createFromBuffer (結構定義結構定義、ByteBuffer modelBuffer)

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

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

公開 靜態 GestureRecognizer createFromFile (結構定義結構定義、String modelPath)

從模型檔案和預設的 GestureRecognizer.GestureRecognizerOptions 建立 GestureRecognizer 例項。

參數
context Android ERROR(/Context)。
modelPath 手勢辨識模型路徑，且該模型具有資產的中繼資料。
擲回
如果 GestureRecognizer 建立期間發生錯誤。

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

從模型檔案和預設的 GestureRecognizer.GestureRecognizerOptions 建立 GestureRecognizer 例項。

參數
context Android ERROR(/Context)。
modelFile 手勢辨識模型 File 例項
擲回
IOException 在開啟 tflite 模型檔案時發生 I/O 錯誤時。
如果 GestureRecognizer 建立期間發生錯誤。

公開 Static GestureRecognizer createFromOptions (內容結構定義、GestureRecognizer.GestureRecognizerOptionscognirOptions)

從 GestureRecognizer.GestureRecognizerOptions 建立 GestureRecognizer 例項。

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

public GestureRecognizerResult recognize (MPImage 圖片)

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

GestureRecognizer 支援下列色彩空間類型：

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

public GestureRecognizerResult recognize (MPImage 圖片、ImageProcessingOptions imageProcessingOptions)

對提供的單一圖片執行手勢辨識。只有在使用 ERROR(/RunningMode.IMAGE) 建立 GestureRecognizer 時，才能使用這個方法。TODO 為輸入圖片格式更新 Java 文件。

GestureRecognizer 支援下列色彩空間類型：

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

public void recognizeAsync (MPImage 圖片、長 timestampM)

傳送即時圖片資料，以便使用預設圖片處理選項執行手勢辨識 (也就是不套用任何旋轉)，並透過 GestureRecognizer.GestureRecognizerOptions 提供的 OutputHandler.ResultListener 取得結果。只有在使用 ERROR(/RunningMode.LIVE_STREAM) 建立 ERROR(/GestureRecognition) 時，才能使用這個方法。

您必須提供時間戳記 (以毫秒為單位)，指出輸入圖片傳送至手勢辨識工具的時間。輸入時間戳記必須單純遞增。

GestureRecognizer 支援下列色彩空間類型：

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

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

傳送即時圖片資料來執行手勢辨識，並透過 GestureRecognizer.GestureRecognizerOptions 提供的 OutputHandler.ResultListener 取得結果。只有在使用 ERROR(/RunningMode.LIVE_STREAM) 建立 ERROR(/GestureRecognition) 時，才能使用這個方法。

您必須提供時間戳記 (以毫秒為單位)，指出輸入圖片傳送至手勢辨識工具的時間。輸入時間戳記必須單純遞增。

GestureRecognizer 支援下列色彩空間類型：

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

public GestureRecognizerResult recognizeForVideo (MPImage 圖片、長時間戳記 M)

透過預設的圖片處理選項 (即不套用任何旋轉)，對提供的影片影格執行手勢辨識。只有在使用 ERROR(/RunningMode.VIDEO) 建立 GestureRecognizer 時，才能使用這個方法。

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

GestureRecognizer 支援下列色彩空間類型：

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

public GestureRecognizerResult recognizeForVideo (MPImage 圖片、ImageProcessingOptions imageProcessingOptions、long timestampMs)

對提供的視訊畫面執行手勢辨識。只有在使用 ERROR(/RunningMode.VIDEO) 建立 GestureRecognizer 時，才能使用這個方法。

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

GestureRecognizer 支援下列色彩空間類型：

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