MLKitFaceDetection 架構參考資料

FaceDetector

class FaceDetector : NSObject

偵測相片中的臉孔的臉部偵測工具。

• faceDetector(options:)

  傳回含有指定選項的臉部偵測工具。

  聲明

  Swift

  class func faceDetector(options: MLKFaceDetectorOptions) -> Self

  參數

  options

  設定臉部偵測工具的選項。

  傳回值

  設有指定選項的臉部偵測工具。

• faceDetector()

  傳回含預設選項的臉部偵測工具。

  聲明

  Swift

  class func faceDetector() -> Self

  傳回值

  已設定預設選項的臉部偵測工具。

• -init

  無法使用，使用類別方法。

• process(_:completion:)

  處理指定圖片進行臉部偵測。

  聲明

  Swift

  func process(_ image: MLKitCompatibleImage, completion: @escaping FaceDetectionCallback)

  參數

  image	要處理的圖片。
  completion	系統在主執行緒上偵測到臉孔或發生錯誤的回呼。

• results(in:)

  傳回指定圖片中的臉孔結果，如果發生錯誤，則傳回 nil。臉部偵測會在呼叫執行緒中同步執行。

  建議您從主執行緒呼叫此方法，以免封鎖 UI。因此，如果在主執行緒上呼叫此方法，就會引發 NSException。

  聲明

  Swift

  func results(in image: MLKitCompatibleImage) throws -> [MLKFace]

  參數

  image	要用於取得結果的圖片。
  error	取得結果時發生錯誤時填入的選用錯誤參數。

  傳回值

  指定圖片的臉部陣列會產生指定圖片，如果發生錯誤，則會產生 nil。