Guide de démarrage rapide d'Augmented Faces pour iOS

Ce guide vous explique comment :

• Configurer votre environnement de développement pour qu'il fonctionne avec les visages augmentés
• Appliquer des textures 2D et associer des objets 3D aux visages détectés

Prérequis

• Xcode version 13.0 ou ultérieure
• CocoaPods 1.4.0 ou version ultérieure si vous utilisez CocoaPods
• Un appareil Apple compatible avec ARKit fonctionnant sous iOS 12.0 ou version ultérieure (cible de déploiement d'iOS 12.0 ou version ultérieure requise)

Remarque : À partir d'ARCore 1.12, tous les appareils compatibles avec ARKit sont compatibles.

Utiliser la fonctionnalité Augmented Faces

Les étapes suivantes utilisent l'application exemple Augmented Faces pour vous montrer les tâches essentielles à la configuration et au développement d'une application dotée des fonctionnalités Augmented Faces.

Télécharger l'application exemple Augmented Faces

1. Clonez ou téléchargez la dernière version du SDK ARCore pour iOS depuis GitHub pour obtenir l'exemple de code d'application.
2. Ouvrez une fenêtre de terminal ou de Finder, puis accédez au dossier dans lequel vous avez cloné ou téléchargé le SDK.
3. Vous trouverez l'exemple de code de l'application dans /Examples/AugmentedFacesExample.

Exécuter pod install

L'application AugmentedFacesSample est fournie avec un Podfile préconfiguré avec le SDK ARCore et les versions iOS dont vous avez besoin. Pour installer ces dépendances:

1. Ouvrez une fenêtre de terminal et exécutez pod install à partir du dossier où se trouve le projet Xcode. Cela génère un fichier *.xcworkspace que vous utiliserez ultérieurement pour créer et exécuter l'application.

Créer et exécuter l'application

1. Ouvrez le fichier .xcworkspace (et non .xcodeproj) du projet dans Xcode.
2. Ouvrez les paramètres généraux de la cible et modifiez l'identifiant du bundle.
3. Appuyez sur Cmd+R ou cliquez sur Exécuter. Utilisez un appareil physique et non le simulateur pour utiliser la fonctionnalité Augmented Face. L'appareil doit être connecté à votre ordinateur de développement via un câble USB.

Remarque :Comme le simulateur ne comporte pas d'appareil photo, les applications qui utilisent la fonctionnalité Visages augmentées doivent être exécutées sur un appareil physique.

Tester l'application exemple

1. Compilez et exécutez l'application exemple à partir du fichier .xcworkspace pour la lancer sur votre appareil.
2. Si vous y êtes invité, accordez à l'application l'autorisation d'accéder à la caméra. ARCore commence alors à détecter les visages visibles dans la caméra. Actuellement, une seule détection de visage à la fois est détectée.
3. Assurez-vous que la caméra est face à l'utilisateur.

Étapes suivantes

• Consultez le guide du développeur pour les visages augmentés sur iOS pour découvrir l'exemple de code d'application et en savoir plus sur l'utilisation des visages augmentés dans vos propres applications.
• Consultez la documentation de référence de l'API ARCore pour iOS.
• Regardez la vidéo suivante pour découvrir comment commencer à utiliser les visages augmentés sur iOS :