Abilitare le funzioni EasyAR in un'app iOS

Questo capitolo descrive come configurare un progetto iOS EasyAR in Xcode senza usare un motore 3D come Unity.

Preparazione

Prima di iniziare, preparare:

• Xcode 16 o versione successiva

• Ottenere una licenza EasyAR

• Selezionare una release version di EasyAR Sense e scaricarla

Abilitare EasyAR con Objective-C

1. Aggiungere Frameworks

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

   

2. Disabilitare Bitcode

   EasyAR non usa bitcode e non fornisce compatibilità bitcode, quindi bitcode deve essere disabilitato nella configurazione.

   

3. Inizializzare EasyAR

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

   [easyar_Engine initialize:key];
   

4. Configurazione privacy

   Poiché AR deve usare la camera, aggiungere Privacy - Camera Usage Description alla configurazione privacy.

   

   Se si vuole usare la funzione di registrazione schermo, aggiungere Privacy - Microphone Usage Description alla configurazione privacy.

   

Abilitare EasyAR tramite Swift API

EasyAR Sense Swift API è fornita sotto forma di codice sorgente, così da offrire la migliore compatibilità (Apple fornisce compatibilità ABI da Swift 5).

Per usare EasyAR Sense Swift API, creare prima un progetto framework e poi incorporare il framework target nel proprio progetto.

Creare un progetto framework EasyARSwift

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

   È possibile scegliere di incorporare il progetto EasyARSwift nel proprio progetto app o creare un progetto indipendente.

   

2. Importare il codice EasyAR Swift nel progetto EasyARSwift

   

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

3. Configurare Objective-C Bridging Header nei build settings

   

   Nota

   Questa opzione non comparirà nelle opzioni XCode prima di importare i file Swift, quindi assicurarsi di importare prima il codice Swift e poi modificare questa configurazione.

4. Importare easyar.xcframework nel progetto EasyARSwift

   

5. Disattivare Bitcode

   EasyAR non usa bitcode e non fornisce compatibilità bitcode, quindi assicurarsi che bitcode sia disabilitato nella configurazione.

6. Deployment Target

   Modificare deployment target secondo il proprio progetto app e assicurarsi che il deployment target del progetto EasyARSwift sia minore o uguale a quello del progetto app.

Incorporare e usare il framework EasyARSwift

1. Incorporare il framework EasyARSwift nel progetto

   

2. Nel codice sorgente Swift, import EasyARSwift

   

Per lo stile di scrittura del codice, fare riferimento al codice nell'esempio HelloARSwift o ad API Reference.