Guida rapida allo sviluppo EasyAR Unity con esempi

Questo tutorial spiega come configurare ed eseguire gli esempi Unity di EasyAR per iniziare rapidamente con lo sviluppo AR.

Preparare un progetto Unity vuoto

Assicurati di avere installata una versione compatibile di Unity (Unity 2021.3 o successiva). Si consiglia di utilizzare l'ultima versione di Unity 2022.3 o Unity 6.3.

Crea un progetto Unity vuoto utilizzando il template 3D (Built-in Render Pipeline):

Nota

Non è consigliabile utilizzare URP per i primi utilizzi.

Se stai utilizzando Unity 6, devi scaricare manualmente e utilizzare 3D (Built-In Render Pipeline) Template. Nelle installazioni predefinite, si trova in una posizione più in basso nell'elenco dei template.

Importante

Per utilizzare URP, è necessario eseguire una configurazione aggiuntiva seguendo Universal Render Pipeline (URP), altrimenti il feed della fotocamera non verrà visualizzato.

Importa easyar sense unity plugin

• Scarica il pacchetto del plugin
  • Scarica l'ultima versione di EasyAR Sense Unity Plugin, che include esempi (sample).
  • Dopo aver decomresso il pacchetto zip, vedrai un file readme e file .tgz. I file .tgz possono essere importati direttamente in Unity, non decomprimerli.
  • Posiziona il file .tgz nella cartella Packages del progetto Unity.
• Importa il pacchetto del plugin
  • Dalla barra dei menu, seleziona in sequenza Window e poi Package Manager.
  • Nella finestra che appare, clicca sul segno + in alto a sinistra e scegli Install Package from tarball ....
  • Nella finestra di dialogo, seleziona il file .tgz menzionato prima.

[!NOTA]
Il file .tgz non può essere cancellato o spostato dopo l'importazione in Unity. Assicurati di posizionarlo in una posizione appropriata prima dell'importazione. Si consiglia di conservarlo nella cartella Packages del progetto Unity per facilitare la gestione delle versioni.

Importare esempi

Apri Package Manager tramite il menu Window > Package Manager, seleziona EasyAR Sense Unity Plugin, e sul lato destro scegli **All Samples** per importare tutti gli esempi in una volta.

Attenzione

**All Samples** e altri esempi non possono essere importati contemporaneamente, altrimenti si verificheranno asset duplicati con conseguente perdita di alcune risorse sceniche. Se si importano accidentalmente file duplicati, eliminarli e reimportare.

Modifica lista scene

Apri Build Settings (o Build Profiles),

Aggiungi le scene di esempio del progetto Unity alla Scene List in Build Settings o Build Profiles, e sposta la scena del launcher di esempio (AllSamplesLauncher) come prima tra tutte le scene.

Attenzione

Attenzione a non aggiungere queste scene per visori, altrimenti la build potrebbe fallire:

• Combination_BasedOn_AppleVisionPro.rst
• Combination_BasedOn_Xreal.rst

Compilare la licenza (License Key)

Dal menu Unity seleziona EasyAR > Sense > Configuration per aprire l'interfaccia delle impostazioni di EasyAR Sense.

Nel campo di testo sotto EasyAR Sense License, inserisci la EasyAR Sense License.

Consiglio

La EasyAR Sense License può essere creata dal Centro di Sviluppo EasyAR (中文, 英文). Per i nuovi utenti, è possibile crearla seguendo questi passaggi:

• Crea EasyAR Sense 4.x Personal Edition
• Seleziona Sì per Sparse Spatial Map, il nome può essere arbitrario
• Il nome dell'applicazione può essere arbitrario, per Bundle ID e Package Name compila com.mycompany.myproject
• Seleziona la licenza appena creata, accedi e clicca sul pulsante di copia a destra

Nota

Bundle ID e Package Name possono essere modificati successivamente, ma il numero di modifiche è limitato. Se hai un nome di pacchetto applicativo definito, puoi inserire il tuo.

La creazione dell'edizione personale non ha limiti di quantità, altri tipi possono essere creati secondo necessità durante l'uso effettivo.

Esecuzione nell'editor

Per eseguire nell'editor è necessario che sul computer sia connessa una camera.

Verificare che la fotocamera del sistema funzioni correttamente

Aprire l'app fotocamera del sistema:

Verificare che la fotocamera possa funzionare normalmente:

Infine, assicurarsi di chiudere l'app fotocamera per evitare conflitti durante l'esecuzione degli esempi.

Nota

EasyAR utilizza solo le interfacce fornite dal sistema per aprire la fotocamera. È necessario assicurarsi che l'app fotocamera del sistema possa aprire la fotocamera e visualizzare correttamente l'immagine.

Esempio di esecuzione

Il contenuto seguente utilizza l'esempio di image tracking ImageTracking_Targets. Altri esempi seguono procedure simili.

Apri la scena del launcher degli esempi e clicca il pulsante Play in alto nell'editor di Unity.

Accedi alla scena ImageTracking_Targets.

Consiglio

Puoi anche aprire direttamente la scena ImageTracking_Targets ed eseguirla.

Punta la fotocamera verso questa immagine di riconoscimento:

Link per il download: 🔗 namecard

EasyAR riconoscerà e traccerà questa immagine, sovrapponendo oggetti virtuali.

Nota

Alcune funzioni non possono essere testate nell'editor con la fotocamera, ma funzionano su dispositivi mobili. Gli esempi non supportati nell'editor mostreranno un popup di errore all'avvio.

Appariranno anche messaggi di notifica e log di errore.

Esecuzione su telefono

Per eseguire su telefono è necessario creare un pacchetto. Prima della creazione del pacchetto, è necessario modificare la configurazione del Player.

Modificare le impostazioni del Player

• Android
• iOS

Nel menu Unity File > Build Settings > Player Settings, clicca sull'icona di Android per accedere alle impostazioni della piattaforma Android.

• Modifica Package Name in quello visualizzato nella pagina della License Key

  

  Consiglio

  Ad esempio, se il Package Name inserito durante la creazione della License Key era com.mycompany.myproject, qui deve essere com.mycompany.myproject, altrimenti non funzionerà.

• Modifica Minimum API Level in API Level 21 o superiore

  

• Modifica Scripting Backend in IL2CPP e seleziona ARM64 in Target Architecture

  

Creazione dell'applicazione

Seleziona File > Build Settings, scegli la piattaforma di destinazione (Android/iOS), quindi seleziona switch platform.

Seleziona Build o Build And Run per compilare il progetto e installarlo sul telefono. Durante l'esecuzione, concedere le autorizzazioni necessarie.

Esempio di esecuzione

I seguenti contenuti prendono come esempio il tracciamento d'immagine ImageTracking_Targets. L'esecuzione di altri esempi è simile.

Dopo l'avvio, verrà caricata la scena del launcher degli esempi.

Consiglio

Se non si entra nella scena del launcher degli esempi all'apertura, verificare di aver configurato correttamente la lista delle scene in Build Settings o Build Profiles, spostando AllSamplesLauncher al primo posto.

Entrare nella scena ImageTracking_Targets.

Puntare la fotocamera del telefono verso l'immagine di riconoscimento:

Link download: 🔗 namecard

EasyAR riconoscerà e traccerà questa immagine, sovrapponendo oggetti virtuali.

Prossimi passi

Avete eseguito con successo l'esempio AR di Unity e potreste essere curiosi di come sia stata creata la scena AR mostrata nell'esempio. Potete leggere le seguenti guide introduttive in ordine:

• Abilitare EasyAR
• Configurare la scena AR
• Diagnostica nella scena

Per quanto riguarda il launcher degli esempi, potete fare riferimento alle istruzioni dettagliate:

• Istruzioni per l'uso del launcher di esempio

Se desiderate comprendere la configurazione completa del progetto, potete consultare:

• Utilizzare Universal Render Pipeline (URP)
• Configurazione player
• Configurazione EasyAR

Se volete approfondire l'utilizzo di EasyAR, potete iniziare da qui:

• Basi delle app Unity basate su AR