Enregistrer des données EIF: preuves haute fidélité pour reproduire les problèmes AR
Dans les applications de réalité augmentée (AR), certains problèmes complexes de spatial localization, comme le jitter de tracking, le désalignement virtual-real ou la dérive du contenu, sont souvent difficiles à restituer entièrement avec de simples enregistrements d'écran ou logs. Pour cela, nous fournissons la fonction d'enregistrement de données EIF, un format propriétaire de dump de données haute fidélité qui peut enregistrer de manière synchronisée les informations clés suivantes:
- Informations de base de l'appareil, comme modèle, système et version SDK
- Frames d'image de caméra avec timestamp
- Matrice intrinsèque et matrice extrinsèque de la caméra de l'appareil
- Données de capteurs IMU
- Données supplémentaires d'entrées auxiliaires externes, comme GNSS
Pourquoi l'enregistrement de données EIF est-il important?
Important
Les données EIF capables de reproduire un problème sont inestimables.
Les données EIF peuvent reproduire complètement le contexte détaillé au moment où un problème survient, permettant à l'équipe de développement de reproduire précisément le scénario rencontré par l'utilisateur dans un environnement hors ligne et d'améliorer considérablement l'efficacité de localisation du problème. Par rapport aux enregistrements d'écran ou aux logs, EIF présente les avantages suivants:
- Reproduction précise: les développeurs peuvent relire directement les données EIF dans les outils de débogage pour reproduire le Bug que vous avez rencontré.
- Diagnostic bas niveau: grâce à une analyse complète de divers types de données, comme images, capteurs et entrées externes, les développeurs peuvent déterminer à quelle étape technique se situe le problème.
- Gain de temps: évite de longs cycles de communication et raccourcit fortement le cycle entre le signalement du problème et sa résolution.
Comment enregistrer des données EIF
EasyAR fournit deux façons d'enregistrer des données EIF.
- Utiliser directement les API fournies par le SDK pour implémenter la fonction d'enregistrement de données EIF dans votre application.
- Utiliser l'application officielle Mega Toolbox App. Cela convient généralement au développement EasyAR Mega et au feedback de problèmes.
Pour les étapes détaillées, consultez notre documentation technique afin d'obtenir les guides d'opération correspondant à votre méthode d'utilisation et à votre appareil.
Astuce
Consultez le lien suivant pour voir comment implémenter l'enregistrement EIF intégré à l'application via des appels API: Input frame recording and simulated runtime.
Consultez le lien suivant pour voir le guide d'utilisation de Mega Toolbox App: Use Toolbox to record mobile EIF files.
Aperçu rapide du processus d'enregistrement, avec Mega Toolbox App comme exemple:
- Ouvrez Mega Toolbox App et appuyez sur
On-site Verification and Diagnostics Tool. - Connectez-vous à votre compte, sélectionnez votre localization library et commencez le test.
- Essayez de reproduire votre problème. Trouvez un mode opératoire qui reproduit le problème de manière stable, comme l'orientation de l'appareil, la façon de parcourir ou le point de prise de vue.
- Lorsque tout est prêt, appuyez sur le bouton rouge "Record" pour commencer l'enregistrement.
- Après l'apparition du problème, appuyez sur le bouton rouge "Stop and Save".
- Le système générera automatiquement un fichier EIF. Connectez l'appareil à un ordinateur, exportez-le vers le stockage local, puis soumettez-le.
Note
Les fichiers EIF peuvent être volumineux, de plusieurs centaines de MB à plusieurs GB. Il est recommandé d'enregistrer uniquement le segment central contenant le problème, généralement 10-30 secondes suffisent.
Suggestions de bonnes pratiques
Pour que votre feedback puisse être traité efficacement, incluez en même temps les quatre types d'informations suivants lors de la soumission:
| Type d'information | Description |
|---|---|
| Fichier de données EIF | Preuve diagnostique centrale, doit contenir le processus de reproduction du problème |
| Description subjective du phénomène | Décrivez clairement le comportement observé, par exemple "la flèche de navigation a soudainement sauté au plafond lors d'un virage à gauche" |
| Enregistrement d'écran ou screenshot | Aide à visualiser le problème et montre intuitivement "ce que l'utilisateur a finalement vu" |
| Informations de contexte auxiliaires | Inclut: • Le modèle de votre appareil et la version du système d'exploitation • La version de EasyAR SDK utilisée par votre application • La description de l'environnement où le problème s'est produit (indoor/outdoor, éclairage, taille de l'espace) • Les applications de type Mega doivent fournir en plus les informations de localization library, exportables depuis l'Unity tool • Les applications de type CRS cloud recognition doivent fournir en plus les informations de cloud recognition library |
Astuce
Exemple: "Sur Apple Vision Pro (visionOS 26) avec EasyAR Sense Unity Plugin 4000.0.1, pendant une navigation dans un centre commercial indoor, le chemin de navigation est soudainement devenu incorrect à un endroit. Fichier EIF enregistré: avp_wrong_path_20251218.mkveif, avec enregistrement d'écran, photos de l'environnement et informations de localization library jointes: MegaStudio_ServiceInfo_myaccount_2025-12-18_10-33-26.json."
En fournissant le paquet complet d'informations ci-dessus, vous accélérerez fortement l'analyse et la correction du problème. Merci pour votre coopération!