Table of Contents

Diagnostica e segnalazione dei problemi

Questo capitolo descrive i potenziali problemi durante lo sviluppo di applicazioni AR, i principali metodi di analisi e le informazioni necessarie per segnalare i problemi insieme ai canali di contatto.

Sfide nell'analisi dei problemi negli scenari AR

L'analisi dei problemi negli scenari AR presenta sfide uniche.

Incertezza dell'input

Nelle applicazioni tradizionali, l'input è solitamente costituito da eventi determinati come clic o pressioni di tasti. In AR, l'input deriva da ambienti fisici variabili, il che introduce notevoli difficoltà analitiche. Le applicazioni AR devono essere utilizzate in combinazione con l'ambiente fisico, ma durante lo sviluppo e i test è impossibile ottenere ogni volta lo stesso input. Anche seguendo lo stesso percorso, i dati dei sensori come immagini della fotocamera, accelerometro e giroscopio possono variare, influenzando significativamente i risultati del tracking.

EasyAR offre funzionalità di registrazione e riproduzione dei file EIF, che possono mitigare parzialmente l'incertezza dell'input. Tuttavia, a causa dell'incertezza intrinseca degli algoritmi, i risultati finali del tracking rimangono fondamentalmente indeterminati. Inoltre, dati di registrazione EIF incompleti, variazioni di illuminazione e oclusioni dinamiche causate da pedoni o veicoli influenzano la qualità del tracking durante l'uso effettivo.

Incertezza algoritmica

Gli algoritmi fondamentali dell'AR, come lo SLAM (localizzazione e mappatura simultanee), sono per natura probabilistici anziché deterministici.

Quando le immagini della fotocamera in input mancano di caratteristiche distintive, gli algoritmi possono utilizzare posizioni/orientamenti storici e dati di sensori come accelerometro e giroscopio per effettuare previsioni. I risultati predittivi di posizione e orientamento accumulano deriva nel tempo. Poiché ogni previsione dipende da fattori esterni dinamici come tempistiche di ricezione dati, temperatura del dispositivo, frequenza della CPU e velocità di trasmissione di rete, anche con input identici, i risultati di esecuzioni multiple possono divergere significativamente.

Metodi di analisi per diversi problemi

Problemi diversi possono richiedere approcci analitici differenti.

Log

Per situazioni di funzionamento anomalo come schermate nere, mancato posizionamento o tracking irregolare, il metodo fondamentale consiste nell'esaminare i log per verificare la presenza di messaggi di errore. I log generati da EasyAR utilizzano etichette specifiche per una facile identificazione.

Crash

A volte l'applicazione può subire crash, che possono verificarsi nel codice della libreria o nel codice dell'applicazione stessa. Le cause possono risiedere sia nell'applicazione che nella libreria.

Anomalie visive come tremolii o salti

A causa di imprecisioni nei dati dei sensori o problemi di adattamento algoritmico, possono verificarsi tremolii o salti nel posizionamento. In questi casi, è consigliabile riprodurre il problema su diversi dispositivi, acquisendo screenshot, registrazioni dello schermo e file EIF.

Guide specifiche per piattaforma

La diagnostica e segnalazione dei problemi è strettamente legata alla piattaforma. Fare riferimento alle seguenti guide in base alla piattaforma target: