EIF-Daten aufzeichnen: Hochpräzise Grundlage zur Reproduktion von AR-Problemen
In Augmented-Reality-Anwendungen (AR) lassen sich einige komplexe spatial localization-Probleme, etwa tracking-Jitter, virtual-real-Fehlausrichtung oder Content-Drift, oft nur mit Bildschirmaufzeichnungen oder Logs schwer vollständig wiederherstellen. Dafür stellen wir die EIF-Datenaufzeichnung bereit, ein proprietäres hochpräzises Daten-Dump-Format, das die folgenden Schlüsselinformationen synchron aufzeichnen kann:
- Grundlegende Geräteinformationen wie Modell, System und SDK-Version
- Kamerabild-Frames mit timestamp
- Intrinsische und extrinsische Kameramatrix des Geräts
- IMU-Sensordaten
- Zusätzliche Daten aus externen Hilfseingaben, etwa GNSS
Warum ist die Aufzeichnung von EIF-Daten wichtig?
Wichtig
EIF-Daten, die ein Problem reproduzieren können, sind unschätzbar wertvoll.
EIF-Daten können den detaillierten Kontext beim Auftreten eines Problems vollständig wiederherstellen, sodass das Entwicklungsteam das Benutzerszenario in einer Offline-Umgebung präzise reproduzieren und die Effizienz der Problemlokalisierung erheblich steigern kann. Im Vergleich zu Bildschirmaufzeichnungen oder Logs bietet EIF folgende Vorteile:
- Präzise Reproduktion: Entwickler können EIF-Daten direkt in Debugging-Tools wiedergeben, um den von Ihnen gefundenen Bug zu reproduzieren.
- Low-Level-Diagnose: Durch umfassende Analyse verschiedener Daten, etwa Bilder, Sensoren und externe Eingaben, können Entwickler bestimmen, an welcher technischen Stelle das Problem entstanden ist.
- Zeitersparnis: Vermeidet lange Kommunikationsschleifen und verkürzt den Zyklus von der Problemmeldung bis zur Lösung deutlich.
EIF-Daten aufzeichnen
EasyAR bietet zwei Möglichkeiten zur Aufzeichnung von EIF-Daten.
- Verwenden Sie direkt die vom SDK bereitgestellten APIs, um die EIF-Datenaufzeichnung in Ihrer Anwendung zu implementieren.
- Verwenden Sie die offizielle Mega Toolbox App. Dies eignet sich normalerweise für EasyAR Mega-Entwicklung und Problemfeedback.
Detaillierte Schritte finden Sie in unserer technischen Dokumentation, um Bedienungsanleitungen für Ihre Nutzungsweise und Ihr Gerät zu erhalten.
Tipp
Unter folgendem Link erfahren Sie, wie Sie die In-App-EIF-Aufzeichnung durch API-Aufrufe implementieren: Input frame recording and simulated runtime.
Unter folgendem Link finden Sie die Bedienungsanleitung zur Mega Toolbox App: Use Toolbox to record mobile EIF files.
Kurzer Überblick über den Aufnahmeprozess, am Beispiel der Mega Toolbox App:
- Öffnen Sie die Mega Toolbox App und tippen Sie auf
On-site Verification and Diagnostics Tool. - Melden Sie sich bei Ihrem Konto an, wählen Sie Ihre localization library aus und beginnen Sie mit dem Test.
- Versuchen Sie, Ihr Problem zu reproduzieren. Finden Sie ein Bedienmuster, das das Problem stabil reproduzieren kann, etwa Geräteausrichtung, Betrachtungsweise oder Aufnahmepunkt.
- Wenn alles bereit ist, tippen Sie auf die rote Schaltfläche "Record", um die Aufnahme zu starten.
- Nachdem das Problem aufgetreten ist, tippen Sie auf die rote Schaltfläche "Stop and Save".
- Das System generiert automatisch eine EIF-Datei. Verbinden Sie das Gerät mit einem Computer, exportieren Sie sie in den lokalen Speicher und reichen Sie sie ein.
Anmerkung
EIF-Dateien können groß sein, von mehreren hundert MB bis zu mehreren GB. Es wird empfohlen, nur den Kernabschnitt mit dem Problem aufzuzeichnen, normalerweise reichen 10-30 Sekunden.
Best-Practice-Empfehlungen
Damit Ihr Feedback effizient verarbeitet werden kann, fügen Sie bei der Einreichung gleichzeitig die folgenden vier Arten von Informationen bei:
| Informationstyp | Beschreibung |
|---|---|
| EIF-Datendatei | Zentrale Diagnosegrundlage, muss den Prozess zur Problemreproduktion enthalten |
| Subjektive Beschreibung des Phänomens | Beschreiben Sie das beobachtete Verhalten klar, z. B. "der Navigationspfeil sprang beim Linksabbiegen plötzlich an die Decke" |
| Bildschirmaufnahme oder screenshot | Hilft bei der Visualisierung des Problems und zeigt anschaulich, "was der Benutzer am Ende gesehen hat" |
| Zusätzliche Kontextinformationen | Umfasst: • Ihr Gerätemodell und die Betriebssystemversion • Die von Ihrer Anwendung verwendete EasyAR SDK-Version • Beschreibung der Umgebung, in der das Problem auftrat (indoor/outdoor, Licht, Raumgröße) • Mega-Anwendungen müssen zusätzlich Informationen zur localization library bereitstellen, die aus dem Unity tool exportiert werden können • CRS cloud recognition-Anwendungen müssen zusätzlich Informationen zur cloud recognition library bereitstellen |
Tipp
Beispiel: "Auf Apple Vision Pro (visionOS 26) mit EasyAR Sense Unity Plugin 4000.0.1, Navigation in einem indoor-Einkaufszentrum, an einer bestimmten Stelle wurde die Navigationsroute plötzlich falsch. EIF-Datei aufgezeichnet: avp_wrong_path_20251218.mkveif, mit Bildschirmaufnahme, Umgebungsfotos und Informationen zur localization library: MegaStudio_ServiceInfo_myaccount_2025-12-18_10-33-26.json."
Durch Bereitstellung des vollständigen Informationspakets oben beschleunigen Sie Analyse und Behebung des Problems erheblich. Vielen Dank für Ihre Unterstützung!