ARCore torna alla conferenza Google I/O del 10 maggio! Registrati ora.

Introduzione a AR Foundation

AR Foundation di Unity è un framework multipiattaforma che ti consente di scrivere esperienze di realtà aumentata una volta per poi eseguire la creazione per dispositivi Android o iOS senza ulteriori modifiche. Il framework è disponibile tramite il pacchetto AR Foundation di Unity.

Il pacchetto facoltativo ARCore Extensions for AR Foundation di ARCore aggiunge ulteriori funzionalità, consentendoti di utilizzare funzionalità quali Cloud Anchor, filtri di configurazione di Fotocamera e le funzionalità di registrazione e riproduzione dell'app.

Eseguire la migrazione o l'upgrade dei progetti esistenti

  • Per eseguire la migrazione di un progetto esistente dall'SDK ARCore (deprecato) per Unity a AR Foundation di Unity e, facoltativamente, alle estensioni ARCore, consulta la guida alla migrazione.
  • Per eseguire l'upgrade di un progetto esistente da una versione precedente di AR Foundation, consulta le guide su upgrade e migrazione di Unity.

Requisiti

A seconda della tua piattaforma di destinazione, il pacchetto AR Foundation richiede quanto segue:

Android

Articoli di ferramenta

  • Un emulatore o un dispositivo Android supportato da ARCore
  • Un cavo USB per collegare il dispositivo alla macchina di sviluppo.

Software

iOS

Articoli di ferramenta

Software

Installa AR Foundation

Segui questi passaggi per installare il pacchetto AR Foundation Unity.

  1. Apri un progetto Unity esistente o creane uno nuovo.

  2. Vai a Window > Package Manager.

  3. Seleziona Unity Registry accanto a Packages.

  4. Nella barra di ricerca, digita "AR Foundation".

  5. Fai clic su Install.

Installa e attiva i pacchetti di plug-in specifici per la piattaforma

Il pacchetto AR Foundation presenta un'interfaccia che gli sviluppatori di Unity possono utilizzare, ma non implementa alcuna funzionalità AR. Per utilizzare AR Foundation su un dispositivo di destinazione, devi anche installare pacchetti separati e attivare il plug-in corrispondente per ogni piattaforma.

Android

Il pacchetto ARCore XR Plugin ti consente di realizzare app di realtà aumentata per dispositivi Android. Segui questi passaggi per installarlo nel tuo progetto Unity se la tua applicazione ha come target i dispositivi Android. Utilizza la stessa versione del pacchetto AR Foundation per evitare problemi di compatibilità.

  1. Nel progetto, vai a Window > Package Manager.

  2. Seleziona Unity Registry accanto a Packages.

  3. Nella barra di ricerca, digita "ARCore XR plugin".

  4. Fai clic su Install.

  5. Vai a Edit > Project Settings. In XR Plug-in Management, apri la scheda Android e attiva ARCore.

iOS

Il plug-in ARKit XR ti consente di realizzare app di realtà aumentata per dispositivi iOS. Segui questi passaggi per installarlo nel tuo progetto Unity se la tua applicazione ha come target i dispositivi iOS. Utilizza la stessa versione del pacchetto AR Foundation per evitare eventuali problemi di compatibilità.

  1. Nel progetto, vai a Window > Package Manager.

  2. Seleziona Unity Registry accanto a Packages.

  3. Nella barra di ricerca, digita "ARKit XR plugin".

  4. Fai clic su Install.

  5. Vai a Edit > Project Settings. In XR Plug-in Management, apri la scheda iOS e attiva ARKit.

Configurare una sessione AR e aggiungere componenti AR Foundation alla scena

Una scena necessita di una sessione AR per abilitare i processi di AR, come il monitoraggio del movimento, la comprensione dell'ambiente e la stima dell'illuminazione. Per supportare una sessione AR sono necessari i seguenti oggetti di gioco:

  • AR Session: controlla il ciclo di vita di un'esperienza AR.

  • AR Session Origin: trasforma le coordinate AR in coordinate mondiali su Unity.

Prima di aggiungere nuovi oggetti del gioco, elimina Main Camera predefinito. Verrà sostituito da un nuovo AR Camera in AR Session Origin.

Aggiungi i nuovi oggetti del gioco AR alla scena: fai clic con il tasto destro del mouse sul riquadro Hierarchy e seleziona XR. Aggiungi un nuovo oggetto di gioco AR Session e un nuovo AR Session Origin.

Configura le impostazioni del player

Android

  1. Vai a File > Build Settings per aprire la finestra Build Settings.
  2. In Platform, scegli Android e fai clic su Switch Platform.
  3. Fai clic su Player Settings.

  4. Applica le seguenti modifiche:

    Player Settings > … Valore
    Other Settings > Rendering Deseleziona Auto Graphics API.
    Se Vulkan è elencato in Graphics APIs, rimuovilo perché Vulkan non è ancora supportato da ARCore.
    Other Settings > Package Name Crea un ID app univoco utilizzando un formato del nome del pacchetto Java.
    Ad esempio, usa com.example.helloAR.
    Other Settings > Minimum API Level Se stai creando un'app AR obbligatoria, specifica Android 7.0 'Nougat' (API Level 24) or higher.
    Se stai creando un'app AR facoltativo, specifica Android API Level 19 or higher.
    Other Settings > Scripting Backend Seleziona IL2CPP anziché Mono per consentire l'attivazione del supporto ARM64 nel passaggio successivo.

    Durante lo sviluppo:

    • Utilizza Mono + 32 bit (ARMv7)
    • Installa un APK ARCore FAT (32 bit + 64 bit)

    Per la spedizione al Play Store:

    • Utilizza IL2CPP
    • Abilita sia le versioni a 32 bit (ARMv7) che quelle a 64 bit (ARM64) per soddisfare i requisiti a 64 bit del Play Store
    • Facoltativo (supporto dal 2018.3 in poi): attiva Build Settings, Android App Bundles
    Other Settings > Target Architectures Per soddisfare il requisito a 64 bit di Google Play, abilita ARM64 (ARM a 64 bit). Lascia ARMv7 (ARM a 32 bit) abilitato per supportare i dispositivi a 32 bit.

iOS

  1. Vai a File > Build Settings per aprire la finestra Build Settings.
  2. In Platform, scegli iOS e fai clic su Switch Platform.
  3. Fai clic su Player Settings.

  4. Configura le seguenti impostazioni:

    Player Settings > … Valore
    Other Settings > Bundle Identifier Aggiungi il nome della tua app in un formato DNS inverso.
    Ad esempio, usa com.mycompany.myapp.
    Other Settings > Camera usage description Inserisci una descrizione per spiegare l'utilizzo dell'AR (ad esempio, ARKit).
    Other Settings > Target minimum iOS version 11.0 o superiore
    Other Settings > Architecture ARM64

Passaggi successivi