Table of Contents

Diagnosi e riparazione: contenuto non visualizzato

Questo articolo fornisce metodi sistematici di risoluzione dei problemi e suggerimenti per migliorare i problemi comuni di mancata visualizzazione del contenuto virtuale nel tracciamento di oggetti 3D, aiutando gli sviluppatori a identificare e risolvere rapidamente i problemi.

Cause comuni e metodi di risoluzione

La mancata visualizzazione del contenuto coinvolge solitamente il fallimento nel riconoscimento degli oggetti, errori di implementazione delle funzionalità o limitazioni di autorizzazioni. Di seguito sono riportate le cause principali e le procedure per la risoluzione dei problemi:

Fallimento nel riconoscimento dell'oggetto

Fenomeno: Dopo aver puntato la fotocamera verso l'oggetto target, il contenuto virtuale non appare affatto.
Metodi di risoluzione:

  • Verificare la qualità del modello: Assicurarsi che il modello 3D e l'oggetto soddisfino i requisiti di formato file, texture, geometria, ecc., come specificato in preparazione del modello.
  • Verificare l'oggetto target: Assicurarsi che la superficie dell'oggetto target non abbia materiali riflettenti o speculari.
  • Controllare i log: Esaminare i log dell'applicazione per verificare se il modello target è stato caricato correttamente.

Suggerimenti per il miglioramento:

  • Ottimizzare il modello: Assicurarsi che la texture sia sufficientemente ricca e che la struttura geometrica non presenti buchi.
  • Verificare la logica: Assicurarsi che l'applicazione abbia caricato correttamente il modello target. In caso di fallimento nel caricamento, fare riferimento al capitolo fallimento nel caricamento del target per controlli e riparazioni.

Errore nell'implementazione della funzionalità

Fenomeno: L'oggetto è riconosciuto, ma il contenuto virtuale non viene visualizzato o appare in una posizione anomala.

Metodi di risoluzione:

  • Verificare la configurazione di ObjectTarget:
    • In base al tipo di Source, verificare che punti al file corretto nella cartella StreamingAssets.
    • Verificare se Scale è stato modificato in base alle dimensioni effettive dell'oggetto (ad esempio, se i valori delle dimensioni del BoundingBox calcolati dal file del modello sono 10 x 10 x 30, ma le dimensioni effettive dell'oggetto sono 0,1m x 0,1m x 0,3m, allora Scale dovrebbe essere impostato su 0,01).
  • Confermare la gerarchia dei prefab:
    • Il contenuto virtuale deve essere allo stesso livello del modello 3D target ed essere entrambi nodi figli di ObjectTarget. Il contenuto virtuale non deve essere disabilitato.
    • La proprietà Rotation del modello 3D target deve avere la direzione Y impostata su 180.
    • Il posizionamento del contenuto virtuale deve avvenire completamente attorno alla posizione del modello 3D target.

Suggerimenti per il miglioramento:

  • Reimpostare la configurazione: Eliminare e ricreare ObjectTarget nella scena, trascinare il prefab secondo le specifiche e associare il modello 3D.
  • Controllare i log: Cercare errori relativi a ObjectTargetController, come fail to load target data.

Problemi di autorizzazione

Fenomeno: Funzionava normalmente, ma dopo un periodo di esecuzione il contenuto scompare.
Metodi di risoluzione:
Verificare se si rientra in una delle seguenti situazioni:

  • Utilizzo su visore XR
  • Utilizzo di una fotocamera personalizzata
  • Utilizzo su smartphone con AR Engine/ARFoundation

Se si è in una di queste situazioni, è possibile che si stia utilizzando una License di prova.

Suggerimenti per il miglioramento:

  • Utilizzare una License della versione completa.

Problemi del contenuto virtuale

Fenomeno: Il contenuto era visualizzato normalmente, ma quando la fotocamera è molto vicina/lontana dall'oggetto target, il contenuto non è visibile.
Metodi di risoluzione:

  • Verificare le impostazioni di near clip/far clip: Assicurarsi che le impostazioni di near clip e far clip durante il rendering del contenuto virtuale siano entro un intervallo ragionevole.
  • Verificare le dimensioni del modello del contenuto: Se il modello del contenuto è troppo grande, avvicinandosi all'oggetto target potrebbe verificarsi un clipping e non vedere il contenuto; se il modello del contenuto è troppo piccolo, allontanandosi dall'oggetto target potrebbe essere visualizzato troppo piccolo per essere visto chiaramente.

Suggerimenti per il miglioramento:

  • Impostare valori appropriati per near clip e far clip.
  • Assicurarsi che le dimensioni fisiche del contenuto virtuale rispetto all'oggetto target siano adeguate.

Riepilogo e best practice

I problemi di mancata visualizzazione del contenuto sono solitamente causati dal modello 3D dell'oggetto, dall'implementazione del programma, dalle autorizzazioni o dal contenuto stesso. Si consiglia di procedere con la risoluzione dei problemi in questo ordine:

  1. Verificare se la License è della versione completa;
  2. Verificare se il contenuto virtuale stesso è appropriato;
  3. Confermare la qualità del modello 3D target;
  4. Verificare se esistono problemi nell'implementazione del programma o nella configurazione di sviluppo.

Se il problema persiste, è possibile fornire ulteriori analisi tramite il forum ufficiale EasyAR o l'assistenza tecnica, allegando file di log, registrazioni dello schermo, ecc.