Scopri di più sui nostri annunci di Google AI Edge da I/O

Questa pagina è stata tradotta dall'API Cloud Translation.

ImageEmbedder

classe pubblica finale ImageEmbedder

Esegue l'estrazione dell'incorporamento sulle immagini.

L'API prevede un modello TFLite con metadati del modello TFLite facoltativi, ma vivamente consigliati.

L'API supporta modelli con un tensore di input dell'immagine e uno o più tensori di output. Per essere più specifici, di seguito sono riportati i requisiti.

Tensore immagine di input (kTfLiteUInt8/kTfLiteFloat32)
- immagine di dimensione [batch x height x width x channels].
- l'inferenza batch non è supportata (batch deve essere 1).
- sono supportati solo gli ingressi RGB (channels deve essere pari a 3).
- se il tipo è kTfLiteFloat32, è necessario collegare NormalizationOptions ai metadati per la normalizzazione dell'input.
Almeno un tensore di output (kTfLiteUInt8/kTfLiteFloat32) con forma [1 x N], dove N è il numero di dimensioni negli incorporamenti prodotti.

Corsi nidificati

classe ImageEmbedder.ImageEmbedderOptions Opzioni per la configurazione e ImageEmbedder.

Metodi pubblici

statico doppio	cosineSimilarity(Embedding u, Embedding v) Funzione di utilità per calcolare la somiglianza coseno tra due oggetti `Embedding`.
statico ImageEmbedder	createFromBuffer(Context context, ByteBuffer modelBuffer) Crea un'istanza `ImageEmbedder` da un buffer del modello e dal valore predefinito di `ImageEmbedder.ImageEmbedderOptions`.
statico ImageEmbedder	createFromFile(Contesto del contesto, Stringa modelPath) Crea un'istanza `ImageEmbedder` da un file del modello e dal valore predefinito di `ImageEmbedder.ImageEmbedderOptions`.
statico ImageEmbedder	createFromFile(Contesto del contesto, File modelFile) Crea un'istanza `ImageEmbedder` da un file del modello e dal valore predefinito di `ImageEmbedder.ImageEmbedderOptions`.
statico ImageEmbedder	createFromOptions(Contesto del contesto, opzioni ImageEmbedder.ImageEmbedderOptions) Crea un'istanza `ImageEmbedder` da un'istanza `ImageEmbedder.ImageEmbedderOptions`.
ImageEmbedderResult	embed(MPImage immagine, ImageProcessingOptions image elaborazioneOptions) Esegue l'estrazione dell'incorporamento sull'immagine singola fornita.
ImageEmbedderResult	embed(immagine MPImage) Esegue l'estrazione di incorporamento sulla singola immagine fornita con opzioni di elaborazione delle immagini predefinite, ad esempio
void	embedAsync(MPImage immagine, ImageProcessingOptions imageElaborazioneOptions, timestamp lunghiMs) Invia i dati delle immagini live per eseguire l'estrazione dell'incorporamento e i risultati saranno disponibili tramite `OutputHandler.ResultListener` fornito in `ImageEmbedder.ImageEmbedderOptions`.
void	embedAsync(immagine MPImage, timestamp lunghiM) Invia i dati delle immagini live per eseguire l'estrazione tramite incorporamento con le opzioni di elaborazione delle immagini predefinite, ad esempio
ImageEmbedderResult	embedForVideo(MPImage immagine, ImageProcessingOptions image elaborazioneOptions, timestamp lunghiMs) Esegue l'estrazione dell'incorporamento sul frame video fornito.
ImageEmbedderResult	embedForVideo(immagine MPImage, timestamp lunghiM) Esegue l'estrazione dell'incorporamento sul frame video fornito con opzioni di elaborazione delle immagini predefinite, ad esempio

Metodi ereditati

Dalla classe com.google.mediapipe.tasks.vision.core.BaseVisionTaskApi

void	close() Chiude e pulisce l'attività di visione artificiale di MediaPipe.
statico lungo	generateResultTimestampMs(RunningMode runningMode, pacchetto pacchetto) Genera il timestamp di un oggetto risultato di un'attività di visione dalla modalità di esecuzione dell'attività di visione artificiale e dal pacchetto di output.

Dalla classe java.lang.Object

boolean	uguale a(Object arg0)
final Corso<?>	getClass()
int	hashCode()
finale void	notify()
finale void	notifyAll()
String	toString()
finale void	wait(long arg0, int arg1)
finale void	wait(long arg0)
finale void	wait()

Dall'interfaccia java.lang.AutoCloseable

astratto void

close()

Metodi pubblici

pubblico statico doppio cosineSimilarity (Embedding u, Embedding v)

Funzione di utilità per calcolare la somiglianza coseno tra due oggetti Embedding.

Parametri

u
v

Lanci

IllegalArgumentException	gli incorporamenti sono di tipo diverso (in virgola mobile o quantizzato), hanno dimensioni diverse o hanno una norma L2 pari a 0.

statico pubblico ImageEmbedder createFromBuffer (Context context, ByteBuffer modelBuffer)

Crea un'istanza ImageEmbedder da un buffer del modello e dal valore predefinito di ImageEmbedder.ImageEmbedderOptions.

Parametri

context	un `ERROR(/Context)` Android.
modelBuffer	un `ByteBuffer` diretto o un `ERROR(/MappedByteBuffer)` del modello di incorporamento.

Lanci

	in caso di errore durante la creazione di `ImageEmbedder`.

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

Crea un'istanza ImageEmbedder da un file del modello e dal valore predefinito di ImageEmbedder.ImageEmbedderOptions.

Parametri

context	un `ERROR(/Context)` Android.
modelPath	del modello di incorporamento negli asset.

Lanci

	in caso di errore durante la creazione di `ImageEmbedder`.

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

Crea un'istanza ImageEmbedder da un file del modello e dal valore predefinito di ImageEmbedder.ImageEmbedderOptions.

Parametri

context	un `ERROR(/Context)` Android.
modelFile	l'istanza del modello di incorporamento `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 `ImageEmbedder`.

pubblico static ImageEmbedder createFromOptions (Contesto del contesto, opzioni ImageEmbedder.ImageEmbedderOptions)

Crea un'istanza ImageEmbedder da un'istanza ImageEmbedder.ImageEmbedderOptions.

Parametri

context	un `ERROR(/Context)` Android.
opzioni del modello.	un'istanza `ImageEmbedder.ImageEmbedderOptions`.

Lanci

	in caso di errore durante la creazione di `ImageEmbedder`.

Public ImageEmbedderResult embed (MPImage immagine, ImageProcessingOptions imageElaborazioneOptions)

Esegue l'estrazione dell'incorporamento sull'immagine singola fornita. Utilizza questo metodo solo quando ImageEmbedder viene creato con ERROR(/RunningMode.IMAGE).

ImageEmbedder supporta i seguenti tipi di spazi colore:

ERROR(/Bitmap.Config.ARGB_8888)

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.

Lanci

	in caso di errore interno.

Public ImageEmbedderResult embed (MPImage immagine)

Esegue l'estrazione dell'incorporamento sulla singola immagine fornita con le opzioni di elaborazione delle immagini predefinite, ovvero utilizzando l'intera immagine come regione di interesse e senza alcuna rotazione applicata. Utilizza questo metodo solo quando ImageEmbedder viene creato con ERROR(/RunningMode.IMAGE).

ImageEmbedder supporta i seguenti tipi di spazi colore:

ERROR(/Bitmap.Config.ARGB_8888)

Parametri

immagine	un oggetto `MPImage` di MediaPipe per l'elaborazione.

Lanci

	in caso di errore interno.

pubblici void embedAsync (immagine MPImage, ImageProcessingOptions image ProcessingOptions, timestamp lunghiMs)

Invia i dati delle immagini live per eseguire l'estrazione dell'incorporamento e i risultati saranno disponibili tramite OutputHandler.ResultListener fornito in ImageEmbedder.ImageEmbedderOptions. Utilizza questo metodo solo quando ImageEmbedder viene creato con ERROR(/RunningMode.LIVE_STREAM).

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

ImageEmbedder supporta i seguenti tipi di spazi colore:

ERROR(/Bitmap.Config.ARGB_8888)

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.
timestampMs	il timestamp di input (in millisecondi).

Lanci

	in caso di errore interno.

Public void embedAsync (immagine MPImage, timestamp lunghiMs)

Invia i dati delle immagini attive per eseguire l'estrazione dell'incorporamento con le opzioni di elaborazione delle immagini predefinite, ovvero utilizzando l'intera immagine come regione di interesse e senza alcuna rotazione applicata, e i risultati saranno disponibili tramite OutputHandler.ResultListener fornito in ImageEmbedder.ImageEmbedderOptions. Utilizza questo metodo solo quando ImageEmbedder viene creato con ERROR(/RunningMode.LIVE_STREAM).

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

ImageEmbedder supporta i seguenti tipi di spazi colore:

ERROR(/Bitmap.Config.ARGB_8888)

Parametri

immagine	un oggetto `MPImage` di MediaPipe per l'elaborazione.
timestampMs	il timestamp di input (in millisecondi).

Lanci

	in caso di errore interno.

pubblici ImageEmbedderResult embedForVideo (MPImage immagine, ImageProcessingOptions imageProcessOptions, timestamp lunghiMs)

Esegue l'estrazione dell'incorporamento sul frame video fornito. Utilizza questo metodo solo quando ImageEmbedder 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.

ImageEmbedder supporta i seguenti tipi di spazi colore:

ERROR(/Bitmap.Config.ARGB_8888)

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.
timestampMs	il timestamp di input (in millisecondi).

Lanci

	in caso di errore interno.

Public ImageEmbedderResult embedForVideo (immagine MPImage, timestamp lungoMs)

Esegue l'estrazione dell'incorporamento sul frame video fornito con le opzioni di elaborazione delle immagini predefinite, ovvero utilizzando l'intera immagine come regione di interesse e senza alcuna rotazione applicata. Utilizza questo metodo solo quando ImageEmbedder 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.

ImageEmbedder supporta i seguenti tipi di spazi colore:

ERROR(/Bitmap.Config.ARGB_8888)

Parametri

immagine	un oggetto `MPImage` di MediaPipe per l'elaborazione.
timestampMs	il timestamp di input (in millisecondi).

Lanci

	in caso di errore interno.