Aggiungere i target di tracciamento Mega

Questo documento spiega come aggiungere e configurare i target di tracking di Mega.

Prima di iniziare

Verificare La mia funzione di localizzazione è pronta? per confermare che la cloud localization library sia stata creata correttamente e che la mappa sia stata aggiunta.
Importare l'ultima versione del plugin EasyAR e abilitare Mega
Conoscere i concetti di base e il modo d'uso dei target di tracking in Unity AR

Nota

Il contenuto e gli strumenti seguenti si applicano solo allo sviluppo di applicazioni Unity con EasyAR Mega.

Se si sviluppano mini program, fare riferimento a Creare e caricare annotazioni con l'editor Unity (sviluppo mini program).

Se non si sta sviluppando un'app Unity ma si desidera vedere il risultato della mappatura Mega, fare riferimento a Anteprima della mesh 3D del mondo reale nella guida Mega.

Se non si sta sviluppando un'app Unity ma si desidera simulare il risultato della localizzazione, fare riferimento a Anteprima della simulazione nella guida Mega.

Questo documento richiede che il progetto abbia già importato i seguenti Unity package:

Versione >= 4003
Versione 4.7 - 4002

com.easyar.sense

Il target di tracking di Mega è un GameObject vuoto che contiene il componente MegaBlockController e rappresenta un block in Unity.

alt text

Nota

Senza importare il package com.easyar.mega, le funzioni dell'editor per block non sono disponibili, ma ciò non influenza il comportamento e le funzionalità del tracking a runtime.

Se la configurazione non ha abilitato correttamente Mega, il target non sarà utilizzabile.

alt text

Creare un target di tracking

Versione >= 4003
Versione 4.7 - 4002

Fare clic con il tasto destro su un'area vuota nella vista Hierarchy e creare il target di tracking di Mega tramite il menu EasyAR Sense > Mega > Target : Mega Block.

alt text

In uno script, si può creare usando ARSessionFactory.CreateController.

ARSessionFactory.CreateController<MegaBlockController>();

Aggiungere il target di tracking nell'editor

Per usare questo metodo, è necessario impostare BlockHolder.BlockRootSource su External (predefinito) oppure Mixed.

Per prima cosa bisogna aggiungere lo strumento Block Viewer for Unity Developer.

Fare clic con il tasto destro su un'area vuota nella vista Hierarchy e aggiungere lo strumento Block Viewer per Unity Developer tramite il menu EasyAR Mega > Tool > Block Viewer for Unity Developer (Edit Mode).

Importante

Quando si sviluppa un'app Mega con Unity, bisogna usare lo strumento Block Viewer for Unity Developer. Gli altri strumenti sotto il menu EasyAR Mega > Tool non sono adatti allo sviluppo di app Unity.

Anche se Annotation Tool ha una funzione simile, alcune funzioni di questo strumento verranno rimosse nelle versioni future, quindi non è consigliato.

La funzione di annotazione di Annotation Tool (solo l'annotazione in sé) verrà presto migrata nella pagina web di EasyAR Developer Center; il caricamento della mesh block e il posizionamento del modello non ne saranno influenzati.

Dopo che lo strumento è stato aggiunto correttamente, nella gerarchia della scena compariranno un nodo EasyAR.Mega.BlockViewer (Dev) e un nodo MegaBlocks.

Quindi usare lo strumento per generare il target di tracking.

Selezionare il nodo EasyAR.Mega.BlockViewer (Dev) e compilare nel pannello Inspector le informazioni dell'account EasyAR, quindi effettuare l'accesso;

Fare clic sul pulsante a destra di Mega Cloud Service;

Selezionare il Mega localization service da usare e fare clic su OK.

Dopo aver selezionato il servizio, l'elenco dei block della library corrente verrà mostrato sotto il nodo MegaBlocks e nel pannello dello strumento.

Consiglio

Perché MegaBlocks è vuoto?

Si consiglia di controllare La mia funzione di localizzazione è pronta? per confermare che la cloud localization library sia stata creata correttamente e che la mappa sia stata aggiunta.

A questo punto il target block è stato generato; ogni nodo figlio sotto MegaBlocks che inizia con Block_ rappresenta un target block.
Aggiunta automatica del target di tracking quando la localizzazione riesce

Per usare questo metodo, BlockHolder.BlockRootSource deve essere configurato su Internal o Mixed.

In questi due modi, se si localizza un nuovo block e non esiste un block corrispondente sotto BlockHolder.BlockRoot, il nuovo block verrà aggiunto automaticamente sotto BlockHolder.BlockRoot. Se BlockHolder.BlockRoot non esiste, verrà creato automaticamente.

Consiglio

Quando il target di tracking viene aggiunto automaticamente al momento della localizzazione riuscita, non è possibile caricare il modello block: si può solo aggiungere il target di tracking block.
Aggiungere il target di tracking da script

Per usare questo metodo, BlockHolder.BlockRootSource deve essere configurato su Internal o Mixed; in questo caso, se BlockHolder.BlockRoot non esiste, verrà creato automaticamente. Oppure, quando BlockHolder.BlockRootSource è External, si può anche specificare in anticipo nell'editor l'oggetto BlockHolder.BlockRoot.

Nota

Se il block non è nella localization library, anche se viene aggiunto alla scena tramite script, non potrà essere localizzato.

Si può usare il metodo BlockHolder.Hold per aggiungere un nuovo block sotto il nodo BlockHolder.BlockRoot. Questo metodo è tipicamente usato quando, con file ema, lo script legge le informazioni di annotazione e aggiunge il block.

Per esempio, il frammento di codice seguente mostra come aggiungere un block usando le informazioni del file di annotazione:
```
foreach (var item in ema.blocks)
{
    var info = new BlockController.BlockInfo { ID = item.id.ToString(), Timestamp = item.timestamp };
    if (!item.keepTransform && item.location.OnSome)
    {
        blockHolder.Hold(info, item.location.Value);
    }
    else
    {
        blockHolder.Hold(info, item.transform.ToUnity());
    }
}
```
Consiglio

Quando si aggiunge un target di tracking a runtime tramite script, non è possibile caricare il modello block: si può solo aggiungere il target di tracking block.

Configurare il target di tracking

Configurare la sorgente dei dati del target

Versione >= 4003
Versione 4.7 - 4002

Il target di tracking può essere riconosciuto e seguito solo dopo aver configurato correttamente la sua sorgente.

Nella vista Hierarchy si può selezionare il nodo block e compilare ID e Name del block.

In uno script, prima di MonoBehaviour.Start() si può modificare Source per impostare la sorgente del block.

block.Source = new MegaBlockController.BlockInfoSourceData(id, name);

In questo caso:

block id è l'identificatore univoco del block e deve essere compilato.
block name è il nome del block e può essere compilato liberamente in base alle necessità; in genere si consiglia di usare il nome reale del block per facilitarne il riconoscimento.

Consiglio

block id e name si possono ottenere dalla relativa cloud localization library nel EasyAR Developer Center.

Se nella cloud localization library non ci sono dati Block, bisogna aggiungere il Block necessario nella localization library e ricontrollare che la cloud localization library sia valida.

In MegaTrackerFrameFilter si specifica il target usato, cioè il block.

Nella maggior parte dei casi è consigliato mantenere la configurazione predefinita, cioè importare il block in editor usando Mega Studio.

Selezionare l'oggetto Mega Tracker sotto la sessione; l'opzione Block Root Source dovrebbe restare External (predefinito).

Allo stesso tempo, Block Root deve essere impostato sull'oggetto MegaBlocks nella scena.

Modificando l'opzione Block Root Source si possono scegliere altre modalità di origine del block; per esempio, quando si importano dati ema, in genere si sceglie Internal o Mixed.

In uno script, si può ottenere lo stesso risultato modificando BlockHolder.BlockRootSource.

Configurare il tracker usato dal target

Versione >= 4003
Versione 4.7 - 4002

Il target di tracking viene caricato dal tracker configurato e seguito dopo la localizzazione corretta.

Nella vista Hierarchy si può selezionare il nodo block e poi scegliere Mega Tracker nella sessione.

In uno script, si può modificare Tracker per impostare il tracker del block.

block.Tracker = megaTracker;

Tracker può essere modificato in qualsiasi momento a runtime; il caricamento/scaricamento avverrà mentre la sessione è in esecuzione. Se si imposta Tracker su null, il target verrà scaricato dal tracker precedentemente impostato. Il caricamento del block è un processo virtuale e non può fallire.

Nota

Perché un target venga tracciato, ci sono alcune condizioni chiave:

L'id di MegaBlockController.Source deve essere configurato correttamente prima di MonoBehaviour.Start().
Il block corrispondente all'id di Source deve esistere nella cloud localization library.
MegaBlockController.Tracker deve essere configurato con la cloud localization library corretta.

Di solito non è necessaria ulteriore configurazione, ma se serve un controllo multi-target si può procedere con le impostazioni corrispondenti.

Nella maggior parte degli scenari Mega non c'è bisogno di usare più target. Finché non si padroneggia il modo di evitare che più block si influenzino a vicenda, si consiglia di mettere un solo block in una cloud localization library.

Consiglio

In teoria Mega calcola la posizione del dispositivo in tutti i block, non seleziona il block visto dal dispositivo dalla cloud localization library. Un uso poco attento può peggiorare il risultato a causa di confusione dei dati e simili.

Selezionare l'oggetto Mega Tracker sotto la sessione e modificare l'opzione Multi Block per abilitare o disabilitare il tracking multi-target.

In uno script, si può ottenere lo stesso risultato modificando BlockHolder.MultiBlock.

Avvertenza

In genere, in una cloud localization library può esserci un solo block alla volta.

Modificare la configurazione multi-target influisce sul risultato del tracking e in generale non è consigliato. Usarla solo sotto la guida del supporto tecnico EasyAR.

Se la configurazione è stata modificata durante l'esecuzione dell'applicazione, assicurarsi di segnalarlo quando si fornisce un report del problema a EasyAR.

Ciclo di vita del target di tracking

Versione >= 4003
Versione 4.7 - 4002

Un ciclo di vita tipico del target di tracking è il seguente:

flowchart LR
  sstart((session avviata))
  sstop([session arrestata])
  
  start("Target.Start")
  load("Carica")
  tracking[["Tracking continuo"]]

  sstart --> load --> tracking --> sstop
  start -. "Target.Tracker = tracker" .-> load

Il flusso si divide in alcune fasi:

Caricamento: il target di tracking viene caricato nel tracker configurato; questo avviene dopo Start() del target e dopo l'avvio della sessione.
Processo di tracking: dopo che il target è stato localizzato, il tracker continua a seguirne posizione e stato fino a quando non viene localizzato un altro target.
Scaricamento: il target di tracking viene scaricato dal tracker e quest'ultimo non lo segue più. Ciò avviene quando la sessione si ferma o quando al target viene impostato di non usare più un tracker.

Table of Contents

Aggiungere i target di tracciamento Mega

Prima di iniziare

Nota

Il target di tracking di Mega

Nota

Creare un target di tracking

Importante

Consiglio

Consiglio

Nota

Consiglio

Configurare il target di tracking

Configurare la sorgente dei dati del target

Consiglio

Configurare il tracker usato dal target

Nota

Consiglio

Avvertenza

Ciclo di vita del target di tracking

Passi successivi

Argomenti correlati