Guida rapida alla funzionalità Volti aumentati per iOS

Questa guida spiega come:

• Configura l'ambiente di sviluppo per utilizzare i volti aumentati
• Applicare texture 2D e collegare oggetti 3D alle facce rilevate

Prerequisiti

• Xcode 13.0 o versioni successive
• Cocoapods 1.4.0 o versione successiva se utilizzi Cocoapods
• Un dispositivo Apple compatibile con ARKit con iOS 12.0 o versioni successive (è richiesta la destinazione del deployment di iOS 12.0 o versioni successive)

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

Utilizzo di volti aumentati

Nei passaggi successivi viene usata l'app di esempio di Volti aumentati per mostrarti le attività fondamentali per configurare e creare un'app con le funzionalità di volti aumentati.

Scarica l'app di esempio Augmented Faces

1. Clona o scarica l'ARCore SDK per iOS più recente da GitHub per ottenere il codice dell'app di esempio.
2. Apri una finestra Terminale o 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 podfile preconfigurato con l'SDK ARCore e le versioni iOS necessarie. Per installare queste dipendenze:

1. Apri una finestra Terminale ed esegui pod install dalla cartella in cui si trova il progetto Xcode. Viene generato un file *.xcworkspace che utilizzerai in seguito 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 i volti aumentati, usa un dispositivo fisico, non il simulatore. Il dispositivo deve essere collegato alla macchina di sviluppo tramite USB.

Nota: poiché il simulatore non dispone di 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 tuo dispositivo.
2. Se richiesto, concedi le autorizzazioni di accesso alla fotocamera all'app. ARCore inizia quindi a rilevare i volti visibili nella fotocamera. Al momento, 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 scoprire di più sull'utilizzo dei volti aumentati nelle tue app.
• Consulta la documentazione di riferimento dell'API ARCore iOS.
• Guarda il seguente video su come iniziare a usare i volti aumentati su iOS: