Questa pagina mostra come configurare l'ambiente di sviluppo per utilizzare MediaPipe Tasks nelle tue app Android.
Piattaforme e dispositivi supportati
Per creare applicazioni Android con MediaPipe Tasks, il team di sviluppo richiede quanto segue:
- Android Studio con versione consigliata di almeno la versione 2021.1.1 (Bumblebee) o un'altra versione IDE.
- SDK per Android versione 24 o successive
- Dispositivo Android con almeno la versione minima dell'SDK. Un emulatore Android potrebbe non funzionare per tutte le attività.
Configurazione dell'ambiente di sviluppo
Prima di eseguire un'attività MediaPipe su un'applicazione Android, devi avere: un'app esistente o creare un nuovo progetto Android Studio sul tuo computer locale. MediaPipe si adatta ai campi Data livello della tua app, che contiene i dati dell'applicazione e la logica di business. Per ulteriori informazioni Architettura per le app per Android, consulta la Guida alle app dell'architettura.
Configurazione dispositivo Android
Devi attivare le Opzioni sviluppatore e il debug USB su un dispositivo Android fisico prima di utilizzarlo per testare l'applicazione. Per istruzioni su come configurare dispositivo con Opzioni sviluppatore, consulta l'articolo Configurare lo sviluppatore on-device opzioni.
Per le attività che non richiedono la fotocamera o il microfono del dispositivo, puoi utilizzare un emulatore di dispositivi Android anziché un dispositivo Android fisico. Per istruzioni sulla configurazione di un emulatore Android, leggi l'articolo Eseguire app su Android Emulatore.
Esempio di configurazione del codice
MediaPipe Repository di esempi contiene esempi di applicazioni Android per ogni attività MediaPipe. Puoi creare un dal codice di esempio, creare il progetto ed eseguirlo.
Per importare e creare il progetto di codice di esempio:
- Avvia Android Studio.
- In Android Studio, seleziona File > Nuovo > Importa progetto.
- Vai alla directory del codice di esempio contenente il file
build.gradlee seleziona quella directory, ad esempio:.../mediapipe/examples/text_classification/android/build.gradle - Se Android Studio richiede una sincronizzazione Gradle, scegli Ok.
- Assicurati che il dispositivo Android sia connesso al computer e allo sviluppatore
sia attiva. Fai clic sulla freccia verde
Run.
Se selezioni la directory corretta, Android Studio crea un nuovo progetto e
la creazione. Questa procedura può richiedere alcuni minuti, a seconda della velocità del
dal computer e se hai usato Android Studio per altri progetti. Quando viene creato
viene completata, Android Studio mostra un messaggio BUILD SUCCESSFUL nella
Riquadro di stato Build Output.
Per eseguire il progetto:
- Da Android Studio, esegui il progetto selezionando Esegui > Esegui....
- Seleziona un emulatore o un dispositivo Android collegato per testare l'app.
Dipendenze attività MediaPipe
MediaPipe Tasks fornisce tre librerie predefinite per visione artificiale, testo e audio. La
Il file del modello .tflite deve trovarsi nella directory degli asset di Android
che utilizza il modello. A seconda dell'attività MediaPipe utilizzata dall'app, aggiungi
la libreria di immagini, testo o audio all'elenco delle dipendenze all'interno
build.gradle.
Attività dell'IA generativa
Le librerie di IA generativa di MediaPipe Tasks contengono attività che gestiscono immagini o
la generazione di testo. Per importare le librerie di IA generativa di MediaPipe Tasks in
Android Studio, aggiungi le dipendenze al file build.gradle.
Generatore di immagini
L'attività Generatore di immagini MediaPipe è contenuta all'interno della sezione
Raccolta tasks-vision-image-generator. Aggiungi la dipendenza ai tuoi
File build.gradle:
dependencies {
implementation 'com.google.mediapipe:tasks-vision-image-generator:latest.release'
}
API di inferenza LLM
L'attività di inferenza dell'LLM MediaPipe è contenuta all'interno di tasks-genai
libreria. Aggiungi la dipendenza al file build.gradle:
dependencies {
implementation 'com.google.mediapipe:tasks-genai:latest.release'
}
Attività relative alla vista
La libreria Task Vision di MediaPipe contiene attività che gestiscono immagini o video
di input. Per importare la libreria MediaPipe Tasks Vision in Android Studio, aggiungi
le seguenti dipendenze al tuo file build.gradle:
dependencies {
implementation 'com.google.mediapipe:tasks-vision:latest.release'
}
Attività di testo
La libreria di testo delle attività di MediaPipe contiene attività che gestiscono i dati della lingua
formato di testo. Per importare la libreria di testo delle attività di MediaPipe in Android Studio, aggiungi
le seguenti dipendenze al tuo file build.gradle:
dependencies {
implementation 'com.google.mediapipe:tasks-text:latest.release'
}
Attività audio
La raccolta audio Tasks di MediaPipe contiene attività che gestiscono gli input audio. A
importa la libreria audio Attività di MediaPipe in Android Studio, aggiungi quanto segue
delle dipendenze al tuo file build.gradle:
dependencies {
implementation 'com.google.mediapipe:tasks-audio:latest.release'
}
Configurazione BaseOptions
BaseOptions consente la configurazione generale delle API MediaPipe Tasks.
| Nome opzione | Descrizione | Valori accettati |
|---|---|---|
modelAssetBuffer |
I contenuti del file dell'asset del modello come ByteBuffer diretto o MappedByteBuffer. |
ByteBuffer o MappedByteBuffer come stringa |
modelAssetPath |
Percorso del modello di un file di asset del modello nella cartella degli asset per app per Android. | Percorso del file come stringa |
modelAssetFileDescriptor |
Il numero intero del descrittore di file nativo di un file di asset del modello. | Numero intero che specifica il descrittore del file |
Delegate |
Abilita l'accelerazione hardware attraverso il delegato di un dispositivo per eseguire la pipeline MediaPipe. Valore predefinito: CPU. |
[CPU,GPU] |
Accelerazione hardware
MediaPipe Tasks supporta l'uso di GPU (Graphics Processing Unit) per l'esecuzione modelli di machine learning. Sui dispositivi Android, puoi attivare l'utilizzo di Esecuzione con accelerazione GPU dei modelli mediante un delegato. I delegati agiscono come driver hardware per MediaPipe, che ti consentono di eseguire i tuoi modelli su GPU anziché i processori CPU standard.
Configura il delegato GPU nelle opzioni dell'attività tramite BaseOptions:
BaseOptions baseOptions = BaseOptions.builder().useGpu().build();
Risoluzione dei problemi
Per ricevere assistenza in merito a domande tecniche relative a MediaPipe, leggi la Discussione gruppo o Impila Overflow per ricevere assistenza da la comunità. Per segnalare bug o richiedere funzionalità, segnala un problema su GitHub.
Per ricevere assistenza per la configurazione del tuo ambiente di sviluppo Android, visita il per gli sviluppatori.