Guida introduttiva alle estensioni ARCore per AR Foundation

Il pacchetto facoltativo ARCore Extensions per AR Foundation aggiunge funzionalità al pacchetto AR Foundation di Unity e ti consente di usare funzionalità come ancoraggi Cloud, filtri di configurazione della videocamera e Registrazione e riproduzione nell'app.

Requisiti

Per sviluppare con le estensioni ARCore per AR Foundation, devi disporre di:

Android

Articoli di ferramenta

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

Software

iOS

Articoli di ferramenta

Software

Installa il pacchetto ARCore Extensions

Segui questi passaggi per installare le estensioni ARCore per AR Foundation.

Dipendenze in bundle

  1. Assicurati che AR Foundation sia installato e configurato nel tuo ambiente di sviluppo.
  2. Apri o crea un nuovo progetto Unity.
  3. Seleziona la piattaforma di build di destinazione che ti interessa:
    1. Dal menu File, seleziona Build Settings.
    2. Seleziona Android o iOS, a seconda della piattaforma di destinazione desiderata.
    3. Fai clic su Switch Platform.
  4. Importa il pacchetto di estensioni ARCore più recente:

    1. Vai a Window > Package Manager.
    2. Fai clic sul pulsante e scegli l'opzione Add package from git URL... dal menu a discesa.

    3. Incolla il seguente URL nel campo di testo:

      https://github.com/google-ar/arcore-unity-extensions.git
      
    4. Fai clic su Add.

Senza EDM4U

Per impostazione predefinita, le estensioni ARCore sono abbinate a dipendenze aggiuntive. Quando utilizzi altre librerie (ad esempio Firebase Analytics) che dipendono da una versione diversa di External Dependency Manager for Unity, potrebbe verificarsi un comportamento non definito, causando il corretto funzionamento dei dipendenti.

Installa le estensioni ARCore senza dipendenze in bundle per evitare conflitti di controllo delle versioni delle librerie:

  1. Scarica le estensioni ARCore senza release EDM4U e com.google.external-dependency-manager,
  2. Segui le istruzioni sull'importazione dei pacchetti UPM con file .tgz e installa i pacchetti nel seguente ordine:
    1. com.google.external-dependency-manager,
    2. Estensioni ARCore (senza EDM4U).

Durante l'installazione di ARCore Extensions, Unity installerà automaticamente anche una versione adatta delle dipendenze richieste:

  • AR Foundation
  • ARCore XR Plugin (utilizzato per il targeting di Android)
  • ARKit XR Plugin (utilizzato per il targeting di iOS)

Queste dipendenze potrebbero non essere visibili nella visualizzazione Package Manager > Package: In project. Tuttavia, i pacchetti possono essere visualizzati nella finestra Project in Packages

Configura le estensioni ARCore

AR Foundation 4.x

  1. Nel riquadro Hierarchy, fai clic con il tasto destro del mouse e aggiungi i seguenti oggetti di gioco (se non sono già stati aggiunti):

    • XR > AR Session
    • XR > AR Session Origin
    • XR > ARCore Extensions
  2. Nel riquadro Hierarchy, seleziona il pacchetto ARCore Extensions.

  3. Nel riquadro Inspector, fai clic sul pulsante di destinazione per ognuno dei seguenti campi e collega ogni campo all'oggetto di gioco corrispondente, come indicato di seguito:

    • Session: Usa il AR Session della scena.
    • AR Session Origin: Usa il AR Session Origin della scena.
    • Camera Manager: Usa il AR Camera della scena.
  4. Se vuoi, crea e collega i seguenti asset per Cloud anchor e filtri di configurazione della videocamera.

    1. Nel riquadro Project > Assets, fai clic con il tasto destro del mouse e seleziona Create > XR > ARCore Extensions Config.

    2. Nel riquadro Project > Assets, fai clic con il tasto destro del mouse e seleziona Create > XR > Camera Config Filter.

    3. Nel riquadro Hierarchy, seleziona il pacchetto ARCore Extensions.

    4. Nel campo ARCore Extensions Config del riquadro Inspector, fai clic sul pulsante di destinazione e connettiti all'asset ARCoreExtensionsConfig.

    5. Nel campo Camera Config Filter del riquadro Inspector, fai clic sul pulsante di destinazione e connettiti all'asset ARCoreExtensionsCameraConfigFilter.

      Per saperne di più, consulta la Guida per gli sviluppatori di Cloud Anchors e la guida alla configurazione della videocamera.

    6. Se utilizzi una versione di Unity precedente alla 2020.3:

      • Seleziona Modello di proprietà personalizzate Gradle in Impostazioni progetto > Player > Android > Impostazioni di pubblicazione > Build.

Con tutti i campi delle estensioni ARCore precedenti collegati correttamente, il riquadro Inspector delle estensioni ARCore ha il seguente aspetto:

AR Foundation 5.x

  1. Nel riquadro Hierarchy, fai clic con il tasto destro del mouse e aggiungi i seguenti oggetti di gioco (se non sono già stati aggiunti):

    • XR > AR Session
    • XR > XR Origin (Mobile AR)
    • XR > ARCore Extensions
  2. Nel riquadro Hierarchy, seleziona il pacchetto ARCore Extensions.

  3. Nel riquadro Inspector, fai clic sul pulsante di destinazione per ognuno dei seguenti campi e collega ogni campo all'oggetto di gioco corrispondente, come indicato di seguito:

    • Session: Usa il AR Session della scena.
    • XR Origin: Usa il XR Origin della scena.
    • Camera Manager: Usa il AR Camera della scena.
  4. Se vuoi, crea e collega i seguenti asset per Cloud anchor e filtri di configurazione della videocamera.

    1. Nel riquadro Project > Assets, fai clic con il tasto destro del mouse e seleziona Create > XR > ARCore Extensions Config.

    2. Nel riquadro Project > Assets, fai clic con il tasto destro del mouse e seleziona Create > XR > Camera Config Filter.

    3. Nel riquadro Hierarchy, seleziona il pacchetto ARCore Extensions.

    4. Nel campo ARCore Extensions Config del riquadro Inspector, fai clic sul pulsante di destinazione e connettiti all'asset ARCoreExtensionsConfig.

    5. Nel campo Camera Config Filter del riquadro Inspector, fai clic sul pulsante di destinazione e connettiti all'asset ARCoreExtensionsCameraConfigFilter.

      Per saperne di più, consulta la Guida per gli sviluppatori di Cloud Anchors e la guida alla configurazione della videocamera.

    6. Se utilizzi una versione di Unity precedente alla 2020.3:

      • Seleziona Modello di proprietà personalizzate Gradle in Impostazioni progetto > Player > Android > Impostazioni di pubblicazione > Build.

Con tutti i campi delle estensioni ARCore precedenti collegati correttamente, il riquadro Inspector delle estensioni ARCore ha il seguente aspetto:

Per ulteriori informazioni sulla configurazione delle proprietà, consulta la guida di Unity sulla modifica delle proprietà.

Esempi di progetti

Il bundle delle estensioni ARCore per AR Foundation offre progetti di esempio che puoi utilizzare per iniziare a creare i tuoi progetti.

  1. Dal menu Window, apri Package Manager e seleziona il pacchetto ARCore Extensions.

  2. In Samples, fai clic su Import per il progetto di esempio descritto di seguito.

I seguenti progetti di esempio vengono importati dal repository GitHub:

  • Geospaziale (solo Android): crea esperienze AR su scala globale e allega contenuti da remoto a qualsiasi area coperta da Google Street View. Per ulteriori informazioni, consulta l'introduzione all'API Geospaziale.

  • PersistentCloudAnchors (Android e iOS). Crea esperienze AR persistenti nel mondo reale con livelli interattivi di informazioni digitali ancorati a luoghi reali ed esperienze di progettazione che possono essere condivise nel tempo da più persone su molti dispositivi diversi. Per saperne di più, consulta l'introduzione agli ancoraggi Cloud.

Passaggi successivi

Con le estensioni ARCore per AR Foundation, ora puoi utilizzare ancoraggi Cloud e configurazioni della fotocamera nelle tue app.