Guida alla configurazione per Android

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:

  1. Avvia Android Studio.
  2. In Android Studio, seleziona File > Nuovo > Importa progetto.
  3. Vai alla directory del codice di esempio contenente il file build.gradle e seleziona quella directory, ad esempio: .../mediapipe/examples/text_classification/android/build.gradle
  4. Se Android Studio richiede una sincronizzazione Gradle, scegli Ok.
  5. 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:

  1. Da Android Studio, esegui il progetto selezionando Esegui > Esegui....
  2. 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.