MLKitFaceDetection フレームワーク リファレンス

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 になります。