GestureRecognizer

classe finale pubblica GestureRecognizer

Consente di eseguire il riconoscimento dei gesti sulle immagini.

Questa API richiede un bundle di asset preaddestrato del modello dei gesti della mano o uno personalizzato creato utilizzando Model Maker. Vedere la sezione .

  • Immagine di input MPImage
    • L'immagine su cui viene eseguito il riconoscimento dei gesti.
  • Risultati del riconoscimento gestuale di output GestureRecognizerResult
    • Un Recognition ResultrResult contenente punti di riferimento delle mani e gesti delle mani riconosciuti.

Corsi nidificati

classe GestureRecognizer.GestureRecognizerOptions Opzioni per configurare un GestureRecognizer. 

Metodi pubblici

statico GestureRecognizer
createFromBuffer(Context context, ByteBuffer modelBuffer)
Crea un'istanza GestureRecognizer da un buffer del modello e il valore predefinito GestureRecognizer.GestureRecognizerOptions.
statico GestureRecognizer
createFromFile(Contesto del contesto, Stringa modelPath)
Crea un'istanza GestureRecognizer da un file del modello e dal valore predefinito GestureRecognizer.GestureRecognizerOptions.
statico GestureRecognizer
createFromFile(Contesto del contesto, File modelFile)
Crea un'istanza GestureRecognizer da un file del modello e dal valore predefinito GestureRecognizer.GestureRecognizerOptions.
statico GestureRecognizer
createFromOptions(Contesto del contesto, GestureRecognizer.GestureRecognizerOptions riconosciutirOptions)
Crea un'istanza GestureRecognizer da un GestureRecognizer.GestureRecognizerOptions.
GestureRecognizerResult
recognize(immagine MPImage)
Esegue il riconoscimento dei gesti sulla singola immagine fornita con le opzioni di elaborazione delle immagini predefinite, ad esempio
GestureRecognizerResult
recognize(MPImage image, ImageProcessingOptions imageElaborazioneOptions)
Consente di eseguire il riconoscimento dei gesti sull'immagine singola fornita.
void
recognizeAsync(immagine MPImage, timestampM lunghi)
Invia i dati delle immagini in tempo reale per eseguire il riconoscimento dei gesti con le opzioni di elaborazione delle immagini predefinite, ad esempio
void
recognizeAsync(MPImage immagine, ImageProcessingOptions image elaborazioneOptions, timestamp lunghiMs)
Invia i dati delle immagini in tempo reale per eseguire il riconoscimento dei gesti e i risultati saranno disponibili tramite l'OutputHandler.ResultListener fornito in GestureRecognizer.GestureRecognizerOptions.
GestureRecognizerResult
recognizeForVideo(immagine MPImage, timestampM lunghi)
Consente di eseguire il riconoscimento dei gesti sul frame video fornito con le opzioni di elaborazione delle immagini predefinite, ad esempio
GestureRecognizerResult
recognizeForVideo(MPImage immagine, ImageProcessingOptions image elaborazioneOptions, timestamp lunghiMs)
Consente di eseguire il riconoscimento dei gesti sul fotogramma video fornito.

Metodi ereditati

Metodi pubblici

pubblico statico GestureRecognizer createFromBuffer (Context context, ByteBuffer modelBuffer)

Crea un'istanza GestureRecognizer da un buffer del modello e il valore predefinito GestureRecognizer.GestureRecognizerOptions.

Parametri
context un ERROR(/Context) Android.
modelBuffer un ByteBuffer diretto o un ERROR(/MappedByteBuffer) del modello di rilevamento.
Lanci
in caso di errore durante la creazione di GestureRecognizer.

pubblico static GestureRecognizer createFromFile (Contesto del contesto, Stringa modelPath)

Crea un'istanza GestureRecognizer da un file del modello e dal valore predefinito GestureRecognizer.GestureRecognizerOptions.

Parametri
context un ERROR(/Context) Android.
modelPath percorso del modello di riconoscimento dei gesti con metadati negli asset.
Lanci
in caso di errore durante la creazione di GestureRecognizer.

statico pubblico GestureRecognizer createFromFile (Contesto del contesto, File modelFile)

Crea un'istanza GestureRecognizer da un file del modello e dal valore predefinito GestureRecognizer.GestureRecognizerOptions.

Parametri
context un ERROR(/Context) Android.
modelFile l'istanza del modello di riconoscimento dei gesti File.
Lanci
IOException se si verifica un errore I/O all'apertura del file del modello tflite.
in caso di errore durante la creazione di GestureRecognizer.

pubblico static GestureRecognizer createFromOptions (contesto di contesto, GestureRecognizer.GestureRecognizerOptions riconosciutirOptions)

Crea un'istanza GestureRecognizer da un GestureRecognizer.GestureRecognizerOptions.

Parametri
context un ERROR(/Context) Android.
recognizerOptions un'istanza GestureRecognizer.GestureRecognizerOptions.
Lanci
in caso di errore durante la creazione di GestureRecognizer.

Public GestureRecognizerResult recognize (MPImage immagine)

Esegue il riconoscimento dei gesti sulla singola immagine fornita con le opzioni di elaborazione delle immagini predefinite, ovvero senza alcuna rotazione applicata. Utilizza questo metodo solo quando GestureRecognizer viene creato con ERROR(/RunningMode.IMAGE). DA FARE aggiornare il documento Java per il formato dell'immagine di input.

GestureRecognizer supporta i seguenti tipi di spazi colore:

Parametri
immagine un oggetto MPImage di MediaPipe per l'elaborazione.
Lanci
in caso di errore interno.

pubblici GestureRecognizerResult recognize (MPImage immagine, ImageProcessingOptions image elaborazioneOptions)

Consente di eseguire il riconoscimento dei gesti sull'immagine singola fornita. Utilizza questo metodo solo quando GestureRecognizer viene creato con ERROR(/RunningMode.IMAGE). DA FARE aggiornare il documento Java per il formato dell'immagine di input.

GestureRecognizer supporta i seguenti tipi di spazi colore:

Parametri
immagine un oggetto MPImage di MediaPipe per l'elaborazione.
imageProcessingOptions ImageProcessingOptions che specifica come elaborare l'immagine di input prima di eseguire l'inferenza. Tieni presente che la regione di interesse non è supportata da questa attività: se specifichi ImageProcessingOptions.regionOfInterest(), questo metodo genererà un'eccezione di IllegalArgumentException.
Lanci
IllegalArgumentException se ImageProcessingOptions specifica una regione di interesse.
in caso di errore interno.

Public void recognizeAsync (immagine MPImage, timestampM lunghi)

Invia i dati delle immagini in tempo reale per eseguire il riconoscimento dei gesti con le opzioni di elaborazione delle immagini predefinite, ovvero senza alcuna rotazione applicata, e i risultati saranno disponibili tramite l'OutputHandler.ResultListener fornito in GestureRecognizer.GestureRecognizerOptions. Utilizza questo metodo solo quando ERROR(/GestureRecognition) viene creato con ERROR(/RunningMode.LIVE_STREAM).

È necessario fornire un timestamp (in millisecondi) per indicare quando l'immagine di input viene inviata al riconoscimento dei gesti. I timestamp di input devono essere crescenti in modo monotonico.

GestureRecognizer supporta i seguenti tipi di spazi colore:

Parametri
immagine un oggetto MPImage di MediaPipe per l'elaborazione.
timestampMs il timestamp di input (in millisecondi).
Lanci
in caso di errore interno.

Public void recognizeAsync (immagine MPImage, ImageProcessingOptions image elaborazioneOptions, timestamp lungoMs)

Invia i dati delle immagini in tempo reale per eseguire il riconoscimento dei gesti e i risultati saranno disponibili tramite l'OutputHandler.ResultListener fornito in GestureRecognizer.GestureRecognizerOptions. Utilizza questo metodo solo quando ERROR(/GestureRecognition) viene creato con ERROR(/RunningMode.LIVE_STREAM).

È necessario fornire un timestamp (in millisecondi) per indicare quando l'immagine di input viene inviata al riconoscimento dei gesti. I timestamp di input devono essere crescenti in modo monotonico.

GestureRecognizer supporta i seguenti tipi di spazi colore:

Parametri
immagine un oggetto MPImage di MediaPipe per l'elaborazione.
imageProcessingOptions ImageProcessingOptions che specifica come elaborare l'immagine di input prima di eseguire l'inferenza. Tieni presente che la regione di interesse non è supportata da questa attività: se specifichi ImageProcessingOptions.regionOfInterest(), questo metodo genererà un'eccezione di IllegalArgumentException.
timestampMs il timestamp di input (in millisecondi).
Lanci
IllegalArgumentException se ImageProcessingOptions specifica una regione di interesse.
in caso di errore interno.

pubblici GestureRecognizerResult recognizeForVideo (immagine MPImage, timestamp lungoMs)

Consente di eseguire il riconoscimento dei gesti sul frame video fornito con le opzioni di elaborazione delle immagini predefinite, ovvero senza alcuna rotazione applicata. Utilizza questo metodo solo quando GestureRecognizer viene creato con ERROR(/RunningMode.VIDEO).

È necessario fornire il timestamp (in millisecondi) del frame video. I timestamp di input devono essere crescenti in modo monotonico.

GestureRecognizer supporta i seguenti tipi di spazi colore:

Parametri
immagine un oggetto MPImage di MediaPipe per l'elaborazione.
timestampMs il timestamp di input (in millisecondi).
Lanci
in caso di errore interno.

pubblici GestureRecognizerResult recognizeForVideo (MPImage immagine, ImageProcessingOptions imageProcessOptions, timestamp lunghiMs)

Consente di eseguire il riconoscimento dei gesti sul fotogramma video fornito. Utilizza questo metodo solo quando GestureRecognizer viene creato con ERROR(/RunningMode.VIDEO).

È necessario fornire il timestamp (in millisecondi) del frame video. I timestamp di input devono essere crescenti in modo monotonico.

GestureRecognizer supporta i seguenti tipi di spazi colore:

Parametri
immagine un oggetto MPImage di MediaPipe per l'elaborazione.
imageProcessingOptions ImageProcessingOptions che specifica come elaborare l'immagine di input prima di eseguire l'inferenza. Tieni presente che la regione di interesse non è supportata da questa attività: se specifichi ImageProcessingOptions.regionOfInterest(), questo metodo genererà un'eccezione di IllegalArgumentException.
timestampMs il timestamp di input (in millisecondi).
Lanci
IllegalArgumentException se ImageProcessingOptions specifica una regione di interesse.
in caso di errore interno.