Table of Contents

Diagnosi e riparazione: contenuto non visualizzato

Questa guida fornisce metodi sistematici di risoluzione dei problemi e suggerimenti per migliorare i casi comuni in cui il contenuto virtuale non viene visualizzato durante il tracciamento di immagini piane, aiutando gli sviluppatori a identificare e risolvere rapidamente i problemi.

Cause comuni e metodi di risoluzione dei problemi

La mancata visualizzazione del contenuto coinvolge solitamente il riconoscimento dell'immagine, errori di implementazione funzionale o limitazioni delle autorizzazioni. Di seguito sono elencate le cause principali e i passaggi per la risoluzione dei problemi:

Fallimento del riconoscimento dell'immagine

Fenomeno: Il contenuto virtuale non appare affatto dopo aver puntato la fotocamera verso l'immagine target.
Metodi di risoluzione:

  • Controllare la riconoscibilità dell'immagine: Utilizzare lo strumento di rilevamento immagini target per caricare l'immagine e verificare che il punteggio di riconoscibilità sia compreso tra 4 e 5 stelle.
  • Verificare la qualità dell'immagine: Assicurarsi che l'immagine soddisfi i requisiti di texture, dimensioni e proporzioni descritti nelle best practice.
  • Controllare l'oggetto fisico: Assicurarsi che la superficie dell'oggetto fisico (come poster o cartoline) non rifletta la luce e sia piatta, senza pieghe.
  • Consultare i log: Controllare i log dell'applicazione, cercare l'evento TargetLoad e confermare che l'immagine target sia stata caricata correttamente.

Suggerimenti per il miglioramento:

  • Ottimizzare l'immagine: aumentare il contrasto, evitare motivi ripetitivi, garantire che il soggetto occupi oltre il 70% dell'inquadratura.
  • Sostituire l'immagine: Se il problema persiste dopo l'ottimizzazione, utilizzare un'immagine di test dagli esempi ufficiali (ad esempio namecard.jpg) per verificare se il problema è nell'immagine stessa.
  • Verificare l'oggetto fisico: L'oggetto target dovrebbe preferibilmente avere una superficie opaca o ruvida, mantenendola piatta senza pieghe o curvature.
  • Controllare la logica: Assicurarsi che l'applicazione abbia caricato correttamente l'immagine target utilizzata per il test.

Errore di implementazione funzionale

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

Metodi di risoluzione:

  • Controllare la configurazione di ImageTarget:
    • Verificare che Source punti al file corretto nella cartella StreamingAssets in base al tipo.
    • Assicurarsi che Scale sia impostato sulla dimensione fisica reale.
  • Confermare la gerarchia del prefab: Il contenuto virtuale (ad esempio un Cube) deve essere un nodo figlio di ImageTarget e non deve essere disabilitato.

Suggerimenti per il miglioramento:

  • Reimpostare la configurazione: Eliminare e ricreare ImageTarget nella scena, trascinare il prefab secondo le specifiche e associare l'immagine.
  • Semplificare il test: Rimuovere temporaneamente script personalizzati, mantenere solo un Cube di base per confermare una scena funzionante minima.
  • Controllare i log: Cercare errori relativi a ImageTargetController, come fail to load target data.

Problemi di autorizzazione

Fenomeno: Il contenuto scompare dopo un periodo di funzionamento normale.
Metodi di risoluzione:
Confermare se si rientra in uno dei seguenti casi:

  • Utilizzo su visori XR
  • Utilizzo di una fotocamera personalizzata
  • Utilizzo su dispositivi mobili con AR Engine/ARFoundation

Se si rientra in uno di questi casi, è probabile che si stia utilizzando una licenza di prova.

Suggerimenti per il miglioramento:

  • Utilizzare una licenza ufficiale.

Problemi del contenuto virtuale

Fenomeno: Il contenuto non è visibile quando la fotocamera è molto vicina/lontana dall'oggetto target.
Metodi di risoluzione:

  • Controllare le impostazioni di taglio vicino/lontano: Assicurarsi che i piani di taglio vicino e lontano durante il rendering del contenuto virtuale siano impostati su intervalli ragionevoli.
  • Controllare le dimensioni del modello del contenuto: Modelli troppo grandi possono causare clipping quando ci si avvicina all'oggetto target; modelli troppo piccoli possono risultare invisibili quando ci si allontana.

Suggerimenti per il miglioramento:

  • Impostare piani di taglio vicino/lontano appropriati.
  • Garantire che le dimensioni fisiche del contenuto virtuale siano proporzionate a quelle dell'oggetto target.

Riepilogo e best practice

I problemi di mancata visualizzazione del contenuto sono solitamente causati da immagini, implementazione del programma, autorizzazioni o dal contenuto stesso. Si consiglia di procedere con la risoluzione in quest'ordine:

  1. Verificare che la licenza sia ufficiale.
  2. Controllare l'adeguatezza del contenuto virtuale.
  3. Convalidare la qualità dell'immagine target.
  4. Confermare l'assenza di problemi nell'implementazione del programma o nella configurazione di sviluppo.

Se il problema persiste, è possibile richiedere ulteriore analisi tramite il forum ufficiale EasyAR o il supporto tecnico fornendo file di log, registrazioni dello schermo, ecc.