Habilitar funciones de EasyAR en aplicaciones iOS

Este capítulo explica cómo configurar un proyecto de iOS para EasyAR en Xcode sin utilizar motores 3D como Unity.

Preparativos

Antes de comenzar, necesitarás:

• Xcode 16 o versión más reciente
• Obtener una licencia de EasyAR
• Seleccionar una versión de lanzamiento de EasyAR Sense y descargarla

Habilitar EasyAR usando Objective-C

1. Agregar frameworks

   Agrega easyar.xcframework en Frameworks, Libraries, and Embedded Content.

   

2. Deshabilitar Bitcode

   EasyAR no usa bitcode ni ofrece compatibilidad con bitcode, por lo que debes deshabilitarlo en la configuración.

   

3. Inicializar EasyAR

   Usa el método initialize: de easyar_Engine para inicializar EasyAR. Puedes agregar el código de inicialización así:

   [easyar_Engine initialize:key];
   

4. Configuración de privacidad

   Como AR utiliza la cámara, debes agregar Privacy - Camera Usage Description en la configuración de privacidad.

   

   Si necesitas funcionalidad de grabación de pantalla, agrega Privacy - Microphone Usage Description.

   

Habilitar EasyAR mediante Swift API

La API Swift de EasyAR Sense se proporciona en forma de código fuente para garantizar la máxima compatibilidad (Apple ofrece compatibilidad ABI desde Swift 5).

Para usar la API Swift de EasyAR Sense, primero crea un proyecto de framework, luego incrusta el framework target en tu proyecto.

Crear proyecto de framework EasyARSwift

1. Crea un nuevo proyecto de tipo Cocoa Touch Framework y nómbralo EasyARSwift

   Puedes elegir incrustar el proyecto EasyARSwift dentro de tu proyecto de aplicación o crear un proyecto independiente.

   

2. Importa el código Swift de EasyAR al proyecto EasyARSwift

   

   El archivo EasyARSwift.h generado automáticamente por XCode no se utiliza y puede eliminarse de forma segura.

3. Configura Objective-C Bridging Header en build settings

   

   Nota

   Esta opción no aparece en las opciones de XCode hasta que importes los archivos swift, así que asegúrate de importar primero el código Swift antes de cambiar la configuración.

4. Importa easyar.xcframework al proyecto EasyARSwift

   

5. Desactivar Bitcode

   EasyAR no usa bitcode ni ofrece compatibilidad con bitcode, por lo que debes asegurarte de deshabilitarlo en la configuración.

6. Deployment Target

   Modifica el deployment target según tu proyecto de aplicación, asegurando que el deployment target del proyecto EasyARSwift sea menor o igual que el del proyecto de aplicación.

Incrustar y usar el framework EasyARSwift

1. Incrusta el framework EasyARSwift en tu proyecto

   

2. En tu código Swift, usa import EasyARSwift

   

Puedes consultar el código de ejemplo HelloARSwift o la API Reference como guía para escribir el código.