FaceLandmarker

公開最終類別 FaceLandmarker

對圖片執行臉部地標偵測功能。

這個 API 需要使用預先訓練的臉孔地標模型資產包。請參閱

巢狀類別

類別 FaceLandmarker.FaceLandmarkerOptions 設定 FaceLandmarker 的選項。 

欄位

公開靜態最終 Set<Connection> FACE_LANDMARKS_CONNECTORS
公開靜態最終 Set<Connection> FACE_LANDMARKS_FACE_OVAL
公開靜態最終 Set<Connection> FACE_LANDMARKS_LEFT_EYE
公開靜態最終 Set<Connection> FACE_LANDMARKS_LEFT_EYE_BROW
公開靜態最終 Set<Connection> FACE_LANDMARKS_LEFT_IRIS
公開靜態最終 Set<Connection> FACE_LANDMARKS_LIPS
公開靜態最終 Set<Connection> FACE_LANDMARKS_RIGHT_EYE
公開靜態最終 Set<Connection> FACE_LANDMARKS_RIGHT_EYE_BROW
公開靜態最終 Set<Connection> FACE_LANDMARKS_RIGHT_IRIS
公開靜態最終 Set<Connection> FACE_LANDMARKS_TESSELATION

公用方法

靜態 FaceLandmarker
createFromBuffer(背景資訊、ByteBuffer modelAssetBuffer)
從模型資產套件緩衝區和預設的 FaceLandmarker.FaceLandmarkerOptions 建立 FaceLandmarker 執行個體。
靜態 FaceLandmarker
createFromFile(背景資訊、String modelAssetPath)
從模型資產套件路徑和預設的 FaceLandmarker.FaceLandmarkerOptions 建立 FaceLandmarker 執行個體。
靜態 FaceLandmarker
createFromFile(結構定義內容、檔案 modelAssetFile)
從模型資產套件檔案和預設的 FaceLandmarker.FaceLandmarkerOptions 建立 FaceLandmarker 執行個體。
靜態 FaceLandmarker
FaceLandmarkerResult
detect(MPImage 圖片)
透過預設圖片處理選項 (即
FaceLandmarkerResult
detect(MPImage 圖片、ImageProcessingOptions imageProcessingOptions)
對提供的單一圖片執行臉部地標偵測。
void
detectAsync(MPImage 圖片、ImageProcessingOptions imageProcessingOptions、long timestampM)
傳送即時圖片資料來執行臉部地標偵測,並透過 FaceLandmarker.FaceLandmarkerOptions 提供的 OutputHandler.ResultListener 取得結果。
void
detectAsync(MPImage 圖片、長時間戳記 M)
傳送即時影像資料,即可透過預設的圖片處理選項 (即
FaceLandmarkerResult
detectForVideo(MPImage 圖片、ImageProcessingOptions imageProcessingOptions、long timestampM)
對提供的視訊畫面執行臉部地標偵測功能。
FaceLandmarkerResult
detectForVideo(MPImage 圖片、長時間戳記 M)
透過預設影像處理選項 (即

繼承的方法

欄位

公開 靜態 最後 設定<連線> FACE_LANDMARKS_CONNECTORS

public static final 設定<Connection> FACE_LANDMARKS_FACE_OVAL

public static final 設定<連線> FACE_LANDMARKS_LEFT_EYE

public static final 設定<連線> FACE_LANDMARKS_LEFT_EYE_BROW

public static final 設定<Connection> FACE_LANDMARKS_LEFT_IRIS

公開 靜態最終 設定<Connection> FACE_LANDMARKS_LIPS

public static final 設定<Connection> FACE_LANDMARKS_RIGHT_EYE

public static final 設定<Connection> FACE_LANDMARKS_RIGHT_EYE_BROW

public static final 設定<Connection> FACE_LANDMARKS_RIGHT_IRIS

公開 靜態最終 設定<Connection> FACE_LANDMARKS_TESSELATION

公用方法

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

從模型資產套件緩衝區和預設的 FaceLandmarker.FaceLandmarkerOptions 建立 FaceLandmarker 執行個體。

參數
context Android ERROR(/Context)
modelAssetBuffer
擲回
如果 FaceLandmarker 建立期間發生錯誤。

公開 靜態 FaceLandmarker createFromFile (內容結構定義、String modelAssetPath)

從模型資產套件路徑和預設的 FaceLandmarker.FaceLandmarkerOptions 建立 FaceLandmarker 執行個體。

參數
context Android ERROR(/Context)
modelAssetPath 臉部界標模型路徑,且資產中的中繼資料。
擲回
如果 FaceLandmarker 建立期間發生錯誤。

公開 靜態 FaceLandmarker createFromFile (內容結構定義、File modelAssetFile)

從模型資產套件檔案和預設的 FaceLandmarker.FaceLandmarkerOptions 建立 FaceLandmarker 執行個體。

參數
context Android ERROR(/Context)
modelAssetFile 而臉部界標模型會模擬 File 例項。
擲回
IOException 在開啟 tflite 模型檔案時發生 I/O 錯誤時。
如果 FaceLandmarker 建立期間發生錯誤。

public Static FaceLandmarker createFromOptions (內容結構定義、FaceLandmarker.FaceLandmarkerOptions computeerOptions)

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

public FaceLandmarkerResult detect (MPImage 圖片)

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

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

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

public FaceLandmarkerResult detect (MPImage 圖片、ImageProcessingOptions imageProcessingOptions)

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

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

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

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

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

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

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

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

public void detectAsync (MPImage 圖片、長 timestampM)

傳送即時圖片資料,透過預設圖片處理選項 (即未套用任何旋轉) 執行臉部地標偵測。此外,您也可以透過 FaceLandmarker.FaceLandmarkerOptions 提供的 OutputHandler.ResultListener 取得結果。只有在使用 ERROR(/RunningMode.LIVE_STREAM) 建立 FaceLandmarker 時,才能使用這個方法。

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

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

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

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

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

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

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

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

public FaceLandmarkerResult detectForVideo (MPImage 圖片、長 timestampM)

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

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

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

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