Guida rapida alla funzionalità Volti aumentati per iOS

Questa guida illustra come:

• Configura l'ambiente di sviluppo per il funzionamento con i volti aumentati
• Applicare texture 2D e allegare oggetti 3D ai volti rilevati

Prerequisiti

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

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

Utilizzo dei volti aumentati

Nei passaggi seguenti viene utilizzata l'app di esempio Volti aumentati per mostrare le attività fondamentali per la configurazione e la creazione di un'app con le funzionalità dei volti aumentati.

Scarica l'app di esempio Volti aumentati

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 fornito con un Podfile preconfigurato con l'SDK ARCore e le versioni per iOS di cui avrai bisogno. Per installare queste dipendenze:

1. Apri una finestra Terminale ed esegui pod install dalla cartella in cui si trova il progetto Xcode. In questo modo viene generato un file *.xcworkspace che utilizzerai in un secondo momento per creare 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 pacchetto.
3. Premi Cmd+R o fai clic su Esegui. Per lavorare con Volti aumentati, utilizza un dispositivo fisico, non il simulatore. Il dispositivo deve essere collegato al computer di sviluppo tramite USB.

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

Prova l'app di esempio

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

Passaggi successivi

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