Usa gli esempi per iniziare rapidamente con lo sviluppo EasyAR Mega Unity

Questa documentazione spiega come configurare ed eseguire gli esempi di EasyAR Mega Unity per iniziare rapidamente con lo sviluppo EasyAR Mega.

Prima di iniziare

Prima di leggere questa guida, assicurati di aver completato:

• Aver creato una libreria di localizzazione cloud valida.
• Avere Unity installato (versione 2021.3.30 LTS o successiva), si consiglia di utilizzare l'ultima versione di Unity 2022.3 o Unity 6.3.
• Aver importato i pacchetti com.easyar.sense-**.tgz e com.easyar.mega-**.tgz seguendo il metodo descritto in Abilita Mega.

Esempio di utilizzo (sei passaggi)

Di seguito, in sei passaggi, viene illustrato come configurare ed eseguire l'esempio principale di EasyAR Mega, MegaBlock_Basic.

Passo 1: Importa campione

Nota

Se tutti i campioni sono stati importati tramite **All Samples**, salta questo passaggio.

1. Usa il menu Window > Package Manager per aprire Gestione pacchetti, seleziona EasyAR Sense Unity Plugin, espandi tutti i campioni nel pannello Samples a destra.
2. Seleziona un campione (ad esempio MegaBlock_Basic), fai clic su Import.

Nota

• Questo tutorial non è direttamente applicabile ai dispositivi head-mounted, ma prima di sviluppare per questi dispositivi, è necessario comprendere il flusso di lavoro attraverso lo sviluppo su smartphone.
• Se hai precedentemente importato campioni di una versione precedente dell'SDK, dopo l'aggiornamento dell'SDK, elimina prima i vecchi campioni e reimportali.

Secondo passo: inserire la License Key e configurare il servizio di localizzazione cloud Mega

1. Nella barra dei menu selezionare EasyAR > Sense > Configuration;
   
2. Incollare la propria License Key nel pannello Project Settings che si apre;
   

Consiglio

La License di EasyAR Sense può essere creata dal Centro di sviluppo EasyAR. Per la prima creazione, seguire questi passaggi:

• Creare EasyAR Sense 4.x Personal Edition
• Selezionare No per "Sparse spatial map"
• Compilare un nome applicazione arbitrario, inserire com.mycompany.myproject in "Bundle ID" e "Package Name"
• Selezionare la licenza appena creata e cliccare sul pulsante di copia a destra

Nota

"Bundle ID" e "Package Name" possono essere modificati successivamente, ma con limitazioni. Se si dispone già di un nome pacchetto applicativo definito, è possibile utilizzarlo.

La creazione di edizioni personali non ha limiti di quantità; altri tipi possono essere creati secondo necessità.

3. Configurare le informazioni della propria libreria di localizzazione cloud Mega nella sezione Mega Block del pannello Project Settings;
   

Consiglio

La configurazione della libreria di localizzazione cloud Mega è disponibile nel Centro di sviluppo EasyAR.

Verificare che la propria API Key abbia i permessi per Mega Block. In caso contrario, modificarla o crearne una nuova.

Passo tre: Posizionare i contenuti 3D

1. Fare clic con il tasto destro in uno spazio vuoto nel pannello Hierarchy, aggiungere lo strumento di visualizzazione dei blocchi (sviluppo Unity);
   

2. Accedere al servizio di localizzazione Mega;

   1. Selezionare il nodo EasyAR.Mega.BlockViewer (Dev), nel pannello Inspector inserire le informazioni dell'account EasyAR e accedere;
      
   2. Fare clic sul pulsante a destra di Mega Cloud Service;
      
   3. Selezionare il Servizio di localizzazione Mega che si desidera utilizzare, fare clic su OK.
      

3. Caricare un Block

   Dopo aver selezionato il servizio, l'elenco dei blocchi nella libreria corrente verrà visualizzato sotto il nodo MegaBlocks e mostrato nel pannello degli strumenti. Fare clic su Carica per caricare il blocco selezionato:
   

   Una volta completato il caricamento, il Block verrà visualizzato nella finestra Scene. È possibile interagire nella finestra Scene per regolare l'angolazione di visualizzazione e la posizione. Verificare anche se il file Block è utilizzabile (ad esempio, se il sistema di coordinate del Block è normale, se esiste stratificazione, se è troppo sfocato o presenta difetti che impediscono il posizionamento delle risorse AR, ecc.).
   

4. Posizionare i contenuti 3D

   A questo punto, è possibile posizionare oggetti 3D facendo riferimento al Block.
   

   Nota

   • Gli oggetti 3D devono essere posizionati sotto il nodo MegaBlocks > Block_* generato automaticamente dallo strumento, per garantire che la posizione di rendering dei contenuti virtuali sia corretta durante l'esecuzione.
   • Non modificare il nome del nodo Block_* o il suo local transform, poiché è gestito automaticamente dallo strumento.

Passo quattro: configurare MegaTracker

1. Configurare Block Root;

   Espandi AR Session, seleziona Mega Block Tracker e imposta Block Root sul nodo MegaBlocks generato dallo strumento.
   

Quinto passo: modifica configurazione player

• Android
• iOS

Segui nel menu Unity File > Build Settings > Player Settings, clicca sull'icona Android per aprire le impostazioni specifiche per la piattaforma Android.

• Modifica Package Name con il Package Name visualizzato nella pagina License Key

  

  Consiglio

  Ad esempio, se il Package Name inserito durante la creazione della License Key era com.mycompany.myproject, devi inserire qui Package Name come com.mycompany.myproject, altrimenti l'esecuzione fallirà.

• Modifica Minimum API Level in API Level 21 o versione successiva

  

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

  

Sesto passo: costruisci ed esegui

1. Aggiungi la scena corrente a File > Build Settings o Build Profiles > Scene List;
2. Passa alla piattaforma di destinazione (es. Android/iOS), verifica che il nome del pacchetto (Bundle ID) e la License Key corrispondano;
   
3. Clicca Build and Run.
   

Risultato operativo ripreso dal vivo:

Sui testi gialli sullo schermo

Durante l'esecuzione, potresti vedere due tipi di testo giallo visualizzati sullo schermo.

1. Messaggio di avviso per la modalità simulazione

   Si trova nella parte inferiore dello schermo:

   

   Questo avviso appare perché, con la configurazione predefinita, l'applicazione può essere eseguita senza essere sul posto. Ha un leggero impatto sulle prestazioni dell'app. Se stai effettivamente utilizzando l'app sul luogo, puoi modificare la configurazione di MegaTracker prima della compilazione.

2. Informazioni diagnostiche

   Si trovano nella parte superiore dello schermo e sono utili per comprendere lo stato della sessione e identificare problemi. Si consiglia di mantenerle visibili durante le fasi di sviluppo e test:

   

   Puoi fare riferimento alle informazioni diagnostiche nella scena per capire rapidamente come configurare e utilizzare queste informazioni diagnostiche.

Prossimi passi: da principiante a esperto

Congratulazioni! Seguendo i passaggi precedenti, hai eseguito con successo gli esempi principali di EasyAR Mega in soli 10 minuti, sperimentando personalmente il fascino della localizzazione spaziale e della sovrapposizione di contenuti AR.

Ora hai padroneggiato le basi. Se desideri:

• Costruire applicazioni AR più stabili ed efficienti
• Implementare effetti complessi come l'occlusione realtà-virtuale e l'allineamento dei contenuti
• Effettuare debug quando non disponi di dispositivi o non puoi recarti sul posto

Fai riferimento alle seguenti guide approfondite. Ti aiuteranno a risolvere i problemi pratici durante lo sviluppo.

Sviluppo avanzato

Se desideri conoscere la configurazione completa del progetto, puoi fare riferimento ai seguenti contenuti:

• Utilizzo di Universal Render Pipeline (URP)
• Configurazione player
• Configurazione EasyAR

Se desideri approfondire l'utilizzo di EasyAR, puoi iniziare da qui:

• Fondamenti di applicazioni Unity basate su AR

Allo stesso tempo, si consiglia la lettura dei seguenti contenuti per supportare lo sviluppo e il debug:

• Diagnostica e segnalazione dei problemi nello sviluppo Unity
• Simulazione AR in Unity

Controllo avanzato delle funzionalità Mega

I seguenti contenuti ti aiuteranno a utilizzare Mega nella tua applicazione:

• Utilizzo in loco e simulazione
• Best practice per ARSession
• Aggiunta di target di tracciamento
• Creazione di contenuti 3D allineati al mondo reale
• Occlusione ambientale (Occlusion)
• Controllo del processo di tracciamento

I seguenti contenuti ti aiuteranno a verificare le funzionalità Mega senza raggiungere il sito:

• Verifica rapida con fotocamera PC
• Simulazione con lo strumento di verifica Session

Argomenti avanzati

I seguenti contenuti sono più adatti dopo aver acquisito una certa esperienza con EasyAR.

Se desideri eseguire EasyAR Mega su un visore, puoi fare riferimento a:

• Supporto per visori in EasyAR con Unity
• Utilizzare gli esempi di EasyAR su visori XR o occhiali AR

Se desideri utilizzare AR Foundation, puoi iniziare da qui:

• Supporto di EasyAR per il framework XR di Unity