Cette page explique comment configurer votre environnement de développement pour utiliser MediaPipe Tasks dans vos applications Android.
Appareils et plates-formes compatibles
Pour créer des applications Android avec MediaPipe Tasks, votre environnement de développement nécessite les éléments suivants:
- Android Studio avec une version recommandée d'au moins 2021.1.1 (Bumblebee) ou un autre IDE compatible.
- SDK Android 24 ou version ultérieure
- Un appareil Android équipé de la version minimale du SDK Il est possible qu'un émulateur Android ne fonctionne pas pour toutes les tâches.
Configuration de l'environnement de développement
Avant d'exécuter une tâche MediaPipe dans une application Android, vous devez disposer d'une application existante ou créer un projet Android Studio sur votre ordinateur local. MediaPipe s'intègre à la couche de données de votre application, qui contient les données et la logique métier de l'application. Pour en savoir plus sur l'architecture des applications Android, consultez le Guide de l'architecture des applications.
Configuration des appareils Android
Vous devez activer les options pour les développeurs et le débogage USB sur un appareil Android physique avant de l'utiliser pour tester votre application. Pour obtenir des instructions sur la configuration de votre appareil avec les options pour les développeurs, consultez Configurer les options pour les développeurs sur l'appareil.
Pour les tâches qui ne nécessitent pas la caméra ni le micro de l'appareil, vous pouvez utiliser un émulateur d'appareil Android au lieu d'un appareil Android physique. Pour obtenir des instructions sur la configuration d'Android Emulator, consultez Exécuter des applications sur Android Emulator.
Exemple de configuration de code
Le dépôt MediaPipe Exemples contient des exemples d'applications Android pour chaque tâche MediaPipe. Vous pouvez créer un projet à partir de l'exemple de code, puis l'exécuter.
Pour importer et créer l'exemple de projet de code, procédez comme suit:
- Lancez Android Studio.
- Dans Android Studio, sélectionnez File > New > Import Project (Fichier > Nouveau > Importer un projet).
- Accédez au répertoire de l'exemple de code contenant le fichier
build.gradle
, puis sélectionnez-le, par exemple :.../mediapipe/examples/text_classification/android/build.gradle
- Si Android Studio demande une synchronisation Gradle, sélectionnez OK.
- Assurez-vous que votre appareil Android est connecté à votre ordinateur et que le mode développeur est activé. Cliquez sur la flèche verte
Run
.
Si vous sélectionnez le bon répertoire, Android Studio crée un projet et le compile. Ce processus peut prendre quelques minutes, en fonction de la vitesse de votre ordinateur et si vous avez utilisé Android Studio pour d'autres projets. Une fois la compilation terminée, Android Studio affiche un message BUILD SUCCESSFUL
dans le panneau d'état Build Output (Sortie de compilation).
Pour exécuter le projet:
- Dans Android Studio, exécutez le projet en sélectionnant Run > Run (Exécuter > Exécuter).
- Sélectionnez un appareil Android (ou un émulateur) connecté pour tester l'application.
Dépendances MediaPipe Tasks
MediaPipe Tasks fournit trois bibliothèques prédéfinies pour la vision, le texte et l'audio. Le fichier de modèle .tflite
doit se trouver dans le répertoire d'éléments du module Android qui utilise le modèle. En fonction de la tâche MediaPipe utilisée par l'application, ajoutez la bibliothèque vision, texte ou audio à la liste des dépendances dans le fichier build.gradle
.
Tâches d'IA générative
Les bibliothèques d'IA générative de MediaPipe Tasks contiennent des tâches qui gèrent la génération d'images ou de texte. Pour importer les bibliothèques d'IA générative de tâches MediaPipe dans Android Studio, ajoutez les dépendances à votre fichier build.gradle
.
Générateur d'images
La tâche du générateur d'images MediaPipe est contenue dans la bibliothèque tasks-vision-image-generator
. Ajoutez la dépendance à votre fichier build.gradle
:
dependencies {
implementation 'com.google.mediapipe:tasks-vision-image-generator:latest.release'
}
API LLM Inference
La tâche d'inférence LLM MediaPipe est contenue dans la bibliothèque tasks-genai
. Ajoutez la dépendance à votre fichier build.gradle
:
dependencies {
implementation 'com.google.mediapipe:tasks-genai:latest.release'
}
Tâches visuelles
La bibliothèque de vision MediaPipe Tasks contient des tâches qui traitent des entrées d'image ou de vidéo. Pour importer la bibliothèque Vision Tasks MediaPipe dans Android Studio, ajoutez les dépendances suivantes à votre fichier build.gradle
:
dependencies {
implementation 'com.google.mediapipe:tasks-vision:latest.release'
}
Tâches liées au texte
La bibliothèque de texte MediaPipe Tasks contient des tâches qui traitent les données de langue au format texte. Pour importer la bibliothèque de texte MediaPipe Tasks dans Android Studio, ajoutez les dépendances suivantes à votre fichier build.gradle
:
dependencies {
implementation 'com.google.mediapipe:tasks-text:latest.release'
}
Tâches audio
La bibliothèque audio MediaPipe Tasks contient des tâches qui gèrent les entrées audio. Pour importer la bibliothèque audio MediaPipe Tasks dans Android Studio, ajoutez les dépendances suivantes à votre fichier build.gradle
:
dependencies {
implementation 'com.google.mediapipe:tasks-audio:latest.release'
}
Configuration de BaseOptions
Le BaseOptions
permet de configurer des API MediaPipe Tasks.
Nom de l'option | Description | Valeurs acceptées |
---|---|---|
modelAssetBuffer |
Le contenu du fichier d'éléments du modèle se présente sous la forme d'un ByteBuffer direct ou d'un MappedByteBuffer . |
ByteBuffer ou MappedByteBuffer sous forme de chaîne |
modelAssetPath |
Chemin d'accès du modèle à un fichier de composants de modèle dans le dossier de composants Application Android. | Chemin d'accès au fichier sous forme de chaîne |
modelAssetFileDescriptor |
Entier du descripteur de fichier natif d'un fichier d'élément de modèle. | Entier spécifiant le descripteur de fichier |
Delegate |
Active l'accélération matérielle via un délégué d'appareil afin d'exécuter le pipeline MediaPipe. Valeur par défaut : CPU |
[CPU ,GPU ] |
Accélération matérielle
MediaPipe Tasks accepte l'utilisation de processeurs graphiques (GPU) pour exécuter des modèles de machine learning. Sur les appareils Android, vous pouvez activer l'exécution de vos modèles avec accélération GPU à l'aide d'un délégué. Les délégués agissent comme des pilotes matériels pour MediaPipe, ce qui vous permet d'exécuter vos modèles sur des processeurs GPU au lieu de processeurs standards.
Configurez la délégation GPU dans les options de la tâche via BaseOptions
:
BaseOptions baseOptions = BaseOptions.builder().useGpu().build();
Dépannage
Pour obtenir de l'aide concernant des questions techniques concernant MediaPipe, consultez le groupe de discussion ou Stack Overflow afin d'obtenir l'aide de la communauté. Pour signaler des bugs ou demander des fonctionnalités, signalez un problème sur GitHub.
Si vous avez besoin d'aide pour configurer votre environnement de développement Android, consultez la documentation Android pour les développeurs.