Problemdiagnose und Berichterstattung
Dieses Kapitel beschreibt mögliche Probleme beim Erstellen von AR-Anwendungen, Hauptanalysemethoden sowie die erforderlichen Informationen und Kontaktwege zur Problemberichterstattung.
Herausforderungen bei der Problemanalyse in AR-Szenarien
Die Problemanalyse in AR-Szenarien birgt einige einzigartige Herausforderungen.
Unsicherheit der Eingaben
In herkömmlichen Anwendungen sind Eingaben typischerweise deterministische Klicks oder Tastaturereignisse. Bei AR hingegen stammen Eingaben aus sich verändernden physischen Umgebungen, was die Analyse erheblich erschwert. AR-Anwendungen müssen in physischen Umgebungen genutzt werden, doch während Entwicklung und Tests ist es unmöglich, bei jedem Durchlauf identische Eingaben zu erhalten. Selbst bei identischen Routen können Kamerabilder, Beschleunigungsmesser-, Gyroskop- und andere Sensordaten variieren – was erhebliche Auswirkungen auf Tracking-Ergebnisse haben kann.
EasyAR bietet eine EIF-Datei-Aufzeichnungs- und Wiedergabefunktion, die Eingabeunsicherheiten teilweise mildern kann. Aufgrund algorithmischer Unsicherheiten bleiben Tracking-Ergebnisse jedoch grundlegend probabilistisch. Zudem beeinträchtigen unvollständige EIF-Aufnahmedaten, Lichtveränderungen oder dynamische Verdeckungen durch Personen/Fahrzeuge die Tracking-Qualität im praktischen Einsatz.
Algorithmische Unsicherheit
Kernalgorithmen von AR – wie SLAM (Simultaneous Localization and Mapping) – sind grundlegend probabilistisch, nicht deterministisch.
Bei fehlenden markanten Merkmalen in Kamerabildern nutzen Algorithmen historische Positionen, Beschleunigungsmesser- und Gyroskopdaten für Vorhersagen. Diese vorhergesagten Positionen akkumulieren mit der Zeit Driftfehler. Da Vorhersageergebnisse und Datenverarbeitungszeitpunkte von externen Faktoren wie Gerätetemperatur, CPU-Frequenz oder Netzwerkgeschwindigkeit abhängen, variieren Ergebnisse selbst bei identischen Eingaben erheblich bei wiederholten Durchläufen.
Analysemethoden für unterschiedliche Probleme
Verschiedene Probleme können unterschiedliche Analysemethoden erfordern.
Protokolle
Bei Funktionsstörungen wie Schwarzbild, fehlender Lokalisierung oder instabilem Tracking ist die Basisanalyse die Protokollprüfung auf Fehlermeldungen. EasyAR generierte Protokolle verwenden spezifische Tags zur Identifizierung.
Abstürze
Programmabstürze können in Bibliotheks- oder eigenem Code auftreten. Ursachen können sowohl in der Anwendung als auch in Bibliotheken liegen.
Visuelle Anomalien wie Zittern oder Springen
Sensorungenauigkeiten oder Algorithmeninkompatibilitäten können zu Lokalisierungszittern/-springen führen. Reproduzieren Sie das Problem auf verschiedenen Geräten und erfassen Sie Screenshots, Bildschirmaufnahmen und EIF-Dateien.
Plattformspezifische Leitfäden
Problemdiagnose und -berichterstattung sind plattformabhängig. Nutzen Sie für Ihre Zielplattform folgende Leitfäden:
- Protokollanalyse Android
- Protokollanalyse iOS/macOS/visionOS
- Protokollanalyse Windows
- Absturzanalyse Android
- Absturzanalyse iOS/macOS/visionOS
- Absturzanalyse Windows
- Visuelle Anomalienanalyse Screenshots und Aufnahmen
- Visuelle Anomalienanalyse XR-Headset-Aufnahmen
- Visuelle Anomalienanalyse EIF-basierte Reproduktion
- Unity Einführung
- Unity UI-Nachrichten
- Unity Entwicklermodus
- Unity EED-Dump-Aufzeichnung
- Unity Problembericht
- Unity Diagnostics Controller Komponentenreferenz