Cette page explique comment configurer votre environnement de développement pour utiliser MediaPipe Tasks dans vos applications iOS.
Appareils et plates-formes compatibles
Pour créer des applications iOS avec MediaPipe Tasks, votre environnement de développement nécessite les éléments suivants:
macOS Mojave 10.14.3 ou version ultérieure.
Xcode 10.3 ou version ultérieure.
Un appareil iOS équipé d'iOS 12.0 ou version ultérieure Un simulateur iOS peut également gérer les applications qui ne nécessitent pas l'appareil photo de l'appareil.
Configuration de l'environnement de développement
Avant d'exécuter une tâche MediaPipe sur une application iOS, vous devez disposer d'un projet Xcode ou en créer un sur votre ordinateur local.
MediaPipe Tasks ne peut être installé qu'à l'aide de CocoaPods. Vous devez installer CocoaPods 1.12.1 ou une version ultérieure avant de commencer. Pour savoir comment installer CocoaPods sous macOS, consultez le guide d'installation de CocoaPods.
Exemple de configuration de code
Le dépôt MediaPipe Exemples contient des exemples d'applications iOS pour les tâches MediaPipe.
Vous pouvez créer un projet à partir de l'exemple de code, puis exécuter la tâche. Les étapes suivantes compilent la tâche Classificateur de texte.
Pour importer et créer l'exemple de projet de code, procédez comme suit:
Ouvrez le terminal, clonez le dépôt d'exemples MediaPipe, puis accédez au répertoire contenant
TextClassifier.xcodeproj
etPodfile
.git clone https://github.com/google-ai-edge/mediapipe-samples cd mediapipe/examples/text_classification/ios
Installez MediaPipe Tasks à l'aide de CocoaPods:
pod install
Cette commande crée un fichier
TextClassifier.xcworkspace
dans le répertoire de l'exemple de projet.Double-cliquez sur le fichier
TextClassifier.xcworkspace
pour ouvrir le projet dans Xcode. Si le fichierTextClassifier.xcodeproj
est déjà ouvert, fermez-le avant d'ouvrir le fichierTextClassifier.xcworkspace
.Sélectionnez le schéma
TextClassifier
, puis choisissez un appareil iOS physique ou un simulateur dans la barre d'outils de la fenêtre de votre projet. Si vous utilisez un appareil iOS physique, assurez-vous qu'il est connecté à votre Mac.Cliquez sur le bouton
Run
dans la barre d'outils de votre projet.
Pour en savoir plus sur l'exécution d'une application sur Xcode, consultez la page Compiler et exécuter une application.
Dépendances MediaPipe Tasks
MediaPipe Tasks fournit deux bibliothèques prédéfinies pour la vision et le texte. Le fichier de modèle .tflite
doit se trouver dans le bundle de l'application iOS qui utilise le modèle. En fonction de l'application MediaPipe Tas, ajoutez la bibliothèque de vision ou de texte à la liste des pods dans le Podfile
de CocoaPods. Pour obtenir des instructions sur la création d'un Podfile
avec les pods requis pour votre application, consultez la section Utiliser CocoaPods.
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 installer la bibliothèque d'IA générative de tâches MediaPipe, ajoutez les pods MediaPipeTasksGenAI
et MediaPipeTasksGenAIC
à la cible de votre application dans Podfile
.
API LLM Inference
La tâche d'inférence LLM MediaPipe est contenue dans les pods MediaPipeTasksGenAI
et MediaPipeTasksGenAIC
.
target 'MyLlmInferenceApp' do
use_frameworks!
pod 'MediaPipeTasksGenAI'
pod 'MediaPipeTasksGenAIC'
end
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 installer la bibliothèque de vision MediaPipe Tasks, ajoutez le pod MediaPipeTasksVision
à la cible de votre application dans Podfile
.
target 'MyAppWithMediaPipeTasksVision' do
use_frameworks!
pod 'MediaPipeTasksVision'
end
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 installer la bibliothèque de texte MediaPipe Tasks, ajoutez le pod MediaPipeTasksText
à la cible de votre application dans Podfile
target 'MyAppWithMediaPipeTasksText' do
use_frameworks!
pod 'MediaPipeTasksText'
end
Configurer les cibles de test
Si votre application a une cible de test, assurez-vous que votre Podfile respecte l'une des implémentations suivantes pour éviter tout comportement indésirable lors de l'utilisation d'une bibliothèque de tâches MediaPipe.
La mise en œuvre la plus simple consiste à s'assurer que la cible de test n'est pas imbriquée dans la cible principale de l'application qui ajoute le pod de tâches MediaPipe.
target 'MyAppWithMediaPipeTasks' do
pod 'MediaPipeTasksVision'
end
target 'MyAppWithMediaPipeTasksTests' do
end
Si la cible de test doit être imbriquée dans la cible principale de l'application, le fichier Podfile doit être conforme à l'implémentation suivante:
target 'MyAppWithMediaPipeTasks' do
pod 'MediaPipeTasksVision'
target 'MyAppWithMediaPipeTasksTests' do
inherit! :none
end
end
Configuration de BaseOptions
BaseOptions permet la configuration générale des API MediaPipe Task.
Nom de l'option | Description | Valeurs acceptées |
---|---|---|
modelAssetPath |
Chemin d'accès du modèle à un fichier de modèle du bundle d'applications iOS. | Chemin d'accès sous forme de chaîne. |
Accélération matérielle
Sur iOS, MediaPipe Tasks n'est compatible qu'avec l'exécution de modèles sur des processeurs de processeur standards.
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 iOS, consultez la documentation Apple Developer.