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:
- Analisi log Android
- Analisi log iOS/macOS/visionOS
- Analisi log Windows
- Analisi crash Android
- Analisi crash iOS/macOS/visionOS
- Analisi crash Windows
- Analisi anomalie visive Screenshot e registrazioni
- Analisi anomalie visive Registrazioni per visori XR
- Analisi anomalie visive Riproduzione con EIF
- Introduzione a Unity
- Messaggi UI Unity
- Modalità sviluppatore Unity
- Registrazione file dump EED Unity
- Segnalazione problemi Unity
- Riferimento componente Diagnostics Controller Unity