Table of Contents

Diagnosi e riparazione: tremolio dei contenuti

Questa guida affronta il problema dei contenuti virtuali che tremano, scivolano o saltano durante il tracciamento di immagini piane, aiutando gli sviluppatori a distinguere tra tremolio normale e anomalo e fornendo un approccio sistematico per l'individuazione e il miglioramento.

Distinzione tra "tremolio normale"

Comprendere i seguenti scenari aiuta a evitare ottimizzazioni eccessive o diagnosi errate:

Leggero spostamento (normale)

  • Manifestazione: leggera oscillazione o lenta rotazione di pochi pixel nei contenuti virtuali.
  • Scenario:
    • Illuminazione non uniforme (es. variazioni di luce/ombra in interni)
    • Regolazione automatica della messa a fuoco o dell'esposizione della fotocamera
    • Leggero tremolio manuale del dispositivo (senza treppiede)
  • Aspettativa: difficile da evitare in questi casi, nessun intervento richiesto.

Tremolio temporaneo (normale)

  • Manifestazione: i contenuti virtuali tremano per 0,5~1 secondo durante movimenti rapidi del dispositivo o dell'immagine target, per poi stabilizzarsi.
  • Scenario:
    • Transizione da stato statico a dinamico
    • Fase iniziale di riconoscimento dell'immagine target
  • Aspettativa: fa parte del processo di convergenza dell'algoritmo, considerato normale se si risolve rapidamente.

Tremolio ai bordi (normale)

  • Manifestazione: lieve salto dei contenuti virtuali quando l'immagine è ai bordi del campo visivo o vicina alla perdita del tracciamento.
  • Scenario:
    • Parziale occlusione dell'immagine (es. dita che coprono i bordi)
    • Estrapolazione del campo visivo della fotocamera
  • Aspettativa: causato da informazioni di tracciamento parzialmente mancanti, si consiglia di guidare l'utente a mantenere l'immagine al centro del campo visivo.

Cause comuni del tremolio anomalo e miglioramenti

I seguenti scenari indicano problemi che richiedono interventi specifici:

Qualità insufficiente dell'immagine target

Fenomeno: tremolio persistente ad alta frequenza, salti irregolari o frequenti scomparse dei contenuti virtuali.
Metodo di verifica:

Suggerimenti:

  • Ottimizzare l'immagine:
    • Aumentare il contrasto locale.
    • Evitare aree monocromatiche, aggiungere texture sottili.
    • Evitare texture ripetitive.

Prestazioni hardware insufficienti

Fenomeno: tremolio più evidente o perdita del tracciamento su dispositivi entry-level rispetto a modelli mid/high-end.
Metodo di verifica:

  • Controllo utilizzo CPU: monitorare l'utilizzo della CPU dell'app con strumenti Profiler.

Suggerimenti:

  • Abilitare modalità prestazioni: impostare ImageTrackerMode su PreferPerformance, sacrificando leggermente la precisione per una maggiore fluidità.
  • Ridurre il numero di tracciamenti: ridurre Simultaneous Number se è attivo il tracciamento multi-target.
  • Adattamento per piattaforma: fornire scene semplificate per dispositivi entry-level.

Interferenze ambientali

Fenomeno: tremolio in condizioni specifiche di illuminazione o sfondo, che scompare cambiando ambiente.
Metodo di verifica:

  • Test illuminazione: verificare in illuminazione uniforme (es. cielo nuvoloso) e in condizioni di forte luce/ombre.
  • Interferenze dello sfondo: controllare se lo sfondo è eccessivamente caotico (es. persone in movimento).
  • Riflessi: verificare se la superficie fisica dell'immagine target è riflettente (es. vetro, metallo).

Suggerimenti:

  • Controllo illuminazione: consigliare agli utenti ambienti con luce uniforme, evitando luce diretta o ombre marcate.
  • Ottimizzazione fisica: per immagini su superfici riflettenti, applicare una pellicola opacizzante o stampare l'immagine su supporto fisico.

Tremolio locale accentuato

Fenomeno: in scene virtuali estese, i contenuti vicini all'immagine target fisica tremano poco, mentre quelli lontani presentano tremolio evidente.
Metodo di verifica:

  • Ridimensionamento contenuti: ridurre uniformemente la Scala dei contenuti virtuali e ripetere il test nelle stesse condizioni.

Suggerimenti:

  • Regolazione contenuti: contenuti troppo estesi amplificano l'errore angolare in direzioni lontane dall'immagine target (es. un errore di 0,1° causa uno scostamento realtà-virtuale di 0,1 cm nelle vicinanze, ma può raggiungere 10 cm a distanza). È necessario adattare le dimensioni virtuali rispetto a quelle fisiche del target.

Riepilogo e best practice

È fondamentale distinguere tra tremolio normale (leggeri spostamenti, recupero temporaneo) e anomalo (salti frequenti, perdite ripetute). Quest'ultimo impatta l'esperienza utente e richiede analisi sequenziale:

  1. Verificare la qualità dell'immagine target;
  2. Identificare problemi specifici di prestazioni del dispositivo;
  3. Escludere interferenze ambientali (illuminazione, scene dinamiche, riflessi);
  4. Valutare dimensioni eccessive dei contenuti virtuali.

In caso di problemi persistenti, contattare il forum ufficiale EasyAR o l'assistenza tecnica fornendo log, screen recording o altri dati per analisi approfondite.