Activer easyar dans une application ios

Ce chapitre explique comment configurer un projet easyar pour ios dans xcode sans utiliser de moteur 3d comme unity.

Préparation

Avant de commencer, vous aurez besoin de :

• Xcode 16 ou version ultérieure
• Obtenir une licence easyar
• Choisir une version de publication easyar sense et la télécharger

Activer easyar avec objective-c

1. Ajouter des frameworks

   Ajoutez easyar.xcframework dans Frameworks, Libraries, and Embedded Content.

   

2. Désactiver bitcode

   Easyar n'utilise pas bitcode et ne fournit pas de compatibilité bitcode, vous devez donc désactiver bitcode dans la configuration.

   

3. Initialiser easyar

   Utilisez la méthode initialize: de easyar_Engine pour initialiser easyar. Vous pouvez ajouter le code d'initialisation comme suit :

   [easyar_Engine initialize:key];
   

4. Configuration de confidentialité

   Comme ar utilise la caméra, la configuration de confidentialité nécessite d'ajouter Privacy - Camera Usage Description,

   

   Si vous souhaitez utiliser la fonction d'enregistrement d'écran, la configuration de confidentialité nécessite d'ajouter Privacy - Microphone Usage Description,

   

Activer easyar via l'api swift

L'api swift d'easyar sense est fournie sous forme de code source, ce qui offre la meilleure compatibilité (apple fournit une compatibilité abi à partir de swift 5).

Pour utiliser l'api swift d'easyar sense, vous devez d'abord créer un projet framework, puis intégrer la cible framework dans votre projet.

Créer un projet framework easyarswift

1. Créez un nouveau projet de type cocoa touch framework et nommez-le easyarswift

   Vous pouvez choisir d'intégrer le projet easyarswift dans votre projet d'application ou de créer un projet séparé.

   

2. Importez le code swift d'easyar dans le projet easyarswift

   

   Le fichier easyarswift.h généré automatiquement par xcode n'est pas utilisé et peut être supprimé en toute sécurité.

3. Configurez objective-c bridging header dans les paramètres de construction

   

   Note

   Cette option n'apparaît pas dans les options xcode avant d'importer les fichiers swift, assurez-vous donc d'importer d'abord le code swift avant de modifier la configuration.

4. Importez easyar.xcframework dans le projet easyarswift

   

5. Désactiver bitcode

   Easyar n'utilise pas bitcode et ne fournit pas de compatibilité bitcode, assurez-vous de désactiver bitcode dans la configuration.

6. Cible de déploiement

   Modifiez deployment target en fonction de votre projet d'application, assurez-vous que deployment target du projet easyarswift est inférieur ou égal à celui du projet d'application.

Intégrer et utiliser le framework easyarswift

1. Intégrez le framework easyarswift dans votre projet

   

2. Dans le code swift, import easyarswift

   

Pour des exemples d'écriture de code, reportez-vous au code de l'exemple helloarswift ou à la référence de l'api.