MLKitFaceDetection 架構參考資料

MLKFaceDetector

@interface MLKFaceDetector : NSObject

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

• +faceDetectorWithOptions:

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

  聲明

  Objective-C

  + (nonnull instancetype)faceDetectorWithOptions:
      (nonnull MLKFaceDetectorOptions *)options;

  參數

  options

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

  傳回值

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

• +faceDetector

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

  聲明

  Objective-C

  + (nonnull instancetype)faceDetector;

  傳回值

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

• -init

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

  聲明

  Objective-C

  - (nonnull instancetype)init;

• -processImage:completion:

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

  聲明

  Objective-C

  - (void)processImage:(nonnull id<MLKCompatibleImage>)image
            completion:(nonnull MLKFaceDetectionCallback)completion;

  參數

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

• -resultsInImage:error:

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

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

  聲明

  Objective-C

  - (nullable NSArray<MLKFace *> *)
      resultsInImage:(nonnull id<MLKCompatibleImage>)image
               error:(NSError *_Nullable *_Nullable)error;

  參數

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

  傳回值

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