Table of Contents

Diagnosi e correzione: contenuto non visualizzato

Questo articolo riguarda problemi comuni in cui il contenuto virtuale non può essere visualizzato nel 3D object 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 fallimento di object recognition, errori di implementazione delle funzioni o limitazioni di permission. Di seguito sono riportate le cause principali e i passaggi di troubleshooting:

Fallimento di object recognition

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

  • Controllare la qualità del modello: assicurarsi che il 3D model e l'object soddisfino i requisiti di file format, texture, geometry e altri in model preparation.
  • Controllare il target object: assicurarsi che la superficie del target object non abbia materiale riflettente o speculare.
  • Vedere i logs: controllare gli application logs e verificare se il target model è stato caricato correttamente.

Suggerimenti di miglioramento:

  • Ottimizzare il modello: assicurarsi che le textures siano sufficientemente ricche e che la geometry non abbia buchi.
  • Controllare la logica: assicurarsi che l'applicazione abbia caricato correttamente il target model. In caso di fallimento del caricamento, fare riferimento a target loading failure per controllo e correzione.

Errori di implementazione delle funzioni

Sintomo: l'object è stato riconosciuto, ma il contenuto virtuale non viene visualizzato o la sua posizione è anomala.

Troubleshooting:

  • Controllare la configurazione di ObjectTarget:
    • Controllare se, in base al tipo Source, punta al file corretto nella cartella StreamingAssets.
    • Controllare se Scale è stato modificato in base alle dimensioni effettive dell'object. Ad esempio, se la dimensione BoundingBox calcolata dal file modello è 10 x 10 x 30 e la dimensione effettiva dell'object è 0.1m x 0.1m x 0.3m, Scale deve essere impostato su 0.01.
  • Confermare la gerarchia del prefab:
    • Il contenuto virtuale deve essere allo stesso livello del target 3D model, ed entrambi devono essere child nodes di ObjectTarget. Il contenuto virtuale non deve essere disabilitato.
    • La proprietà Rotation del target 3D model deve impostare la direzione Y su 180.
    • Il posizionamento del contenuto virtuale deve avvenire completamente attorno alla posizione del target 3D model.

Suggerimenti di miglioramento:

  • Reimpostare la configurazione: eliminare e ricreare ObjectTarget nella scene, trascinare il prefab secondo la specifica e associare il 3D model.
  • Controllare i logs: cercare errori relativi a ObjectTargetController, 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 al target object.

Riepilogo e best practice

Il problema di contenuto non visualizzato è solitamente causato da object 3D model, 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. Confermare la qualità del target 3D model;
  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.