Habilitar funciones EasyAR en una aplicación iOS

Este capítulo describe cómo configurar un proyecto iOS de EasyAR en Xcode sin usar un motor 3D como Unity.

Preparación

Antes de comenzar, prepare lo siguiente:

• Xcode 16 o posterior

• Obtener una licencia EasyAR

• Seleccionar una release version de EasyAR Sense y descargarla

Habilitar EasyAR con Objective-C

1. Añadir Frameworks

   Añada easyar.xcframework en Frameworks, Libraries, and Embedded Content.

   

2. Deshabilitar Bitcode

   EasyAR no usa bitcode ni proporciona compatibilidad con bitcode, por lo que debe deshabilitar bitcode en la configuración.

   

3. Inicializar EasyAR

   Use el método initialize: de easyar_Engine para inicializar EasyAR. Puede añadir el código de inicialización siguiente:

   [easyar_Engine initialize:key];
   

4. Configuración de privacidad

   Como AR necesita usar la cámara, añada Privacy - Camera Usage Description a la configuración de privacidad.

   

   Si va a usar la función de grabación de pantalla, añada Privacy - Microphone Usage Description a la configuración de privacidad.

   

Habilitar EasyAR mediante Swift API

EasyAR Sense Swift API se proporciona como código fuente, lo que permite ofrecer la mejor compatibilidad (Apple proporciona compatibilidad ABI desde Swift 5).

Para usar EasyAR Sense Swift API, primero cree un proyecto framework y luego integre el framework target en su proyecto.

Crear un proyecto framework EasyARSwift

1. Cree un nuevo proyecto de tipo Cocoa Touch Framework y nómbrelo EasyARSwift.

   Puede elegir integrar el proyecto EasyARSwift dentro de su proyecto app o crear un proyecto independiente.

   

2. Importe el código EasyAR Swift al proyecto EasyARSwift

   

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

3. Configure Objective-C Bridging Header en build settings

   

   Nota

   Esta opción no aparecerá en las opciones de XCode antes de importar archivos Swift, por lo que asegúrese de importar primero el código Swift antes de cambiar esta configuración.

4. Importe easyar.xcframework al proyecto EasyARSwift

   

5. Desactive Bitcode

   EasyAR no usa bitcode ni proporciona compatibilidad con bitcode, por lo que debe asegurarse de que bitcode esté deshabilitado en la configuración.

6. Deployment Target

   Modifique deployment target según su proyecto app y asegúrese de que el deployment target del proyecto EasyARSwift sea menor o igual que el del proyecto app.

Integrar y usar el framework EasyARSwift

1. Integre el framework EasyARSwift en el proyecto

   

2. import EasyARSwift en el código fuente Swift

   

Para la forma de escribir código, consulte el código del ejemplo HelloARSwift o API Reference.