Table of Contents

Guida rapida allo sviluppo di EasyAR Mega Unity con esempi d'uso

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

Prima di iniziare

Prima di leggere questo articolo, assicurarsi di aver completato quanto segue:

  • Avere una libreria di localizzazione cloud valida.
  • Installare Unity (2021.3.30 LTS o versioni successive), si consiglia di utilizzare l'ultima versione di Unity 2022.3 o Unity 6.3.
  • Importare i pacchetti com.easyar.sense-**.tgz e com.easyar.mega-**.tgz seguendo il metodo descritto in Abilitare Mega.
Nota

Questa guida è applicabile solo ai plug-in Unity di versione >= 4003. Se si è scaricato per caso una versione precedente ma si sta ancora leggendo la documentazione di introduzione, è necessario scaricare prima la versione più recente del plug-in.

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.

Import Sample

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: Configurare l'SDK e il servizio di localizzazione cloud Mega

  1. Dalla barra dei menu seleziona EasyAR > Sense > Configuration;
    License Guide

  2. Nel pannello Project Settings aperto incolla la tua License Key;
    Fill License

    Consiglio

    La licenza EasyAR Sense può essere creata dal Centro di sviluppo EasyAR. Per la prima volta, puoi crearla seguendo questi passaggi:

    • Crea EasyAR Sense 4.x Personal Edition
    • Per la mappa spaziale sparsa seleziona No
    • Inserisci un nome per l'applicazione a tua scelta, e per Bundle ID e Package Name inserisci com.mycompany.myproject
    • Seleziona la licenza appena creata, entra e clicca sul pulsante di copia a destra

    copykey

    Nota

    Bundle ID e Package Name possono essere modificati in seguito, ma con un numero limitato di volte. Se hai un nome di pacchetto applicazione definito, puoi anche inserirne il tuo.

    Non c'è limite al numero di creazioni per la versione personale, mentre per gli altri tipi puoi crearle in base alle esigenze quando sei pronto per l'uso ufficiale.

  3. Controlla e abilita l'opzione Mega > Mega Block/Landmark support nel pannello Project Settings;

  4. Configura le informazioni della tua libreria di localizzazione cloud Mega nell'opzione Mega Block del pannello Project Settings;
    Mega Config Guide

    Consiglio

    La configurazione della libreria di localizzazione cloud Mega può essere ottenuta dal Centro di sviluppo EasyAR.
    Mega Config Detail
    Assicurati che la tua API Key abbia i permessi per Mega Block e SpatialMap, altrimenti devi modificarla o crearne una nuova.
    API Key Auth
    Se non trovi la libreria di localizzazione, devi prima configurare correttamente la libreria di localizzazione e verificare nuovamente che la libreria di localizzazione cloud sia valida.

Terza fase: Configurazione di Mega Block

  1. Configurazione di Mega Block;

    Seleziona Mega Block e compila l'ID e il Nome del Blocco.

    Consiglio

    L'ID e il Nome del Blocco possono essere ottenuti dal centro di sviluppo di EasyAR nella libreria di localizzazione corrispondente.

    Se non ci sono dati sui Blocchi nella libreria di localizzazione, è necessario aggiungere i Blocchi necessari alla libreria di localizzazione e verificare nuovamente che la libreria di localizzazione cloud sia valida.

Quarto passo: Posizionare il contenuto 3D

  1. Selezionare Mega Block e creare lo strumento editor;

  2. Controllare le informazioni del servizio e connettersi al servizio;

    Consiglio

    Se non ci sono altre modifiche, le informazioni del servizio dovrebbero essere le stesse inserite in Project Settings.

    Dopo la connessione riuscita al servizio, dovresti vedere l'ora di aggiornamento e l'interfaccia di controllo dei dati dell'editor Block.

  3. Caricare i dati dell'editor Block;

    Clicca sulla prima casella di selezione sotto Dati Block, questo avvierà il processo di caricamento dei dati dell'editor Block. Dopo il caricamento, puoi vedere la mesh del Block corrente nella finestra Scene:

    Consiglio

    La mesh del Block cambierà LOD in base alla posizione della fotocamera, è necessario mantenere la connessione a Internet.

  4. Posizionare il contenuto 3D

    A questo punto, puoi fare riferimento alla mesh del Block per posizionare gli oggetti 3D.

    Nota
    • Gli oggetti 3D devono essere posizionati sotto il nodo Block, per garantire che la posizione di rendering del contenuto virtuale sia corretta durante l'esecuzione.
    • Gli oggetti 3D non possono essere posizionati sotto il nodo EasyAR.Mega.EditorTool, questo nodo è utilizzato solo per lo strumento editor e in alcune situazioni verrà eliminato o ricostruito automaticamente.

Quinto passo: Modificare la configurazione del Player

Successivamente, nel menu di Unity File > Build Settings > Player Settings, cliccate sull'icona Android per aprire le impostazioni relative alla piattaforma Android.

switchtoandroid

  • Modificate il Package Name in quello visualizzato nella pagina della License Key

    androidPackageName

    Consiglio

    Ad esempio, se il Package Name che avete inserito durante la creazione della License Key è com.mycompany.myproject, allora qui dovete inserire com.mycompany.myproject, altrimenti l'esecuzione fallirà.

  • Modificate il Minimum API Level in API Level 24 o versione successiva

    androidAPILevel

  • Modificate lo Scripting Backend in IL2CPP e selezionate ARM64 in Target Architecture

    androidarm64

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 (ad esempio Android / iOS), verifica che il nome del pacchetto (Bundle ID) e la chiave di licenza corrispondano;
    Switch Platform
  3. Clicca su Build And Run.
    Build And Run

L'effetto di esecuzione girato dal vivo è il seguente:

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:

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

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

Controllo avanzato delle funzionalità Mega

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

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

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:

Se desideri utilizzare AR Foundation, puoi iniziare da qui: