Collecte de données de diagnostic Mega
Ce guide vise à fournir des instructions standardisées pour la collecte de données en cas d'anomalies visuelles. Grâce à une collecte et un retour d'information normalisés, il aide les développeurs à décrire précisément les problèmes et assiste l'équipe technique d'EasyAR à identifier, reproduire et résoudre efficacement les dysfonctionnements liés au positionnement visuel.
Présentation du contenu
Lors de l'intégration du service de positionnement EasyAR Mega, une collecte précise des données est essentielle pour le diagnostic des problèmes. Ce guide couvre les étapes clés suivantes :
- Identification des problèmes : Classification et évaluation préliminaire des phénomènes anormaux courants.
- Normes de capture d'écran et d'enregistrement : Méthodes de collecte visuelle adaptées à différentes plateformes d'appareils.
- Collecte de données d'exécution : Extraction et exportation des données d'environnement d'exécution sur chaque plateforme.
- Normes de feedback : Garantir le "jeu d'informations minimal" nécessaire à l'équipe technique pour reproduire le problème.
Classification des anomalies et évaluation préliminaire
Avant de signaler un problème, identifiez l'anomalie en vous référant aux catégories suivantes :
Manifestations anormales courantes
- Positionnement totalement impossible : Impossible de reconnaître la scène, l'état reste "NotFound".
- Déviation de précision du positionnement : Positionnement réussi mais manque de précision, avec un décalage spatial notable.
- Positionnement instable : Secousses, dérive de l'image ou perte fréquente du suivi.
- Anomalies régionales : Performance de positionnement médiocre dans des zones ou points spécifiques.
- Différences de compatibilité des appareils : Performance inférieure sur certains modèles spécifiques.
Causes potentielles présumées
- Liées à la scène : Positionnement décalé du contenu, qualité de cartographie médiocre, faible luminosité ou points caractéristiques rares (ex: grands murs blancs), interférences de points similaires.
- Environnement technique : Instabilité réseau, service impayé, dépassement du QPS, compatibilité de version du SDK, erreur logique d'appel d'API.
- Autorisations matérielles : Capteurs (IMU) non pris en charge pour le suivi de mouvement, permissions caméra ou stockage non activées.
Processus de feedback normalisé
Pour améliorer l'efficacité du dépannage, nous vous recommandons vivement de soumettre un package complet comprenant les trois parties suivantes :
Liste d'informations de base (jeu minimal d'informations)
- Identifiants ressources : Informations de compte, AppId Mega, Block Id.
- Informations de version : Version d'EasyAR Sense SDK ou version du plugin mini-programme.
- Description détaillée du problème : Description précise du phénomène anormal et conditions de déclenchement.
- Paramètres environnementaux : Modèle d'appareil, version du système d'exploitation, version WeChat, environnement réseau actuel (4G/5G/WiFi).
Preuves visuelles (vidéos et captures d'écran)
- Enregistrement du processus de reproduction : Capture complète du processus de positionnement, du démarrage à l'apparition de l'anomalie.
- Capture d'écran des images clés : Capture instantanée au moment exact de l'anomalie.
- Enregistrement multi-angles : Références visuelles sous différentes positions et conditions d'éclairage.
Données d'exécution (base essentielle du dépannage)
- Données EIF : Enregistrement d'exécution basé sur EasyAR Sense, permettant une analyse en relecture sur PC.
- Données Dump : Instantané d'état d'exécution spécifique aux mini-programmes WeChat.
- Journaux d'application : Logs d'exécution de l'app (Logcat/Console) et pile d'erreurs.
Astuce
Pour aller plus loin : Comment communiquer clairement une description détaillée du problème
Environnement d'exécution et méthodes de collecte
Les méthodes de collecte de données varient selon l'appareil et la plateforme. Veuillez choisir les instructions correspondant à votre environnement réel.
Classification des appareils
- Appareils mobiles : Smartphones (iOS/Android).
- Appareils à casque :
- OST (Optical See-Through) : Transparente optique (ex: XREAL, Rokid).
- VST (Video See-Through) : Vidéo transparente (ex: Apple Vision Pro, PICO).
Instructions pour captures et enregistrements
| Type de plateforme | Guide de référence |
|---|---|
| Téléphone / Mini-programme WeChat | Capture et enregistrement mobile, exportation |
| Casque OST | Enregistrement et exportation OST |
| Casque VST | Enregistrement et exportation VST |
Collecte de données d'exécution (EIF/Dump)
| Type de scénario | Solution de collecte |
|---|---|
| Application native EasyAR Sense | Enregistrement EIF application mobile / Enregistrement EIF casque |
| Mini-programme WeChat | Enregistrement et exportation Dump mini-programme |
| Outil de collecte rapide | Enregistrement EIF Mega Toolbox / Enregistrement Dump Toolbox |
Fonction de collecte automatique (bientôt disponible)
Nous lancerons prochainement une mise à jour permettant une collecte et un feedback automatiques, offrant un moyen plus pratique de soumission des données :
- Enregistrement en arrière-plan : Lancez à la demande la collecte des jeux de données nécessaires
- Téléversement automatique : Empaquètement et téléversement automatiques à l'équipe technique EasyAR
- Capture à la demande : Capture autonome en temps réel des états anormaux
- Suivi de progression : Classement et suivi continu
Navigation des guides opérationnels
Selon les besoins de votre plateforme, accédez directement au guide opérationnel détaillé :
| Type | Guide collecte captures/enregistrements | Guide collecte données d'exécution |
|---|---|---|
| Application mobile | Capture et enregistrement mobile, exportation | Enregistrement EIF app mobile, Enregistrement EIF Mega Toolbox, Instructions export EIF |
| Casque OST | Enregistrement et exportation OST | Enregistrement/export EIF appareils casque |
| Casque VST | Enregistrement et exportation VST | Enregistrement/export EIF appareils casque |
| Mini-programme WeChat | Capture et enregistrement mobile, exportation | Enregistrement/export Dump mini-programme WeChat, Enregistrement Dump Toolbox mini-programme |
Bonnes pratiques recommandées
- Processus de pré-étude : Avant le lancement du projet, familiarisez l'équipe avec le processus de collecte.
- Auto-vérification préalable : Avant le feedback, vérifiez si les problèmes liés à l'environnement technique, au placement du contenu ou aux permissions de l'appareil sont exclus.
- Exhaustivité des données : Collecte normalisée et complète : jeu minimal d'informations, vidéo/photo de l'anomalie visuelle, données d'exécution.
- Communication rapide : Après soumission des données complètes, maintenez la communication avec l'équipe technique EasyAR.
Canaux de support technique
- Documentation : Consultez Documentation Mega ou Dépannage.
- Support technique : Contactez-nous ou envoyez un email à support@sightp.com.
Prochain sujet : Méthode de capture et d'exportation mobile