Abilitare le funzionalità EasyAR nelle app iOS

Questo capitolo spiega come configurare un progetto iOS per EasyAR in Xcode senza utilizzare motori 3D come Unity.

Preparazione

Prima di iniziare, è necessario:

• Xcode 16 o versione successiva
• Ottenere una licenza EasyAR
• Scegliere una versione di EasyAR Sense e scaricarla

Abilitare EasyAR con Objective-C

1. Aggiungere i framework

   Aggiungere easyar.xcframework in Frameworks, Libraries, and Embedded Content.

   

2. Disabilitare Bitcode

   EasyAR non utilizza bitcode né fornisce compatibilità con bitcode, è necessario disabilitarlo nella configurazione.

   

3. Inizializzare EasyAR

   Utilizzare il metodo initialize: di easyar_Engine per inizializzare EasyAR. È possibile aggiungere il codice di inizializzazione:

   [easyar_Engine initialize:key];
   

4. Configurazione della privacy

   Poiché AR utilizza la fotocamera, nella configurazione della privacy è necessario aggiungere Privacy - Camera Usage Description.

   

   Se si utilizza la funzionalità di registrazione schermo, aggiungere Privacy - Microphone Usage Description.

   

Abilitare EasyAR tramite Swift API

L'API Swift di EasyAR Sense è fornita sotto forma di codice sorgente per garantire la massima compatibilità (Apple fornisce compatibilità ABI a partire da Swift 5).

Per utilizzare l'API Swift di EasyAR Sense, creare prima un progetto framework, quindi incorporare il framework target nel proprio progetto.

Creare il progetto framework EasyARSwift

1. Creare un nuovo progetto di tipo Cocoa Touch Framework denominato EasyARSwift

   È possibile incorporare il progetto EasyARSwift nel proprio progetto app o creare un progetto separato.

   

2. Importare il codice Swift di EasyAR nel progetto EasyARSwift

   

   Il file EasyARSwift.h generato automaticamente da XCode non viene utilizzato e può essere eliminato in sicurezza.

3. Configurare Objective-C Bridging Header nelle build settings

   

   Nota

   Questa opzione non viene visualizzata nelle opzioni di XCode fino a quando non vengono importati i file swift, quindi assicurarsi di importare prima il codice Swift e poi modificare la configurazione.

4. Importare easyar.xcframework nel progetto EasyARSwift

   

5. Disattivare Bitcode

   EasyAR non utilizza bitcode né fornisce compatibilità con bitcode, assicurarsi di disabilitarlo nella configurazione.

6. Deployment Target

   Modificare deployment target in base al progetto app, garantendo che deployment target del progetto EasyARSwift sia minore o uguale a quello del progetto app.

Incorporare e utilizzare il framework EasyARSwift

1. Incorporare il framework EasyARSwift nel progetto

   

2. import EasyARSwift nel codice sorgente Swift

   

Per esempi di scrittura del codice, fare riferimento al codice nell'esempio HelloARSwift o alla API Reference.