Google AI Edge Portal: Edge-KI im großen Maßstab benchmarken. Melden Sie sich an, um während der privaten Vorschau Zugriff anzufordern.

Diese Seite wurde von der Cloud Translation API übersetzt.

HandLandmarker

public final class HandLandmarker

Führt eine Erkennung von Handmarkierungen auf Bildern durch.

Diese API erwartet ein vortrainiertes Asset-Bundle für das Modell der Orientierungspunkte. Weitere Informationen finden Sie unter .

Eingabebild MPImage
- Das Bild, auf dem die Erkennung von Handmarkierungen ausgeführt wird.
Ausgabe „HandLandmarkerResult HandLandmarkerResult“
- Ein HandLandmarkerResult mit Handmarkierungen.

Verschachtelte Klassen

Klasse HandLandmarker.HandLandmarkerOptions Optionen zum Einrichten eines HandLandmarker-Objekts.

Felder

public static final Set<Connection>	HAND_CONNECTIONS
public static final Set<Connection>	HAND_INDEX_FINGER_CONNECTIONS
public static final Set<Connection>	HAND_MIDDLE_FINGER_CONNECTIONS
public static final Set<Connection>	HAND_PALM_CONNECTIONS
public static final Set<Connection>	HAND_PINKY_FINGER_CONNECTIONS
public static final Set<Connection>	HAND_RING_FINGER_CONNECTIONS
public static final Set<Connection>	HAND_THUMB_CONNECTIONS

Public Methods

static HandLandmarker	createFromBuffer(Kontextkontext, ByteBuffer modelBuffer) Erstellt eine `HandLandmarker`-Instanz aus einem Modellpuffer und dem Standardwert `HandLandmarker.HandLandmarkerOptions`.
static HandLandmarker	createFromFile(Kontextkontext, String ModelPath) Erstellt eine `HandLandmarker`-Instanz aus einer Modelldatei und der Standard-`HandLandmarker.HandLandmarkerOptions`.
static HandLandmarker	createFromFile(Kontextkontext, File-Modelldatei) Erstellt eine `HandLandmarker`-Instanz aus einer Modelldatei und der Standard-`HandLandmarker.HandLandmarkerOptions`.
static HandLandmarker	createFromOptions(Context context, HandLandmarker.HandLandmarkerOptions visibilityerOptions) Erstellt eine `HandLandmarker`-Instanz aus einer `HandLandmarker.HandLandmarkerOptions`.
HandLandmarkerResult	detect(MPImage-Bild) Es führt eine Erkennung von Handmarkierungen auf dem bereitgestellten Einzelbild mit Standard-Bildverarbeitungsoptionen durch, z.B.
HandLandmarkerResult	detect(MPImage-Bild, ImageProcessingOptions imageProcessingOptions) Führt eine Erkennung von Hand-Markierungen auf dem bereitgestellten Einzelbild durch.
void	detectAsync(MPImage-Bild, ImageProcessingOptions imageProcessingOptions, longtimestampMs) Sendet Live-Bilddaten, um Handmarkierungen zu erkennen. Die Ergebnisse werden über die `OutputHandler.ResultListener` in der `HandLandmarker.HandLandmarkerOptions` zur Verfügung gestellt.
void	detectAsync(MPImage-Image, langer ZeitstempelMs) Sendet Live-Bilddaten, um mit Standard-Bildverarbeitungsoptionen wie Handmarkierungen zu erkennen
HandLandmarkerResult	detectForVideo(MPImage-Bild, ImageProcessingOptions imageProcessingOptions, long timestampMs) Führt eine Erkennung von Handmarkierungen im bereitgestellten Videoframe durch.
HandLandmarkerResult	detectForVideo(MPImage-Bild, langer ZeitstempelMs) Führt eine Erkennung von Hand-Markierungen auf dem bereitgestellten Videoframe mit Standard-Bildverarbeitungsoptionen durch, z.B.

Übernommene Methoden

Aus Klasse com.google.mediapipe.tasks.vision.core.BaseVisionTaskApi

void	close() Schließt und bereinigt die MediaPipe-Visionsaufgabe.
statisch lang	generateResultTimestampMs(RunningMode runningMode, Paketpaket) Generiert den Zeitstempel eines Ergebnisobjekts einer Vision-Aufgabe aus dem Ausführungsmodus der Vision-Aufgabe und dem Ausgabepaket.

Aus Klasse java.lang.Object

boolean	equals(Objekt arg0)
final Class<?>	getClass()
int	hashCode()
endgültig void	notify()
endgültig void	notifyAll()
String	toString()
endgültig void	wait(long arg0, int arg1)
endgültig void	wait(lange arg0)
endgültig void	wait()

Von Interface java.lang.AutoCloseable

Abstrakt void

close()

Felder

public static final Set<Connection> HAND_CONNECTIONS

public static final Set<Connection> HAND_INDEX_FINGER_CONNECTIONS

public static final Set<Connection> HAND_MIDDLE_FINGER_CONNECTIONS

public static final Set<Connection> HAND_PALM_CONNECTIONS

public static final Set<Connection> HAND_PINKY_FINGER_CONNECTIONS

public static final Set<Connection> HAND_RING_FINGER_CONNECTIONS

public static final Set<Connection> HAND_THUMB_CONNECTIONS

Public Methods

public static HandLandmarker createFromBuffer (Kontextkontext, ByteBuffer modelBuffer)

Erstellt eine HandLandmarker-Instanz aus einem Modellpuffer und dem Standardwert HandLandmarker.HandLandmarkerOptions.

Parameter

context	ein Android-`ERROR(/Context)`.
modelBuffer	ein direktes `ByteBuffer` oder ein `ERROR(/MappedByteBuffer)` des Erkennungsmodells.

Löst aus

	Wenn beim Erstellen von `HandLandmarker` ein Fehler auftritt.

public static HandLandmarker createFromFile (Context context, String modelPath)

Erstellt eine HandLandmarker-Instanz aus einer Modelldatei und der Standard-HandLandmarker.HandLandmarkerOptions.

Parameter

context	ein Android-`ERROR(/Context)`.
modelPath	Pfad zum Modell für Hand-Markierungen mit Metadaten in den Assets.

Löst aus

	Wenn beim Erstellen von `HandLandmarker` ein Fehler auftritt.

public static HandLandmarker createFromFile (Context context, File modelFile)

Erstellt eine HandLandmarker-Instanz aus einer Modelldatei und der Standard-HandLandmarker.HandLandmarkerOptions.

Parameter

context	ein Android-`ERROR(/Context)`.
modelFile	`File`-Instanz des Modells für Hand-Markierungen.

Löst aus

IOException	Wenn beim Öffnen der TFlite-Modelldatei ein E/A-Fehler auftritt.
	Wenn beim Erstellen von `HandLandmarker` ein Fehler auftritt.

public static HandLandmarker createFromOptions (Context context, HandLandmarker.HandLandmarkerOptions LandmarkerOptions)

Erstellt eine HandLandmarker-Instanz aus einer HandLandmarker.HandLandmarkerOptions.

Parameter

context	ein Android-`ERROR(/Context)`.
landmarkerOptions	Eine `HandLandmarker.HandLandmarkerOptions`-Instanz.

Löst aus

	Wenn beim Erstellen von `HandLandmarker` ein Fehler auftritt.

public HandLandmarkerResult detect (MPImage-Bild)

Führt eine Erkennung von Hand-Markierungen auf dem bereitgestellten Einzelbild mit Standard-Bildverarbeitungsoptionen durch, d.h. ohne Drehung. Verwenden Sie diese Methode nur, wenn das HandLandmarker mit ERROR(/RunningMode.IMAGE) erstellt wird. TODO-Update der Java-Dokumentation für das Eingabebildformat.

HandLandmarker unterstützt die folgenden Farbraumtypen:

ERROR(/Bitmap.Config.ARGB_8888)

Parameter

Image	Ein MediaPipe-`MPImage`-Objekt zur Verarbeitung

Löst aus

	wenn ein interner Fehler vorliegt.

public HandLandmarkerResult detect (MPImage-Bild, ImageProcessingOptions imageProcessingOptions)

Führt eine Erkennung von Hand-Markierungen auf dem bereitgestellten Einzelbild durch. Verwenden Sie diese Methode nur, wenn das HandLandmarker mit ERROR(/RunningMode.IMAGE) erstellt wird. TODO-Aktualisierung der Java-Dokumentation für das Eingabebildformat.

HandLandmarker unterstützt die folgenden Farbraumtypen:

ERROR(/Bitmap.Config.ARGB_8888)

Parameter

Image	Ein MediaPipe-`MPImage`-Objekt zur Verarbeitung
imageProcessingOptions	den `ImageProcessingOptions`, der angibt, wie das Eingabebild vor dem Ausführen der Inferenz verarbeitet wird. Beachten Sie, dass die Region von Interesse von dieser Aufgabe nicht unterstützt wird: Die Angabe von `ImageProcessingOptions.regionOfInterest()` führt dazu, dass diese Methode eine geschmeidige Ausnahme auslöst.

Löst aus

IllegalArgumentException	wenn `ImageProcessingOptions` eine relevante Region angibt.
	wenn ein interner Fehler vorliegt.

public void detectAsync (MPImage-Bild, ImageProcessingOptions imageProcessingOptions, long timestampMs)

Sendet Live-Bilddaten, um Handmarkierungen zu erkennen. Die Ergebnisse werden über die OutputHandler.ResultListener in der HandLandmarker.HandLandmarkerOptions zur Verfügung gestellt. Verwenden Sie diese Methode nur, wenn das HandLandmarker mit ERROR(/RunningMode.LIVE_STREAM) erstellt wird.

Es muss ein Zeitstempel (in Millisekunden) angegeben werden, um anzugeben, wann das Eingabebild an die Handmarkierer gesendet wird. Die Eingabezeitstempel müssen kontinuierlich ansteigen.

HandLandmarker unterstützt die folgenden Farbraumtypen:

ERROR(/Bitmap.Config.ARGB_8888)

Parameter

Image	Ein MediaPipe-`MPImage`-Objekt zur Verarbeitung
imageProcessingOptions	den `ImageProcessingOptions`, der angibt, wie das Eingabebild vor dem Ausführen der Inferenz verarbeitet wird. Beachten Sie, dass die Region von Interesse von dieser Aufgabe nicht unterstützt wird: Die Angabe von `ImageProcessingOptions.regionOfInterest()` führt dazu, dass diese Methode eine geschmeidige Ausnahme auslöst.
timestampMs	den Eingabezeitstempel (in Millisekunden).

Löst aus

IllegalArgumentException	wenn `ImageProcessingOptions` eine relevante Region angibt.
	wenn ein interner Fehler vorliegt.

public void detectAsync (MPImage-Image, long timestampMs)

Sendet Live-Bilddaten, um Handmarkierungen mit Standard-Bildverarbeitungsoptionen ohne Drehung zu erkennen. Die Ergebnisse sind über die OutputHandler.ResultListener in HandLandmarker.HandLandmarkerOptions verfügbar. Verwenden Sie diese Methode nur, wenn das HandLandmarker mit ERROR(/RunningMode.LIVE_STREAM) erstellt wird.

Es muss ein Zeitstempel (in Millisekunden) angegeben werden, um anzugeben, wann das Eingabebild an die Handmarkierer gesendet wird. Die Eingabezeitstempel müssen kontinuierlich ansteigen.

HandLandmarker unterstützt die folgenden Farbraumtypen:

ERROR(/Bitmap.Config.ARGB_8888)

Parameter

Image	Ein MediaPipe-`MPImage`-Objekt zur Verarbeitung
timestampMs	den Eingabezeitstempel (in Millisekunden).

Löst aus

	wenn ein interner Fehler vorliegt.

public HandLandmarkerResult detectForVideo (MPImage-Bild, ImageProcessingOptions imageProcessingOptions, long timestampMs)

Führt eine Erkennung von Handmarkierungen im bereitgestellten Videoframe durch. Verwenden Sie diese Methode nur, wenn das HandLandmarker mit ERROR(/RunningMode.VIDEO) erstellt wird.

Sie müssen den Zeitstempel des Videoframes (in Millisekunden) angeben. Die Eingabezeitstempel müssen kontinuierlich ansteigen.

HandLandmarker unterstützt die folgenden Farbraumtypen:

ERROR(/Bitmap.Config.ARGB_8888)

Parameter

Image	Ein MediaPipe-`MPImage`-Objekt zur Verarbeitung
imageProcessingOptions	den `ImageProcessingOptions`, der angibt, wie das Eingabebild vor dem Ausführen der Inferenz verarbeitet wird. Beachten Sie, dass die Region von Interesse von dieser Aufgabe nicht unterstützt wird: Die Angabe von `ImageProcessingOptions.regionOfInterest()` führt dazu, dass diese Methode eine geschmeidige Ausnahme auslöst.
timestampMs	den Eingabezeitstempel (in Millisekunden).

Löst aus

IllegalArgumentException	wenn `ImageProcessingOptions` eine relevante Region angibt.
	wenn ein interner Fehler vorliegt.

public HandLandmarkerResult detectForVideo (MPImage-Bild, langer ZeitstempelMs)

Führt eine Erkennung von Handmarkierungen auf dem bereitgestellten Videoframe mit Standardoptionen für die Bildverarbeitung durch, d.h. ohne Drehung. Verwenden Sie diese Methode nur, wenn das HandLandmarker mit ERROR(/RunningMode.VIDEO) erstellt wird.

Sie müssen den Zeitstempel des Videoframes (in Millisekunden) angeben. Die Eingabezeitstempel müssen kontinuierlich ansteigen.

HandLandmarker unterstützt die folgenden Farbraumtypen:

ERROR(/Bitmap.Config.ARGB_8888)

Parameter

Image	Ein MediaPipe-`MPImage`-Objekt zur Verarbeitung
timestampMs	den Eingabezeitstempel (in Millisekunden).

Löst aus

	wenn ein interner Fehler vorliegt.