Guida rapida alla funzionalità Volti aumentati per iOS

Questa guida illustra come:

• Configura l'ambiente di sviluppo per lavorare con Augmented Faces
• Applicare texture 2D e attaccare oggetti 3D ai volti rilevati

Prerequisiti

• Xcode versione 13.0 o successive
• Cocoapods 1.4.0 o versioni successive se utilizzi Cocoapods
• Un dispositivo Apple compatibile con ARKit con iOS 12.0 o versioni successive (è necessario un target di deployment di iOS 12.0 o versioni successive)

Nota: a partire da ARCore 1.12, sono supportati tutti i dispositivi compatibili con ARKit.

Utilizzare Volti aumentati

I passaggi che seguono utilizzano l'app di esempio Augmented Faces per mostrare le attività fondamentali per configurare e creare un'app con funzionalità di Augmented Faces.

Scarica l'app di esempio Augmented Faces

1. Clona o scarica l'SDK ARCore per iOS più recente da GitHub per ottenere il codice dell'app di esempio.
2. Apri una finestra del terminale o del Finder e vai alla cartella in cui hai clonato o scaricato l'SDK.
3. Puoi trovare il codice dell'app di esempio in /Examples/AugmentedFacesExample.

Esegui pod install

L'app AugmentedFacesSample viene fornita con un file Podfile preconfigurato con le versioni dell'SDK ARCore e di iOS di cui hai bisogno. Per installare queste dipendenze:

1. Apri una finestra del terminale ed esegui pod install dalla cartella in cui si trova il progetto Xcode. Viene generato un file *.xcworkspace che utilizzerai in seguito per compilare ed eseguire l'app.

Crea ed esegui l'app

1. Apri il file .xcworkspace (non .xcodeproj) del progetto in Xcode.
2. Apri le impostazioni generali del target e modifica l'identificatore del bundle.
3. Premi Cmd+R o fai clic su Esegui. Utilizza un dispositivo fisico, non il simulatore, per lavorare con Volti aumentati. Il dispositivo deve essere collegato alla macchina di sviluppo tramite USB.

Nota: poiché il simulatore non ha una fotocamera, le app che utilizzano la funzionalità Volti aumentati devono essere eseguite su un dispositivo fisico.

Prova l'app di esempio

1. Compila ed esegui l'app di esempio dal file .xcworkspace per avviarla sul tuo dispositivo.
2. Se richiesto, concedi all'app le autorizzazioni di accesso alla fotocamera. ARCore inizia quindi a rilevare i volti visibili nella fotocamera. Al momento viene rilevato un solo volto alla volta.
3. Assicurati che la videocamera sia rivolta verso l'utente.

Passaggi successivi

• Consulta la Guida per gli sviluppatori di Augmented Faces per iOS per esplorare il codice dell'app di esempio e scoprire di più sull'utilizzo di Augmented Faces nelle tue app.
• Consulta il riferimento all'API ARCore per iOS.
• Guarda il seguente video su come iniziare a utilizzare Volti aumentati su iOS: