Realiza la detección de puntos de referencia de la mano en las imágenes.
Esta API espera un paquete de recursos de modelo de puntos de referencia de mano previamente entrenado. Consulta
- Imagen de entrada
MPImage
- La imagen en la que se ejecuta la detección de puntos de referencia de la mano.
- Salida de HandLandmarkerResult
HandLandmarkerResult
- Un HandLandmarkerResult que contiene puntos de referencia de la mano.
Categorías anidadas
clase | HandLandmarker.HandLandmarkerOptions | Opciones para configurar un HandLandmarker . |
Campos
público estático final Set<Connection> | HAND_CONNECTIONS | |
público estático final Set<Connection> | HAND_INDEX_FINGER_CONNECTIONS | |
público estático final Set<Connection> | HAND_MIDDLE_FINGER_CONNECTIONS | |
público estático final Set<Connection> | HAND_PALM_CONNECTIONS | |
público estático final Set<Connection> | HAND_PINKY_FINGER_CONNECTIONS | |
público estático final Set<Connection> | HAND_RING_FINGER_CONNECTIONS | |
público estático final Set<Connection> | HAND_THUMB_CONNECTIONS |
Métodos públicos
HandLandmarker estático |
createFromBuffer(contexto de contexto, modelBuffer de ByteBuffer)
Crea una instancia
HandLandmarker a partir de un búfer de modelo y el HandLandmarker.HandLandmarkerOptions predeterminado. |
HandLandmarker estático |
createFromFile(contexto de contexto, String modelPath)
Crea una instancia de
HandLandmarker a partir de un archivo de modelo y el HandLandmarker.HandLandmarkerOptions predeterminado. |
HandLandmarker estático |
createFromFile(contexto de contexto, Archivo modelFile)
Crea una instancia de
HandLandmarker a partir de un archivo de modelo y el HandLandmarker.HandLandmarkerOptions predeterminado. |
HandLandmarker estático |
createFromOptions(Contexto de contexto, HandLandmarker.HandLandmarkerOptions punto de referencia)
Crea una instancia de
HandLandmarker a partir de un HandLandmarker.HandLandmarkerOptions . |
HandLandmarkerResult | |
HandLandmarkerResult |
detect(imagen MPImage, ImageProcessingOptions imageProcessingOptions)
Realiza la detección de puntos de referencia de la mano en la imagen única proporcionada.
|
void |
detectAsync(imagen MPImage, ImageProcessingOptions imageProcessingOptions, marca de tiempo largaMs)
Envía datos de imágenes en vivo para realizar la detección de puntos de referencia de la mano, y los resultados estarán disponibles a través del
OutputHandler.ResultListener proporcionado en HandLandmarker.HandLandmarkerOptions . |
void |
detectAsync(imagen MPImage, timestampMs largo)
Envía datos de imágenes en vivo para realizar la detección de puntos de referencia de la mano con las opciones de procesamiento de imágenes predeterminadas, p.ej.,
|
HandLandmarkerResult |
detectForVideo(imagen MPImage, ImageProcessingOptions imageProcessingOptions, marca de tiempo largaMs)
Realiza la detección de puntos de referencia de la mano en el fotograma de video proporcionado.
|
HandLandmarkerResult |
detectForVideo(imagen MPImage, timestampMs largo)
Realiza la detección de puntos de referencia de la mano en el fotograma de video proporcionado con opciones de procesamiento de imágenes predeterminadas, p.ej.,
|
Métodos heredados
Campos
Métodos públicos
estático público HandLandmarker createFromBuffer (contexto de contexto, ByteBuffer modelBuffer)
Crea una instancia HandLandmarker
a partir de un búfer de modelo y el HandLandmarker.HandLandmarkerOptions
predeterminado.
Parámetros
Contexto | un ERROR(/Context) de Android |
---|---|
modelBuffer | un ByteBuffer directo o un ERROR(/MappedByteBuffer) del modelo de detección. |
Arroja
Si se produce un error durante la creación de HandLandmarker .
|
publica estática estática HandLandmarker createFromFile (contexto de contexto, String modelPath)
Crea una instancia de HandLandmarker
a partir de un archivo de modelo y el HandLandmarker.HandLandmarkerOptions
predeterminado.
Parámetros
Contexto | un ERROR(/Context) de Android |
---|---|
modelPath | Es la ruta de acceso al modelo de puntos de referencia de la mano con metadatos en los recursos. |
Arroja
Si se produce un error durante la creación de HandLandmarker .
|
publica estática estática HandLandmarker createFromFile (contexto de contexto, archivo modelFile)
Crea una instancia de HandLandmarker
a partir de un archivo de modelo y el HandLandmarker.HandLandmarkerOptions
predeterminado.
Parámetros
Contexto | un ERROR(/Context) de Android |
---|---|
modelFile | la instancia File del modelo de puntos de referencia de la mano. |
Arroja
IOException | si se produce un error de E/S cuando se abre el archivo del modelo de tflite. |
---|---|
Si se produce un error durante la creación de HandLandmarker .
|
estático público HandLandmarker createFromOptions (Contexto del contexto, HandLandmarker.HandLandmarkerOptions puntos de referencia)
Crea una instancia de HandLandmarker
a partir de un HandLandmarker.HandLandmarkerOptions
.
Parámetros
Contexto | un ERROR(/Context) de Android |
---|---|
landmarkerOptions | una instancia de HandLandmarker.HandLandmarkerOptions . |
Arroja
Si se produce un error durante la creación de HandLandmarker .
|
public HandLandmarkerResult detect (imagen de MPImage)
Realiza la detección de puntos de referencia de la mano en la imagen única proporcionada con opciones de procesamiento de imagen predeterminadas, es decir, sin rotación. Usa este método solo cuando se cree el HandLandmarker
con ERROR(/RunningMode.IMAGE)
. TODO update java doc para el formato de imagen de entrada.
HandLandmarker
admite los siguientes tipos de espacios de color:
Parámetros
imagen | un objeto MPImage de MediaPipe para su procesamiento |
---|
Arroja
si se produce un error interno. |
public HandLandmarkerResult detect (MPImage imagen, ImageProcessingOptions imageProcessingOptions)
Realiza la detección de puntos de referencia de la mano en la imagen única proporcionada. Usa este método solo cuando
se cree el HandLandmarker
con ERROR(/RunningMode.IMAGE)
. TODO update java doc para el formato de imagen de entrada.
HandLandmarker
admite los siguientes tipos de espacios de color:
Parámetros
imagen | un objeto MPImage de MediaPipe para su procesamiento |
---|---|
imageProcessingOptions | ImageProcessingOptions que especifica cómo procesar la imagen de entrada antes de ejecutar la inferencia. Ten en cuenta que la región de interés no es compatible con esta tarea: especificar ImageProcessingOptions.regionOfInterest() hará que este método arroje una IllegalArgumentException. |
Arroja
IllegalArgumentException | si ImageProcessingOptions especifica una región de interés. |
---|---|
si se produce un error interno. |
public void detectAsync (imagen MPImage, ImageProcessingOptions imageProcessingOptions, long timestampMs)
Envía datos de imágenes en vivo para realizar la detección de puntos de referencia de la mano, y los resultados estarán disponibles a través del OutputHandler.ResultListener
proporcionado en HandLandmarker.HandLandmarkerOptions
. Usa este método solo cuando se cree el HandLandmarker
con ERROR(/RunningMode.LIVE_STREAM)
.
Se debe proporcionar una marca de tiempo (en milisegundos) para indicar cuándo se envía la imagen de entrada al punto de referencia de la mano. Las marcas de tiempo de entrada deben aumentar monótonamente.
HandLandmarker
admite los siguientes tipos de espacios de color:
Parámetros
imagen | un objeto MPImage de MediaPipe para su procesamiento |
---|---|
imageProcessingOptions | ImageProcessingOptions que especifica cómo procesar la imagen de entrada antes de ejecutar la inferencia. Ten en cuenta que la región de interés no es compatible con esta tarea: especificar ImageProcessingOptions.regionOfInterest() hará que este método arroje una IllegalArgumentException. |
timestampMs | la marca de tiempo de entrada (en milisegundos). |
Arroja
IllegalArgumentException | si ImageProcessingOptions especifica una región de interés. |
---|---|
si se produce un error interno. |
public void detectAsync (imagen MPImage, timestampMs largo)
Envía datos de imágenes en vivo para realizar la detección de puntos de referencia de la mano con opciones de procesamiento de imagen predeterminadas (es decir, sin rotación), y los resultados estarán disponibles a través del OutputHandler.ResultListener
proporcionado en HandLandmarker.HandLandmarkerOptions
. Usa este método solo cuando
se cree el HandLandmarker
con ERROR(/RunningMode.LIVE_STREAM)
.
Se debe proporcionar una marca de tiempo (en milisegundos) para indicar cuándo se envía la imagen de entrada al punto de referencia de la mano. Las marcas de tiempo de entrada deben aumentar monótonamente.
HandLandmarker
admite los siguientes tipos de espacios de color:
Parámetros
imagen | un objeto MPImage de MediaPipe para su procesamiento |
---|---|
timestampMs | la marca de tiempo de entrada (en milisegundos). |
Arroja
si se produce un error interno. |
público HandLandmarkerResult detectForVideo (MPImage imagen, ImageProcessingOptions imageProcessingOptions, long timestampMs)
Realiza la detección de puntos de referencia de la mano en el fotograma de video proporcionado. Usa este método solo cuando
se cree el HandLandmarker
con ERROR(/RunningMode.VIDEO)
.
Es obligatorio proporcionar la marca de tiempo del fotograma del video (en milisegundos). Las marcas de tiempo de entrada deben aumentar de forma monótona.
HandLandmarker
admite los siguientes tipos de espacios de color:
Parámetros
imagen | un objeto MPImage de MediaPipe para su procesamiento |
---|---|
imageProcessingOptions | ImageProcessingOptions que especifica cómo procesar la imagen de entrada antes de ejecutar la inferencia. Ten en cuenta que la región de interés no es compatible con esta tarea: especificar ImageProcessingOptions.regionOfInterest() hará que este método arroje una IllegalArgumentException. |
timestampMs | la marca de tiempo de entrada (en milisegundos). |
Arroja
IllegalArgumentException | si ImageProcessingOptions especifica una región de interés. |
---|---|
si se produce un error interno. |
público HandLandmarkerResult detectForVideo (MPImage imagen, timestampMs largo)
Realiza la detección de puntos de referencia de la mano en el fotograma de video proporcionado con opciones de procesamiento
de imágenes predeterminadas, es decir, sin rotación. Usa este método solo cuando se cree el HandLandmarker
con ERROR(/RunningMode.VIDEO)
.
Es obligatorio proporcionar la marca de tiempo del fotograma del video (en milisegundos). Las marcas de tiempo de entrada deben aumentar de forma monótona.
HandLandmarker
admite los siguientes tipos de espacios de color:
Parámetros
imagen | un objeto MPImage de MediaPipe para su procesamiento |
---|---|
timestampMs | la marca de tiempo de entrada (en milisegundos). |
Arroja
si se produce un error interno. |