FaceDetector

公開最終類別 FaceDetector

對圖片執行臉部偵測。

API 會使用 TFLite 模型中繼資料的 TFLite 模型。

  • 輸入圖片 MPImage
    • 執行臉部偵測器的圖片。
  • 輸出 FaceDetectorResult FaceDetectorResult
    • 含有偵測到的臉孔的 FaceDetectorResult。

巢狀類別

類別 FaceDetector.FaceDetectorOptions 設定 FaceDetector 的選項。 

公用方法

靜態 FaceDetector
createFromBuffer(背景資訊、ByteBuffer modelBuffer)
從模型緩衝區和預設的 FaceDetector.FaceDetectorOptions 建立 FaceDetector 例項。
靜態 FaceDetector
createFromFile(背景資訊、String modelPath)
從模型檔案和預設的 FaceDetector.FaceDetectorOptions 建立 FaceDetector 例項。
靜態 FaceDetector
createFromFile(背景資訊、檔案 modelFile)
從模型檔案和預設的 FaceDetector.FaceDetectorOptions 建立 FaceDetector 例項。
靜態 FaceDetector
createFromOptions(內容結構定義、FaceDetector.FaceDetectorOptions DetectionorOptions)
從 FaceDetector.FaceDetectorOptions 建立 FaceDetector 例項。
FaceDetectorResult
detect(MPImage 圖片)
透過預設的圖片處理選項，對提供的單一圖片執行臉部偵測，例如
FaceDetectorResult
detect(MPImage 圖片、ImageProcessingOptions imageProcessingOptions)
對提供的單一圖像執行臉部偵測。
void
detectAsync(MPImage 圖片、ImageProcessingOptions imageProcessingOptions、long timestampM)
傳送即時圖片資料來執行臉部偵測，並透過 FaceDetector.FaceDetectorOptions 提供的 OutputHandler.ResultListener 取得結果。
void
detectAsync(MPImage 圖片、長時間戳記 M)
傳送即時影像資料，以便透過預設的圖片處理選項 (即
FaceDetectorResult
detectForVideo(MPImage 圖片、ImageProcessingOptions imageProcessingOptions、long timestampM)
對提供的視訊畫面執行臉部偵測。
FaceDetectorResult
detectForVideo(MPImage 圖片、長時間戳記 M)
以預設的影像處理選項 (即

繼承的方法

公用方法

公開 靜態 FaceDetector createFromBuffer (內容結構定義、ByteBuffer modelBuffer)

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

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

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

從模型檔案和預設的 FaceDetector.FaceDetectorOptions 建立 FaceDetector 例項。

參數
context Android ERROR(/Context)。
modelPath 含有中繼資料的偵測模型路徑。
擲回
如果 FaceDetector 建立期間發生錯誤。

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

從模型檔案和預設的 FaceDetector.FaceDetectorOptions 建立 FaceDetector 例項。

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

公開 靜態 FaceDetector createFromOptions (內容結構定義、FaceDetector.FaceDetectorOptions DetectionorOptions)

從 FaceDetector.FaceDetectorOptions 建立 FaceDetector 例項。

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

public FaceDetectorResult detect (MPImage 圖片)

使用預設影像處理選項 (即不套用任何旋轉)，對提供的單一圖片執行臉部偵測。只有在使用 ERROR(/RunningMode.IMAGE) 建立 FaceDetector 時，才能使用這個方法。

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

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

public FaceDetectorResult detect (MPImage 圖片、ImageProcessingOptions imageProcessingOptions)

對提供的單一圖像執行臉部偵測。只有在使用 ERROR(/RunningMode.IMAGE) 建立 FaceDetector 時，才能使用這個方法。

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

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

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

傳送即時圖片資料來執行臉部偵測，並透過 FaceDetector.FaceDetectorOptions 提供的 OutputHandler.ResultListener 取得結果。只有在使用 ERROR(/RunningMode.LIVE_STREAM) 建立 FaceDetector 時，才能使用這個方法。

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

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

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

public void detectAsync (MPImage 圖片、長 timestampM)

傳送即時圖像資料，透過預設圖片處理選項執行臉部偵測 (也就是不套用任何旋轉角度)，並透過 FaceDetector.FaceDetectorOptions 提供的 OutputHandler.ResultListener 取得結果。只有在使用 ERROR(/RunningMode.LIVE_STREAM) 建立 FaceDetector 時，才能使用這個方法。

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

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

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

public FaceDetectorResult detectForVideo (MPImage 圖片、ImageProcessingOptions imageProcessingOptions, long timestampMs)

對提供的視訊畫面執行臉部偵測。只有在使用 ERROR(/RunningMode.VIDEO) 建立 FaceDetector 時，才能使用這個方法。

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

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

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

public FaceDetectorResult detectForVideo (MPImage 圖片、長 timestampM)

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

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

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

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