Guide de dépannage des anomalies de suivi Mega

Mega utilise une technologie fusionnée client-serveur pour maintenir un suivi continu après le positionnement cloud, assurant un ancrage précis du contenu AR dans le monde réel. L'état de suivi idéal doit présenter une absence de dérive, de faibles vibrations et une grande fluidité. Ce document se concentre sur les problèmes de suivi lors du processus de positionnement Mega, vous aidant à comprendre les attentes correctes, la classification des erreurs courantes, l'impact des différences d'appareils, et à déterminer quand contacter le support technique EasyAR.

Effet attendu

Les anomalies de suivi proviennent généralement de la qualité des données de cartographie, de facteurs environnementaux ou de la compatibilité des appareils. Vous pouvez utiliser MegaToolbox pour diagnostiquer les problèmes. Si le problème concerne l'effet d'exécution de votre application, vous pouvez également tester directement avec celle-ci.

Avec un Mega Block de haute qualité et un environnement favorable, le suivi doit répondre aux critères suivants :

• Ancrage stable : Après un positionnement réussi, le contenu virtuel reste fixe dans les coordonnées mondiales sans dérive notable.
• Récupération robuste : Le suivi se rétablit automatiquement après une occlusion brève, une rotation rapide ou des changements lumineux.
• Fluidité des performances : Le rendu du contenu est normal, sans vibrations perceptibles.
• Limites environnementales : Près des murs unis, des sols vides, ou des surfaces vitrées/réfléchissantes, la qualité du suivi diminue.

Si votre expérience correspond à cette description, le suivi est normal.

Phénomène normal : Des vibrations légères ou des pertes brèves sont acceptables, surtout lors de la validation en création. Une stabilité prolongée est considérée comme normale.

Auto-diagnostic avec Mega Toolbox

Les anomalies de suivi apparaissent généralement après un positionnement réussi. Si elles surviennent dans votre application, vérifiez d'abord le comportement dans Mega Toolbox (voir Manuel d'utilisation de Mega Toolbox - Test de positionnement sur site et outil d'enregistrement des données de problème). Si les résultats diffèrent, vérifiez votre implémentation logicielle.

Étapes opérationnelles

1. Installez Mega Toolbox sur votre téléphone de test.
2. Ouvrez Toolbox, accédez à Test de positionnement sur site & Enregistrement des données de problème, connectez-vous avec vos identifiants.
3. Sélectionnez le mode SLAM et la bibliothèque de positionnement.
4. Déplacez le téléphone à l'emplacement problématique et observez l'affichage dans Toolbox.

Pour configurer la bibliothèque de positionnement et effectuer des tests sur site, référez-vous à Prévisualisation des effets d'exécution réels.

Interprétation des résultats dans Toolbox

Mega Toolbox est l'outil de diagnostic principal. Cette application mobile indépendante détermine si le problème vient de Mega ou de votre application.

• Anomalie de positionnement

  Si Toolbox affiche un état autre que Found ou NotFound, consultez le Guide de traitement des échecs de positionnement.

• Positionnement réussi

  L'état dans Toolbox est Found et le contenu s'affiche correctement.

  Comportements normaux :

  • Le contenu adhère bien à la scène avec des déplacements lents occasionnels
  • Correction immédiate si le contenu virtuel dépasse une certaine plage de déplacement

  Comportements anormaux :

  • Dérive constante du contenu dans une direction
  • Dérive puis correction répétée (effet "yo-yo")
  • Changement d'échelle progressif (agrandissement/rétrécissement)
  • Saut du contenu entre plusieurs positions

Classification des erreurs et dépannage

Utilisez Toolbox pour tester et suivez les recommandations selon le phénomène observé :

Type d'anomalie	Causes possibles	Recommandations
État de l'appareil toujours "NotTracking"	Environnement peu texturé, faible luminosité ou modèle de téléphone inadapté	Déterminez si c'est lié à l'environnement ou au modèle. Testez une autre zone ou un autre téléphone.
Dérive constante du contenu	Modèle de téléphone inadapté, dérive SLAM	Testez avec un modèle plus performant
Dérive puis correction répétée	Modèle de téléphone inadapté, dérive SLAM	Testez avec un modèle plus performant
Changement d'échelle progressif	Modèle de téléphone inadapté, dérive SLAM	Testez avec un modèle plus performant
Saut du contenu entre positions	Zones similaires dans la scène causant des interférences au démarrage	Démarrez le positionnement depuis une zone unique ou utilisez l'assistance Bluetooth

Tests complémentaires

Pour mieux identifier le problème, effectuez les tests suivants. Si vous êtes développeur, consultez Appareils et applications pris en charge par Mega.

Test avec un modèle supérieur

Les performances de suivi varient selon les appareils (qualité caméra, précision des capteurs, puissance processeur). Lors de la validation, testez avec plusieurs modèles pour garantir la compatibilité. Si le suivi est normal sur appareils ARKit/ARCore, le problème vient des limitations du téléphone testé. Pour les appareils moins performants, essayez différents modes SLAM.

Choix du mode SLAM

Sur certains modèles médiocres, la précision SLAM est affectée par les capteurs et la puissance de calcul. Dans la page Test de positionnement sur site de Toolbox, testez différents modes SLAM : FiveDof, ThreeDof ou ZeroDof pour comparer les effets.

Cas à signaler

La plupart des anomalies de suivi en création sont liées aux appareils, mais signalez ces cas à EasyAR si liés à l'algorithme Block ou au service :

• Dérive fréquente persistante après tests multi-appareils/multi-zones
• Échec ou anomalie de positionnement dans Toolbox
• Variations majeures d'efficacité d'un même Block selon la météo/lumière, non résolues par mise à jour

Si le problème persiste, fournissez au support EasyAR : description du problème, informations sur l'appareil, enregistrement vidéo de l'exécution, fichier EIF et détails du service Mega. Vérifiez avant envoi que l'EIF reproduit le problème dans Mega Studio.

Ce guide vous permet de diagnostiquer rapidement les anomalies de suivi lors de la création, améliorant ainsi la qualité globale des Mega Blocks.