Table of Contents

Diagnosi e correzione: contenuto non visualizzato

Questo articolo riguarda problemi comuni in cui il contenuto virtuale non può essere visualizzato nel planar image tracking. Fornisce metodi sistematici di troubleshooting e suggerimenti di miglioramento per aiutare gli sviluppatori a individuare e risolvere rapidamente i problemi.

Cause comuni e metodi di troubleshooting

Il contenuto non visualizzato di solito riguarda image recognition, errori di implementazione delle funzioni o limitazioni di permission. Di seguito sono riportate le cause principali e i passaggi di troubleshooting:

Fallimento di image recognition

Sintomo: dopo che la camera punta alla target image, il contenuto virtuale non appare affatto. Troubleshooting:

  • Controllare il recognition score dell'immagine: usare il target image detection tool per caricare la image e confermare il recognition score, che deve raggiungere 4-5 stelle.
  • Verificare la qualità della image: assicurarsi che la image soddisfi i requisiti di texture, dimensione e proporzione in best practices.
  • Controllare la target image entity: assicurarsi che la superficie della target image entity, come poster o card, non sia riflettente e rimanga piatta senza pieghe.
  • Vedere i logs: controllare gli application logs, cercare l'evento TargetLoad e confermare se la target image è stata caricata correttamente.

Suggerimenti di miglioramento:

  • Ottimizzare la image: aumentare il contrasto, evitare pattern ripetuti e assicurarsi che il soggetto principale occupi più del 70% dell'immagine.
  • Sostituire la image: se il problema persiste dopo l'ottimizzazione, usare un'immagine di test del Sample ufficiale, come namecard.jpg, per verificare se il problema dipende dalla image stessa.
  • Assicurare l'entità fisica: la target entity dovrebbe usare il più possibile una superficie opaca o relativamente ruvida e rimanere piatta senza pieghe o curvature.
  • Controllare la logica: assicurarsi che l'applicazione abbia caricato correttamente la target image usata per il test.

Errori di implementazione delle funzioni

Sintomo: la image è stata riconosciuta, ma il contenuto virtuale non viene visualizzato o la sua posizione è anomala.

Troubleshooting:

  • Controllare la configurazione di ImageTarget:
    • Controllare se, in base al tipo Source, punta al file corretto nella cartella StreamingAssets.
    • Controllare se Scale è impostato sulla dimensione fisica effettiva.
  • Confermare la gerarchia del prefab: il contenuto virtuale, come Cube, deve essere un child node di ImageTarget e non deve essere disabilitato.

Suggerimenti di miglioramento:

  • Reimpostare la configurazione: eliminare e ricreare ImageTarget nella scene, trascinare il prefab secondo la specifica e associare la image.
  • Semplificare il test: rimuovere temporaneamente custom scripts e mantenere solo il Cube di base per confermare la scene minima eseguibile.
  • Controllare i logs: cercare errori relativi a ImageTargetController, come fail to load target data.

Problemi di permission

Sintomo: inizialmente funzionava normalmente, ma dopo un periodo di esecuzione il contenuto scompare. Troubleshooting: Confermare se si rientra in una delle seguenti situazioni:

  • Uso su XR headset
  • Uso di custom camera
  • Uso di AR Engine/ARFoundation su telefono

Se si rientra in una di queste situazioni, si potrebbe usare una License di prova.

Suggerimenti di miglioramento:

  • Usare una License ufficiale.

Problemi del contenuto virtuale

Sintomo: il contenuto inizialmente viene visualizzato normalmente, ma non si vede quando la camera è molto vicina o molto lontana dal target object. Troubleshooting:

  • Controllare le impostazioni near e far clipping: assicurarsi che le impostazioni near e far clipping usate durante il rendering del contenuto virtuale siano in un intervallo ragionevole.
  • Controllare la dimensione del content model: quando il content model è troppo grande, avvicinarsi al target object può causare clipping attraverso il modello e rendere invisibile il contenuto; quando il content model è troppo piccolo, allontanarsi dal target object può renderlo troppo piccolo per vederlo chiaramente.

Suggerimenti di miglioramento:

  • Impostare near e far clipping appropriati.
  • La dimensione fisica del contenuto virtuale deve essere adeguata rispetto alla target image entity.

Riepilogo e best practice

Il problema di contenuto non visualizzato è solitamente causato da image, implementazione del programma, permission o dal contenuto stesso. Si consiglia il troubleshooting in questo ordine:

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

Se il problema persiste, fornire log files, registrazioni schermo e altri materiali tramite il forum ufficiale EasyAR o il supporto tecnico per ulteriori analisi.