Enregistrement de données EIF : preuves haute fidélité pour reproduire les problèmes RA

Dans les applications de réalité augmentée (RA), certains problèmes complexes de localisation spatiale (comme les tremblements de suivi, les décalages virtuel-réel ou la dérive des contenus) sont souvent difficiles à reproduire intégralement par simple enregistrement d'écran ou journaux. Pour cela, nous fournissons une fonction d'enregistrement de données EIF — un format propriétaire haute fidélité de vidage de données, capable d'enregistrer simultanément les informations clés suivantes :

• Informations de base de l'appareil (modèle, système, version du SDK, etc.)
• Images de la caméra avec horodatage
• Matrice de paramètres intrinsèques et extrinsèques de la caméra de l'appareil
• Données des capteurs IMU
• Données supplémentaires d'entrées externes (par exemple GNSS)

Pourquoi l'enregistrement des données EIF est-il crucial ?

Important

Les données EIF permettant de reproduire un problème sont inestimables.

Les données EIF reconstituent fidèlement le contexte détaillé lors de l'apparition d'un problème, permettant aux équipes de développement de reproduire avec précision le scénario rencontré par l'utilisateur dans un environnement hors ligne, améliorant ainsi considérablement l'efficacité du diagnostic. Comparé aux captures d'écran ou aux journaux, l'EIF présente les avantages suivants :

1. Reproduction précise : les développeurs peuvent rejouer directement les données EIF dans les outils de débogage pour reproduire le bogue rencontré.
2. Diagnostic approfondi : grâce à l'analyse complète des données (images, capteurs, entrées externes, etc.), les développeurs peuvent identifier l'origine technique du problème.
3. Gain de temps : évite les cycles de communication prolongés, réduisant considérablement le délai entre le signalement et la résolution du problème.

Comment enregistrer des données EIF

EasyAR propose deux méthodes d'enregistrement de données EIF.

1. Utilisation directe des API fournies par le SDK pour implémenter la fonction d'enregistrement EIF dans votre application.
2. Utilisation de l'application officielle Mega Toolbox App. Généralement adaptée au développement EasyAR Mega et au signalement de problèmes.

Reportez-vous à notre documentation technique pour les étapes opérationnelles spécifiques adaptées à votre mode d'utilisation et à votre appareil.

Astuce

Consultez le lien suivant pour implémenter l'enregistrement EIF dans l'application via les API : Enregistrement et simulation d'images d'entrée.

Consultez le lien suivant pour le guide d'utilisation de Mega Toolbox App : Enregistrement de fichiers EIF mobiles avec Toolbox.

Aperçu du processus d'enregistrement (exemple avec Mega Toolbox App) :

1. Ouvrez Mega Toolbox App, appuyez sur "Test de localisation sur site & enregistrement des données pour les retours de problèmes de localisation".
2. Connectez-vous à votre compte, sélectionnez votre bibliothèque de localisation et commencez le test.
3. Essayez de reproduire votre problème. Identifiez un mode opératoire reproduisant le problème de manière stable (orientation de l'appareil, méthode de navigation, point de prise de vue, etc.).
4. Une fois prêt, appuyez sur le bouton rouge "Enregistrer" pour démarrer l'enregistrement.
5. Après l'apparition du problème, appuyez sur le bouton rouge "Arrêter et enregistrer".
6. Le système générera automatiquement un fichier EIF ; exportez-le vers le stockage local après connexion de l'appareil à un ordinateur, puis soumettez-le.

Note

Les fichiers EIF peuvent être volumineux (centaines de Mo à plusieurs Go), il est recommandé d'enregistrer uniquement le fragment principal contenant le problème (généralement 10 à 30 secondes suffisent).

Recommandations de meilleures pratiques

Pour garantir un traitement efficace de votre retour, veuillez inclure les quatre types d'informations suivants lors de la soumission :

Type d'information	Description
Fichier de données EIF	Preuve centrale de diagnostic, doit inclure le processus de reproduction du problème
Description subjective du phénomène	Expliquez clairement le comportement observé (ex. : "la flèche de navigation a soudainement sauté au plafond lors d'un virage à gauche")
Capture d'écran ou enregistrement	Visualisation complémentaire du problème, montrant "ce que l'utilisateur voit finalement"
Informations contextuelles supplémentaires	Comprend : • Votre modèle d'appareil et version du système d'exploitation • Numéro de version du SDK EasyAR utilisé par votre application • Description de l'environnement où le problème est survenu (intérieur/extérieur, éclairage, taille de l'espace) • Les applications Mega nécessitent des informations supplémentaires sur la bibliothèque de localisation, exportables via l'outil Unity • Les applications de reconnaissance cloud CRS nécessitent des informations supplémentaires sur la bibliothèque de reconnaissance cloud

Astuce

Exemple : "Sur Apple Vision Pro (visionOS 26) avec EasyAR Sense Unity Plugin 4000.0.1, lors d'une navigation dans un centre commercial intérieur, le tracé de navigation est devenu erroné à un emplacement spécifique. Fichier EIF enregistré : avp_wrong_path_20251218.mkveif, avec capture d'écran, photos de l'environnement et informations de la bibliothèque de localisation : MegaStudio_ServiceInfo_myaccount_2025-12-18_10-33-26.json."

En fournissant ce dossier d'informations complet, vous accélérerez significativement le processus d'analyse et de correction du problème. Merci pour votre collaboration !