Creare e caricare annotazioni con l'editor di Unity
Questo articolo spiega come creare e caricare annotazioni utilizzando Mega Studio sull'editor di Unity.
Prima di iniziare
Essere in grado di usare Mega Studio in Unity
Preparare il modello: utilizzare il modello presente nel progetto di esempio (un panda adorabile), oppure utilizzare il modello di robot usato nella demo ufficiale di xr-frame, oppure fare riferimento alle specifiche GLTF supportate da XRFrame per preparare un file modello conforme ai requisiti di xr-frame.
Importare i file del modello in Unity.
Consiglio
Il plugin Mega ha già aggiunto una dipendenza da com.unity.cloud.gltfast, quindi è possibile trascinare direttamente i file modello in Unity Assets.
Perché sono necessarie le annotazioni
EasyAR Mega Annotation (EMA) può essere utilizzata per sincronizzare le posizioni spaziali tra piattaforme (con definizioni di sistemi di coordinate diverse).
Sistema di coordinate locale dell'annotazione in Unity: l'asse X positivo punta indietro, l'asse Y positivo verso l'alto, l'asse Z positivo a destra.
Sistema di coordinate locale dell'annotazione in xr-frame: l'asse X positivo punta indietro, l'asse Y positivo verso l'alto, l'asse Z positivo a sinistra.
Queste differenze di direzione derivano dai diversi sistemi di coordinate (destrorso/sinistrorso) utilizzati da Unity e xr-frame.
L'utilizzo di EMA per sincronizzare le posizioni spaziali offre questi importanti vantaggi:
- Semplifica lo sviluppo: gestisce automaticamente la conversione delle coordinate multipiattaforma, evitando la logica complessa e soggetta a errori dei calcoli manuali.
- Migliora l'efficienza del debug: consente il caricamento diretto su MegaToolbox, facilitando test rapidi su dispositivo reale e verifica dei dati.
Procedura
Creare lo strumento di annotazione
Nel pannello Hierarchy di Unity, fare clic destro e selezionare: EasyAR Mega > Tool > Annotation Tool (Edit Mode).
Dopo la creazione, nella scena verranno generati i nodi EasyAR.Mega.Annotation e MegaBlocks.
Selezionando il nodo EasyAR.Mega.Annotation, nel pannello Inspector appariranno i campi per inserire nome utente/email e password.
Accedere all'account
Inserire le credenziali dell'account EasyAR e fare clic su Login. Se l'accesso è riuscito, nel pannello Inspector apparirà lo strumento Studio.
Selezionare la libreria di localizzazione Mega Cloud
Fare clic sull'icona a destra di Mega Cloud Service.
Selezionare la libreria da utilizzare.
Dopo il caricamento riuscito della libreria e delle informazioni Mega Blocks, il pannello Studio apparirà come mostrato.
Caricare il modello denso del Block
Fare clic su Carica a destra del nome del Block per caricare dinamicamente il suo modello denso.
Il modello caricato apparirà nella scheda Scene. Notare l'icona nell'angolo in basso a sinistra: indica che il modello nel campo visivo corrente non è ancora completamente caricato. Attendere la scomparsa dell'icona per confermare il completamento.
Creare un'annotazione
Nella scena, tenere premuto Ctrl (Windows) / Command (Mac) e fare clic sinistro nel punto desiderato.
Utilizzare un modello
Trascinare il modello importato nel nodo della scena come nodo figlio dell'annotazione.
Impostare i valori Position e Rotation a 0 nel pannello Inspector del modello. Regolare Scale secondo necessità.
Nota
EMA gestisce tutta la logica di trasformazione delle coordinate. Impostare Position e Rotation a 0 allinea il centro geometrico del modello con il punto dell'annotazione. Ogni spostamento o rotazione deve essere eseguito agendo sul nodo genitore (il nodo annotazione).
[Opzionale] Regolare con precisione la posizione del modello
Per regolazioni precise di posizione e orientamento, consultare Come utilizzare l'editor di Unity per allineare con precisione i contenuti 3D al mondo reale.
Creare un nuovo pacchetto di annotazioni
Fare clic sull'icona a destra del pacchetto di annotazioni nel pannello Inspector.
Inserire un nome per i dati di annotazione e fare clic sul segno di spunta a destra.
Dopo la creazione riuscita, apparirà come mostrato. Fare clic su Conferma in basso.
Fare clic sull'icona di caricamento per effettuare l'upload.
Al completamento dell'upload, viene visualizzata una notifica.
Registrare l'ID dell'annotazione
È necessario registrare il nome o l'ID dei dati di annotazione per caricarli successivamente su xr-frame.
Dopo l'upload riuscito, le informazioni corrispondenti saranno visibili anche nella libreria di localizzazione cloud.
Qui è possibile visualizzare anche il nome e l'ID dei dati di annotazione caricati.
Passi successivi
- Creare contenuti 3D allineati al mondo reale con l'editor di Unity
- Provare a eseguire una simulazione nell'editor di Unity
- Eseguire il progetto di esempio completo