FaceDetector

public final class FaceDetector

画像に対して顔検出を行います。

API は、TFLite モデル メタデータを含む TFLite モデルを想定しています。

  • 入力画像 MPImage
    • 顔検出機能が実行される画像。
  • 出力 FaceDetectorResult FaceDetectorResult
    • 検出された顔を含む FaceDetectorResult。

ネストされたクラス

クラス FaceDetector.FaceDetectorOptions FaceDetector の設定オプション。 

パブリック メソッド

静的 FaceDetector
createFromBuffer（コンテキスト コンテキスト、ByteBuffer modelBuffer）
モデルバッファとデフォルトの FaceDetector.FaceDetectorOptions から FaceDetector インスタンスを作成します。
静的 FaceDetector
createFromFile（コンテキスト コンテキスト、String modelPath）
モデルファイルとデフォルトの FaceDetector.FaceDetectorOptions から FaceDetector インスタンスを作成します。
静的 FaceDetector
createFromFile（コンテキスト コンテキスト、File modelFile）
モデルファイルとデフォルトの FaceDetector.FaceDetectorOptions から FaceDetector インスタンスを作成します。
静的 FaceDetector
createFromOptions（コンテキスト コンテキスト、FaceDetector.FaceDetectorOptions detectionOptions）
FaceDetector.FaceDetectorOptions から FaceDetector インスタンスを作成します。
FaceDetectorResult
detect（MPImage 画像）
指定された 1 つの画像に対して、デフォルトの画像処理オプションを使用して顔検出を行います。例:
FaceDetectorResult
detect（MPImage image、ImageProcessingOptions imageProcessingOptions）
指定された 1 つの画像に対して顔検出を行います。
void
detectAsync（MPImage image、ImageProcessingOptions imageProcessingOptions、long timestampMs）
ライブ画像データを送信して顔検出を行います。結果は FaceDetector.FaceDetectorOptions で提供される OutputHandler.ResultListener で取得できます。
void
detectAsync（MPImage image, long timestampMs）
ライブ画像データを送信して、デフォルトの画像処理オプションで顔検出を行います。
FaceDetectorResult
detectForVideo（MPImage image、ImageProcessingOptions imageProcessingOptions、long timestampMs）
指定された動画フレームに対して顔検出を行います。
FaceDetectorResult
detectForVideo（MPImage 画像、long timestampMs）
指定された動画フレームに対して、デフォルトの画像処理オプション（

継承されるメソッド

パブリック メソッド

public static FaceDetector createFromBuffer （コンテキスト コンテキスト、ByteBuffer modelBuffer）

モデルバッファとデフォルトの FaceDetector.FaceDetectorOptions から FaceDetector インスタンスを作成します。

パラメータ
コンテキスト Android ERROR(/Context)。
modelBuffer 検出モデルの直接の ByteBuffer または ERROR(/MappedByteBuffer)。
例外
FaceDetector の作成中にエラーが発生した場合。

public static FaceDetector createFromFile （コンテキスト コンテキスト、String modelPath）

モデルファイルとデフォルトの FaceDetector.FaceDetectorOptions から FaceDetector インスタンスを作成します。

パラメータ
コンテキスト Android ERROR(/Context)。
modelPath アセット内のメタデータを含む検出モデルへのパス。
例外
FaceDetector の作成中にエラーが発生した場合。

public static FaceDetector createFromFile （コンテキスト コンテキスト、File modelFile）

モデルファイルとデフォルトの FaceDetector.FaceDetectorOptions から FaceDetector インスタンスを作成します。

パラメータ
コンテキスト Android ERROR(/Context)。
modelFile 検出モデルの File インスタンス。
例外
IOException tflite モデルファイルを開くときに I/O エラーが発生した場合
FaceDetector の作成中にエラーが発生した場合。

public static FaceDetector createFromOptions （コンテキスト コンテキスト、FaceDetector.FaceDetectorOptionsdetectionOptions）

FaceDetector.FaceDetectorOptions から FaceDetector インスタンスを作成します。

パラメータ
コンテキスト Android ERROR(/Context)。
detectorOptions FaceDetector.FaceDetectorOptions インスタンス。
例外
FaceDetector の作成中にエラーが発生した場合。

public FaceDetectorResult detect （MPImage 画像）

指定された 1 つの画像に対して、デフォルトの画像処理オプションを使用して（つまり、回転を適用せずに）顔検出を行います。このメソッドは、FaceDetector が ERROR(/RunningMode.IMAGE) で作成された場合にのみ使用します。

FaceDetector は、次の色空間タイプをサポートしています。

パラメータ
イメージ 処理する MediaPipe MPImage オブジェクト。
例外
内部エラーが発生した場合。

public FaceDetectorResult detect (MPImage image, ImageProcessingOptions imageProcessingOptions)

指定された 1 つの画像に対して顔検出を行います。このメソッドは、FaceDetector が ERROR(/RunningMode.IMAGE) で作成された場合にのみ使用します。

FaceDetector は、次の色空間タイプをサポートしています。

パラメータ
イメージ 処理する MediaPipe MPImage オブジェクト。
imageProcessingOptions 推論を実行する前に入力画像を処理する方法を指定する ImageProcessingOptions。このタスクでは、関心領域はサポートされていません。ImageProcessingOptions.regionOfInterest() を指定すると、このメソッドは IllegalArgumentException をスローします。
例外
IllegalArgumentException ImageProcessingOptions が関心のある地域を指定している場合。
内部エラーが発生した場合。

public void detectAsync (MPImage image, ImageProcessingOptions imageProcessingOptions, long timestampMs)

ライブ画像データを送信して顔検出を行います。結果は FaceDetector.FaceDetectorOptions で提供される OutputHandler.ResultListener で取得できます。このメソッドは、FaceDetector が ERROR(/RunningMode.LIVE_STREAM) で作成された場合にのみ使用します。

入力画像が顔検出器にいつ送信されたかを示すタイムスタンプ（ミリ秒単位）を指定する必要があります。入力タイムスタンプは単調に増加している必要があります。

FaceDetector は、次の色空間タイプをサポートしています。

パラメータ
イメージ 処理する MediaPipe MPImage オブジェクト。
imageProcessingOptions 推論を実行する前に入力画像を処理する方法を指定する ImageProcessingOptions。このタスクでは、関心領域はサポートされていません。ImageProcessingOptions.regionOfInterest() を指定すると、このメソッドは IllegalArgumentException をスローします。
timestampMs 入力タイムスタンプ（ミリ秒単位）。
例外
IllegalArgumentException ImageProcessingOptions が関心のある地域を指定している場合。
内部エラーが発生した場合。

public void detectAsync (MPImage image, long timestampMs)

ライブ画像データを送信して、デフォルトの画像処理オプション（回転は適用されません）で顔検出を行います。結果は、FaceDetector.FaceDetectorOptions で提供される OutputHandler.ResultListener を介して取得できます。このメソッドは、FaceDetector が ERROR(/RunningMode.LIVE_STREAM) で作成された場合にのみ使用します。

入力画像が顔検出器にいつ送信されたかを示すタイムスタンプ（ミリ秒単位）を指定する必要があります。入力タイムスタンプは単調に増加している必要があります。

FaceDetector は、次の色空間タイプをサポートしています。

パラメータ
イメージ 処理する MediaPipe MPImage オブジェクト。
timestampMs 入力タイムスタンプ（ミリ秒単位）。
例外
内部エラーが発生した場合。

public FaceDetectorResult detectForVideo (MPImage image, ImageProcessingOptions imageProcessingOptions, long timestampMs)

指定された動画フレームに対して顔検出を行います。このメソッドは、FaceDetector が ERROR(/RunningMode.VIDEO) で作成された場合にのみ使用します。

動画フレームのタイムスタンプ（ミリ秒単位）を提供する必要があります。入力タイムスタンプは単調に増加している必要があります。

FaceDetector は、次の色空間タイプをサポートしています。

パラメータ
イメージ 処理する MediaPipe MPImage オブジェクト。
imageProcessingOptions 推論を実行する前に入力画像を処理する方法を指定する ImageProcessingOptions。このタスクでは、関心領域はサポートされていません。ImageProcessingOptions.regionOfInterest() を指定すると、このメソッドは IllegalArgumentException をスローします。
timestampMs 入力タイムスタンプ（ミリ秒単位）。
例外
IllegalArgumentException ImageProcessingOptions が関心のある地域を指定している場合。
内部エラーが発生した場合。

public FaceDetectorResult detectForVideo (MPImage image, long timestampMs)

指定された動画フレームに対して、デフォルトの画像処理オプション（回転は適用されません）を使用して顔検出を行います。このメソッドは、FaceDetector が ERROR(/RunningMode.VIDEO) で作成された場合にのみ使用します。

動画フレームのタイムスタンプ（ミリ秒単位）を提供する必要があります。入力タイムスタンプは単調に増加している必要があります。

FaceDetector は、次の色空間タイプをサポートしています。

パラメータ
イメージ 処理する MediaPipe MPImage オブジェクト。
timestampMs 入力タイムスタンプ（ミリ秒単位）。
例外
内部エラーが発生した場合。