Table of Contents

Diagnosi e segnalazione dei problemi

Questo capitolo descrive principalmente i problemi che possono verificarsi durante la creazione di applicazioni AR, i principali metodi di analisi, e le informazioni e i canali di contatto da raccogliere quando si segnalano problemi.

Sfide dell'analisi dei problemi negli scenari AR

L'analisi dei problemi negli scenari AR presenta alcune sfide particolari.

Incertezza dell'input

Nelle applicazioni tradizionali, l'input è di solito un clic o evento tastiera deterministico. In AR, invece, l'input proviene da un ambiente fisico variabile, il che rende l'analisi molto più difficile. Le applicazioni AR devono essere usate insieme all'ambiente fisico, ma durante sviluppo e test non è possibile ottenere ogni volta lo stesso input nell'ambiente fisico. Anche seguendo lo stesso percorso, immagini della camera e dati di sensori come accelerometro e giroscopio possono variare, e queste variazioni possono influire molto sui risultati di tracking.

EasyAR fornisce funzioni di registrazione e playback dei file EIF, che possono ridurre in parte l'incertezza dell'input. Tuttavia, a causa dell'incertezza dell'algoritmo, il risultato finale di tracking resta intrinsecamente incerto. Inoltre, copertura incompleta dei dati registrati EIF, cambiamenti di illuminazione e occlusioni dinamiche causate da pedoni o veicoli possono influire sulla qualità del tracking nell'uso reale.

Incertezza dell'algoritmo

Gli algoritmi centrali di AR sono algoritmi visivi, come SLAM (simultaneous localization and mapping). Questi algoritmi sono per natura probabilistici e non deterministici.

Quando l'immagine camera in input manca di caratteristiche evidenti, l'algoritmo può usare posizione e pose storiche e dati di sensori come accelerometro e giroscopio per la previsione. I risultati previsti di posizione e pose si accumulano nel tempo e producono drift. Ogni risultato di previsione è legato a fattori esterni come il momento di ingresso dei dati, la temperatura del dispositivo, la frequenza CPU e la velocità di trasmissione di rete. Questi fattori cambiano dinamicamente, quindi anche con lo stesso input i risultati di più esecuzioni possono differire molto.

Metodi di analisi per problemi diversi

Problemi diversi possono richiedere metodi di analisi diversi.

Log

Per casi in cui il programma non funziona correttamente, come schermo nero, impossibilità di localization o impossibilità di tracking normale, il metodo più basilare è controllare i log e verificare la presenza di messaggi di errore. I log generati da EasyAR usano tag specifici per facilitarne l'identificazione.

Crash

A volte il programma può andare in crash. Il punto del crash può essere nel codice della libreria o nel codice del programma stesso. La causa può essere un problema del programma o un problema della libreria.

Anomalie visive come jitter e salti

A causa della precisione dei dati dei sensori o dell'adattamento dell'algoritmo, possono verificarsi jitter o salti di localization. In questo caso, provare a riprodurre il problema su dispositivi diversi e acquisire screenshot, registrazioni schermo e file EIF.

Guide specifiche per piattaforma

La diagnosi e la segnalazione dei problemi sono strettamente correlate alla piattaforma. In base alla piattaforma target, consultare le guide seguenti per lo sviluppo: