Usare allsampleslauncher per provare rapidamente gli esempi di easyar

AllSamplesLauncher è un launcher di esempi integrato che ti aiuta a familiarizzare rapidamente con tutte le funzionalità di EasyAR SDK. Attraverso questo launcher, puoi passare con un clic ed eseguire tutte le scene di esempio ufficiali in un singolo progetto Unity, senza dover configurare manualmente più progetti separati.

Preparativi

Prima di iniziare, assicurati di aver completato i seguenti preparativi:

1. Aver installato Unity Hub e l'editor Unity
2. Creare un nuovo progetto Unity
3. Aver importato EasyAR Sense Unity Plugin e aver importato tutti i Samples

Fai riferimento alle istruzioni passo-passo in Guida introduttiva.

Passaggi dettagliati

1. Apri tutte le scene in Samples.
   
2. Clicca sulla barra dei menu File > Build Settings o Build Profiles > Scene List.
3. Trascina tutte le scene in Scene List.
4. Assicurati che AllSamplesLauncher sia il primo in tutte le scene. Se non lo è, puoi trascinarlo all'interno della finestra.
   
5. Clicca sulla barra dei menu File > Build And Run per creare il pacchetto ed eseguire.

Nota

Quando crei il pacchetto per eseguirlo su telefono, non aggiungere scene relative ai visori:

• Combination_BasedOn_AppleVisionPro
• Combination_BasedOn_Xreal
  

Problemi durante la creazione del pacchetto

Durante la compilazione e la creazione del pacchetto, potresti incontrare alcuni errori. Problemi comuni includono:

Messaggio di errore	Causa	Soluzione
FileNotFoundException:EasyAR Settings Asset	License non compilata	Clicca sulla barra dei menu EasyAR > Sense > Configuration e inserisci la tua License Key in EasyAR Sense License
Missing Prefab Asset: 'XR Interaction Setup'	File mancanti relativi ai visori	Elimina le scene relative ai visori dall'elenco delle scene del pacchetto. Se sei sicuro di dover creare il pacchetto per un visore, segui i passaggi in Usare gli esempi per visori

Utilizzo del launcher

Dopo l'esecuzione, vedrai un'interfaccia del launcher pulita.

Clicca sul pulsante Samples al centro in basso nell'interfaccia per accedere a tutti gli esempi di funzionalità.

Sul lato sinistro dell'interfaccia ci sono le categorie di funzionalità, a destra l'elenco delle scene di esempio per ogni funzionalità. Cliccando su diverse scene di esempio, puoi provare tutte le diverse funzionalità offerte da EasyAR.

Inoltre, in fondo all'interfaccia sono disponibili video dimostrativi delle funzionalità di EasyAR Sense ed EasyAR Mega, che ti aiutano a comprendere meglio le funzionalità e gli effetti che EasyAR può offrirti.

Cose essenziali da leggere prima di eseguire gli esempi

Prima di eseguire esempi specifici, dovete assolutamente completare le seguenti configurazioni chiave, altrimenti l'esempio non funzionerà correttamente:

1. Imposta la tua API Key

   • Alcuni esempi (specialmente quelli che coinvolgono riconoscimento cloud, geolocalizzazione Mega cloud, ecc.) richiedono una API Key valida.
   • Nella barra dei menu EasyAR > Sense > Configuration, trova i campi da compilare richiesti dall'esempio specifico.
   • Inserisci l'App ID, la API Key e la API Secret ottenuti dal centro sviluppatori EasyAR.
     
   • Importante: se non disponi ancora di una API Key, alcuni esempi di funzionalità locali (come il tracciamento delle immagini) potrebbero comunque funzionare, ma le funzionalità cloud falliranno. Assicurati di visitare il Centro sviluppatori EasyAR per creare un'applicazione e ottenere le Key.

2. Configura il supporto XR/piattaforma:

   • Se esegui esempi relativi ai visori, fai riferimento alle istruzioni in Usare gli esempi per visori.
   • Assicurati che il tuo dispositivo (come telefono o visore) sia correttamente connesso e in modalità sviluppatore.

Esplorare approfonditamente gli esempi

Il launcher di esempi è il punto di partenza migliore per il tuo apprendimento. Ti consigliamo vivamente di:

• Prima eseguire, poi studiare: attraverso il launcher, prova rapidamente l'effetto di ogni esempio per acquisire una comprensione intuitiva delle capacità di EasyAR.
• Aprire i file sorgente delle scene: ogni esempio è un file di scena Unity indipendente, situato nella directory Assets/Samples/EasyAR Sense Unity Plugin/[versione]/__All Samples__/[nome funzionalità]/[nome esempio]/Scenes.
• Studiare e leggere il codice degli script: nelle scene di esempio, puoi aprire gli script *.cs allegati all'esempio per vedere come abbiamo chiamato le API di EasyAR per implementare funzionalità specifiche. Questo è il modo migliore per apprendere come utilizzare le API.

Attraverso il launcher di esempi, puoi acquisire rapidamente familiarità con le funzionalità di EasyAR SDK. Buona esplorazione!