Diagnosi e risoluzione: problemi di salti e scostamenti del contenuto nell'app

"Contenuti virtuali che galleggiano", "oggetti che tremano", "posizioni instabili" – queste sono problematiche comuni riscontrate dagli sviluppatori nelle app AR. La mancanza di stabilità del contenuto può minare gravemente l'immersività e persino portare a una cattiva esperienza utente.

Questo articolo ti aiuterà a comprendere le cause dei salti e degli scostamenti del contenuto e fornirà un metodo sistematico per l'individuazione e l'ottimizzazione.

Distinguere tra "vibrazioni normali" e "scostamenti anomali"

Innanzitutto, è necessario stabilire un'aspettativa ragionevole. Raggiungere un tracciamento AR ad alta precisione su dispositivi mobili è di per sé una sfida complessa. Le seguenti situazioni rientrano in un range normale, impossibili da eliminare completamente ma ottimizzabili:

Leggera vibrazione ad alta frequenza (Jitter):
- Manifestazione: gli oggetti virtuali presentano un'oscillazione millimetrica e sottile.
- Causa: è dovuta al rumore fisico dei sensori del dispositivo, ai limiti di precisione degli algoritmi di tracciamento visivo e al leggero tremolio della mano umana che regge il dispositivo.
- Esempio: quando si osserva da vicino (ad esempio, posizionando un oggetto virtuale su un tavolo e avvicinandosi), questa leggera vibrazione è normale.
Scostamento temporaneo (Drift):
- Manifestazione: quando l'utente muove o ruota rapidamente il dispositivo, l'oggetto virtuale mostra uno spostamento dalla posizione corretta per un breve periodo (0.5-1 secondo), per poi riallinearsi.
- Causa: durante movimenti rapidi, gli errori cumulativi dell'IMU (Unità di Misura Inerziale) e il ritardo nel posizionamento visivo del sistema SLAM del dispositivo causano un temporaneo scostamento.
- Esempio: in scenari dinamici, ciò è accettabile. Se l'oggetto riesce a "riagganciarsi" rapidamente alla posizione corretta, il sistema funziona.

Le seguenti situazioni, invece, sono problemi anomali che richiedono diagnosi e correzione:

Scostamento persistente e significativo della posizione: l'oggetto virtuale si allontana lentamente e costantemente dalla sua posizione corretta, senza riallinearsi o farlo solo dopo molto tempo.
Salti o tremolii violenti: l'oggetto virtuale salta in modo evidente sullo schermo o appare e scompare.
Incoerenza con la posizione relativa degli oggetti reali: l'oggetto virtuale non riesce a rimanere stabilmente "fissato" agli oggetti reali.

Nota

Inoltre, è fondamentale notare:
Per i dispositivi che operano in modalità 0DoF, 3DoF o 5DoF, il "sense of placement" e il "realismo" sono intrinsecamente inferiori rispetto ai dispositivi 6DoF. Quando l'utente si muove velocemente, gira o sale/scende scale, gli oggetti virtuali non riescono a seguire perfettamente.
Pertanto, fenomeni come contenuti che "galleggiano nell'aria" o "scostamenti di posizione" in queste modalità sono limitazioni intrinseche delle capacità del dispositivo, non i "guasti" discussi in questo articolo.
Per le differenze nell'esperienza tra le diverse modalità xDoF, consulta la sezione introduttiva in Best Practice di Navigazione.

Processo sistematico di diagnosi

Segui questo ordine per l'individuazione, partendo dalle cause più probabili.

Fase uno: Fattori ambientali esterni e hardware (non richiede modifiche al codice)

Controllo dell'ambiente fisico:
- Ricchezza della texture
  L'ambiente di test è troppo monotono? Pareti completamente bianche, pavimenti lisci, superfici in vetro possono causare fallimenti o errori nel posizionamento visivo.
- Oggetti dinamici
  Ci sono molti oggetti in movimento nell'ambiente (come folle, veicoli in transito)? Gli oggetti dinamici interferiscono con il posizionamento visivo, ma solitamente il problema è temporaneo.
- Confusione dello scenario
  Ci sono aree molto simili e facilmente confondibili (come ingressi di ascensori identici)? Scene visivamente simili compromettono il posizionamento, causando potenziali "salti" tra aree simili. Questi problemi possono essere mitigati impostando preventivamente informazioni a priori appropriate.
Controllo hardware del dispositivo:
- Surriscaldamento del dispositivo
  Dopo un uso prolungato, il dispositivo è eccessivamente caldo? Il surriscaldamento causa throttling della CPU/GPU, influenzando le prestazioni del sistema SLAM interno e rappresenta una causa comune di scostamento persistente.
- Prestazioni del dispositivo
  Su dispositivi più vecchi, limitazioni hardware e precisione dei componenti possono causare più facilmente scostamenti di scala, portando a scostamenti anche del contenuto virtuale. Prova a testare su un dispositivo diverso per verificare se il problema è dovuto a limitazioni hardware.

Fase due: Analisi della qualità della mappa e del posizionamento (utilizzando strumenti esterni)

Utilizza Mega Toolbox:
- Esegui Mega Toolbox nella stessa posizione e osserva la stabilità del suo posizionamento.
- Se anche il posizionamento di Toolbox scosta/trema: il problema è nella mappa stessa o l'ambiente corrente non è adatto al posizionamento.
- Se il posizionamento di Toolbox è stabile: il problema è nella tua applicazione. Prosegui con la fase tre.
Simula l'esecuzione dei dati EIF su PC:
- Riproduci i dati EIF registrati sul campo.
- Se la riproduzione mostra anche scostamento/tremolio: significa che lo scenario stesso non è adatto al posizionamento, o la mappa stessa ha problemi, o il dispositivo che ha registrato l'EIF aveva problemi di scostamento di scala nel tracciamento del movimento.
- Se la riproduzione è stabile: lo scenario è adatto al posizionamento, il problema potrebbe essere legato a surriscaldamento, throttling o altri fattori in esecuzione real-time nella tua app.

Fase tre: Controllo della logica interna all'applicazione

Aggiornamento della posa (Pose):
- Hai applicato un'ulteriore smoothing non necessario ai dati di posa (ad esempio un eccessivo Lerp o SmoothDamp)? Questo può introdurre ritardo e una sensazione di scostamento.
- Generalmente, utilizzare direttamente la Pose originale restituita da Mega è l'approccio più stabile.
Corrispondenza dei sistemi di coordinate:
- Verifica che le relazioni tra i nodi dei tuoi oggetti virtuali, della telecamera di scena e del MegaTracker siano corrette, e che non siano stati modificati i valori del local transform dei nodi stessi sotto MegaBlocks.
- Un'impostazione errata dei nodi porta a conversioni di sistema di coordinate errate, causando comportamenti imprevedibili nel rendering del contenuto.

Avvertenza speciale: Problemi di sovrapposizione visiva su dispositivi OST (Optical See-Through)

Dopo aver completato la diagnosi della logica di posizionamento e rendering, se stai utilizzando un visore OST (Optical See-Through), devi considerare un caso speciale.

Anche se il dispositivo stesso ha una buona capacità di tracciamento del movimento 6DoF, a volte si può riscontrare un problema di "aderenza" insufficiente tra gli oggetti virtuali e lo spazio fisico. Questo solitamente non è un malfunzionamento del servizio di posizionamento Mega, ma un fenomeno intrinseco dovuto ai principi ottici dei dispositivi OST, come errori di allineamento ottico o differenze nella calibrazione dell'occhio umano.

Per una spiegazione dettagliata e metodi per identificare questi problemi, consulta la sezione introduttiva in Note speciali per dispositivi OST.

Riepilogo e best practice

Dopo la diagnosi precedente, dovresti aver identificato la causa principale dei salti o degli scostamenti del contenuto. Per una rapida revisione e azione, riassumiamo nella tabella seguente i fenomeni comuni, le possibili cause e le best practice. In base ai risultati della tua diagnosi, trova la soluzione corrispondente nella tabella.

Tipo di problema	Possibile causa	Best practice
Leggera vibrazione	Rumore del sensore, limite algoritmico	Questa leggera vibrazione è normale, generalmente non richiede particolare attenzione
Scostamento dopo movimento rapido	Ritardo SLAM, correzione algoritmica	Guida l'utente a muovere il dispositivo in modo fluido. Se non si riallinea rapidamente, richiede attenzione aggiuntiva
Scostamento persistente e ampio	Guasto SLAM, differenze tra dispositivi	Esegui test incrociati su dispositivi diversi
Salti/tremolii violenti	Scena confusa, ambiente non adatto al posizionamento	Imposta informazioni a priori di supporto o guida l'utente
Incoerenza con la posizione relativa degli oggetti reali	Errore di posizionamento/mappa, errore logico nel codice	Testa da più angolazioni, osserva la posizione degli oggetti virtuali, correggi eventuali errori nel codice

Se il problema persiste nonostante le diagnosi e le correzioni sopra descritte, raccogli registrazioni dello schermo, dati EIF e log dettagliati e inviaci un rapporto completo tramite il modulo Segnalazione problemi.

Table of Contents