對圖片執行臉部地標偵測功能。
這個 API 需要使用預先訓練的臉孔地標模型資產包。請參閱
- 輸入圖片
MPImage
- 套用地標偵測功能的圖片。
- 輸出
FaceLandmarkerResult
- 包含臉孔地標的 FaceLandmarkerResult。
巢狀類別
類別 | 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 |
createFromOptions(內容結構定義、FaceLandmarker.FaceLandmarkerOptions computeerOptions)
|
FaceLandmarkerResult | |
FaceLandmarkerResult | |
void |
detectAsync(MPImage 圖片、ImageProcessingOptions imageProcessingOptions、long timestampM)
傳送即時圖片資料來執行臉部地標偵測,並透過
FaceLandmarker.FaceLandmarkerOptions 提供的 OutputHandler.ResultListener 取得結果。 |
void | |
FaceLandmarkerResult |
detectForVideo(MPImage 圖片、ImageProcessingOptions imageProcessingOptions、long timestampM)
對提供的視訊畫面執行臉部地標偵測功能。
|
FaceLandmarkerResult |
繼承的方法
欄位
公用方法
公開 靜態 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 | 輸入時間戳記 (以毫秒為單位)。 |
擲回
。 |