MLKFaceDetector
@interface MLKFaceDetector : NSObject
画像内の顔を検出する顔検出器。
-
指定されたオプションで顔検出器を返します。
宣言
Objective-C
+ (nonnull instancetype)faceDetectorWithOptions: (nonnull MLKFaceDetectorOptions *)options;
パラメータ
options
顔検出器を構成するオプション。
戻り値
指定されたオプションで構成された顔検出器。
-
デフォルトのオプションで顔検出器を返します。
宣言
Objective-C
+ (nonnull instancetype)faceDetector;
戻り値
デフォルトのオプションで構成された顔検出器。
-
使用できません。クラスメソッドを使用します。
宣言
Objective-C
- (nonnull instancetype)init;
-
指定された画像を処理して顔検出を行います。
宣言
Objective-C
- (void)processImage:(nonnull id<MLKCompatibleImage>)image completion:(nonnull MLKFaceDetectionCallback)completion;
パラメータ
image
処理する画像。
completion
顔が検出された、またはエラーが発生したので、メインスレッドでコールバックするためのハンドラ。
-
指定された画像の顔の結果を返します。エラーが発生した場合は
nil
を返します。顔検出は、呼び出し側のスレッドで同期的に実行されます。UI をブロックしないよう、メインスレッド以外でこのメソッドを呼び出すことをおすすめします。そのため、このメソッドがメインスレッドで呼び出されると、
NSException
が発生します。宣言
Objective-C
- (nullable NSArray<MLKFace *> *) resultsInImage:(nonnull id<MLKCompatibleImage>)image error:(NSError *_Nullable *_Nullable)error;
パラメータ
image
結果を取得する画像。
error
結果の取得中にエラーが発生した場合に入力されるオプションのエラー パラメータ。
戻り値
顔の配列は指定された画像になります。エラーがある場合は
nil
になります。