GestureRecognizer

public final class GestureRecognizer

画像に対してジェスチャー認識を実行します。

この API には、事前トレーニング済みの手の動きのモデルのアセット バンドル、または Model Maker を使用して作成されたカスタムのバンドルが必要です。をご覧ください。

  • 入力画像 MPImage
    • ジェスチャー認識が実行される画像。
  • 出力 GestureRecognizerResult GestureRecognizerResult
    • 手のランドマークと認識された手のジェスチャーを含む GestureRecognizerResult。

ネストされたクラス

クラス GestureRecognizer.GestureRecognizerOptions GestureRecognizer の設定オプション。 

パブリック メソッド

static GestureRecognizer
createFromBuffer（コンテキスト コンテキスト、ByteBuffer modelBuffer）
モデルバッファとデフォルトの GestureRecognizer.GestureRecognizerOptions から GestureRecognizer インスタンスを作成します。
static GestureRecognizer
createFromFile（コンテキスト コンテキスト、String modelPath）
モデルファイルとデフォルトの GestureRecognizer.GestureRecognizerOptions から GestureRecognizer インスタンスを作成します。
static GestureRecognizer
createFromFile（コンテキスト コンテキスト、File modelFile）
モデルファイルとデフォルトの GestureRecognizer.GestureRecognizerOptions から GestureRecognizer インスタンスを作成します。
static GestureRecognizer
createFromOptions（コンテキスト コンテキスト、GestureRecognizer.GestureRecognizerOptions RecognizerOptions）
GestureRecognizer.GestureRecognizerOptions から GestureRecognizer インスタンスを作成します。
GestureRecognizerResult
recognize（MPImage イメージ）
指定された単一の画像に対して、デフォルトの画像処理オプション（
GestureRecognizerResult
recognize(MPImage image, ImageProcessingOptions imageProcessingOptions)
指定された単一の画像に対してジェスチャー認識を実行します。
void
recognizeAsync(MPImage image, long timestampMs)
ライブ画像データを送信して、デフォルトの画像処理オプションでジェスチャー認識を行います。
void
recognizeAsync(MPImage image, ImageProcessingOptions imageProcessingOptions, long timestampMs)
ライブ画像データを送信してジェスチャー認識を行います。結果は GestureRecognizer.GestureRecognizerOptions で提供される OutputHandler.ResultListener で取得できます。
GestureRecognizerResult
recognizeForVideo（MPImage イメージ、long timestampMs）
指定された動画フレームに対して、デフォルトの画像処理オプション（
GestureRecognizerResult
recognizeForVideo（MPImage image、ImageProcessingOptions imageProcessingOptions、long timestampMs）
指定された動画フレームに対してジェスチャー認識を実行します。

継承されるメソッド

パブリック メソッド

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

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

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

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

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

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

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

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

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

public static GestureRecognizer createFromOptions （コンテキスト コンテキスト、GestureRecognizer.GestureRecognizerOptions RecognizerOptions）

GestureRecognizer.GestureRecognizerOptions から GestureRecognizer インスタンスを作成します。

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

public GestureRecognizerResult recognize （MPImage 画像）

指定された 1 つの画像に対して、デフォルトの画像処理オプションを使用して（つまり、回転を適用せずに）ジェスチャー認識を実行します。このメソッドは、GestureRecognizer が ERROR(/RunningMode.IMAGE) で作成された場合にのみ使用します。入力画像形式の Java ドキュメントを更新する。

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

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

public GestureRecognizerResult recognize (MPImage image, ImageProcessingOptions imageProcessingOptions)

指定された単一の画像に対してジェスチャー認識を実行します。このメソッドは、GestureRecognizer が ERROR(/RunningMode.IMAGE) で作成された場合にのみ使用します。入力画像形式の Java ドキュメントを更新する。

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

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

public void recognizeAsync (MPImage image, long timestampMs)

ライブ画像データを送信して、デフォルトの画像処理オプション（回転を適用しない）でジェスチャー認識を実行します。結果は GestureRecognizer.GestureRecognizerOptions で提供される OutputHandler.ResultListener を介して取得できます。このメソッドは、ERROR(/GestureRecognition) が ERROR(/RunningMode.LIVE_STREAM) で作成された場合にのみ使用します。

入力画像がジェスチャー認識ツールにいつ送信されたかを示すタイムスタンプ（ミリ秒単位）を指定する必要があります。入力タイムスタンプは単調に増加している必要があります。

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

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

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

ライブ画像データを送信してジェスチャー認識を行います。結果は GestureRecognizer.GestureRecognizerOptions で提供される OutputHandler.ResultListener で取得できます。このメソッドは、ERROR(/GestureRecognition) が ERROR(/RunningMode.LIVE_STREAM) で作成された場合にのみ使用します。

入力画像がジェスチャー認識ツールにいつ送信されたかを示すタイムスタンプ（ミリ秒単位）を指定する必要があります。入力タイムスタンプは単調に増加している必要があります。

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

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

public GestureRecognizerResult recognizeForVideo (MPImage image, long timestampMs)

指定された動画フレームに対して、デフォルトの画像処理オプションを使用して（回転を適用せずに）ジェスチャー認識を実行します。このメソッドは、GestureRecognizer が ERROR(/RunningMode.VIDEO) で作成された場合にのみ使用します。

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

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

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

public GestureRecognizerResult recognizeForVideo （MPImage image、ImageProcessingOptions imageProcessingOptions、long timestampMs）

指定された動画フレームに対してジェスチャー認識を実行します。このメソッドは、GestureRecognizer が ERROR(/RunningMode.VIDEO) で作成された場合にのみ使用します。

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

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

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