Table of Contents

Diagnose et résolution : tremblement du contenu

Ce guide aborde les problèmes de tremblement, dérive ou saut du contenu virtuel lors du suivi d'images planes, aidant les développeurs à distinguer les tremblements normaux des anomalies, et fournit des méthodes systématiques d'investigation et d'amélioration.

Distinguer le « tremblement normal »

Comprendre les situations suivantes permet d'éviter une optimisation excessive ou une erreur de diagnostic :

Déplacement léger (normal)

  • Manifestation : Léger flottement ou rotation lente du contenu virtuel de quelques pixels.
  • Scénario :
    • Éclairage inégal (ex. variations lumineuses en intérieur)
    • Ajustement automatique de la mise au point ou de l'exposition de la caméra
    • Tremblement léger de l'appareil (sans trépied)
  • Attendu : Ces scénarios sont difficiles à éviter, aucun traitement particulier requis.

Tremblement passager (normal)

  • Manifestation : Tremblement du contenu virtuel pendant 0,5 à 1 seconde lors d'un déplacement rapide de l'appareil ou de l'image cible, puis stabilisation.
  • Scénario :
    • Transition du statique au dynamique
    • Phase initiale de reconnaissance de l'image cible entrant dans le champ de vision
  • Attendu : Fait partie du processus de convergence de l'algorithme, le rétablissement rapide est normal.

Tremblement en bordure (normal)

  • Manifestation : Léger saut du contenu virtuel lorsque l'image est en bordure du champ de vision ou proche de la perte de suivi.
  • Scénario :
    • Image partiellement occultée (ex. doigt couvrant le bord)
    • Extrapolation du champ de vision de la caméra
  • Attendu : Résulte d'une information de suivi partiellement manquante (limite algorithmique), il est conseillé de guider l'utilisateur à maintenir l'image au centre du champ de vision.

Causes courantes du tremblement anormal et améliorations

Les tremblements suivants sont problématiques et nécessitent une résolution ciblée :

Mauvaise qualité de l'image cible

Phénomène : Tremblement haute fréquence continu du contenu virtuel, sauts aléatoires ou disparitions fréquentes.
Méthode d'investigation :

Conseils d'amélioration :

  • Optimiser l'image :
    • Augmenter le contraste local.
    • Éviter les zones unicolores, ajouter des textures subtiles.
    • Éviter les textures répétitives.

Performances matérielles insuffisantes

Phénomène : Tremblement plus marqué ou perte de suivi plus facile sur les appareils bas de gamme comparé aux modèles milieu/haut de gamme.
Méthode d'investigation :

  • Vérifier l'utilisation du CPU : Utiliser l'outil Profiler pour surveiller le taux d'utilisation du CPU de l'application.

Conseils d'amélioration :

  • Activer le mode performance : Définir ImageTrackerMode sur PreferPerformance, sacrifiant une légère précision pour la fluidité.
  • Réduire le nombre de suivis : Si le suivi multi-cibles est activé, réduire modérément Simultaneous Number.
  • Adapter par plateforme : Fournir une scène simplifiée pour les appareils bas de gamme.

Interférences environnementales

Phénomène : Tremblement dans des conditions d'éclairage ou d'arrière-plan spécifiques, disparaissant après changement d'environnement.
Méthode d'investigation :

  • Test d'éclairage : Tester séparément sous un éclairage uniforme (ex. temps nuageux) et sous fort éclairage/ombres contrastées.
  • Interférence de l'arrière-plan : Vérifier si l'arrière-plan de la caméra est trop encombré (ex. déplacements de personnes).
  • Interférence par réflexion : La surface physique de l'image cible est-elle réfléchissante (ex. verre, métal) ?

Conseils d'amélioration :

  • Contrôler l'éclairage : Recommander aux utilisateurs un environnement à éclairage uniforme, évitant la lumière directe ou les ombres marquées.
  • Optimisation physique : Si l'image est sur une surface réfléchissante, appliquer un film mat ou l'imprimer sur un support physique.

Tremblement localisé marqué du contenu

Phénomène : La scène virtuelle est étendue, le contenu proche de l'entité physique cible tremble peu, mais celui éloigné tremble nettement.
Méthode d'investigation :

  • Réduire le contenu : Diminuer uniformément le Scale du contenu virtuel dans la scène, puis retester dans les mêmes conditions.

Conseils d'amélioration :

  • Ajuster le contenu : Un contenu virtuel trop étendu amplifie l'erreur angulaire dans les zones éloignées (ex. une erreur de 0,1° entraîne un décalage de 0,1 cm près de la cible, mais de 10 cm au loin). Adaptez la taille du contenu virtuel par rapport aux dimensions physiques de l'image cible lors de la conception.

Résumé et meilleures pratiques

Le tremblement du contenu nécessite de distinguer le normal (déplacement léger, rétablissement rapide) ne nécessitant pas d'action, de l'anormal (sauts haute fréquence, pertes fréquentes) impactant l'expérience utilisateur et devant être investigué dans cet ordre :

  1. Vérifier la qualité de l'image cible ;
  2. Confirmer si le phénomène est spécifique aux performances d'un appareil ;
  3. Exclure les interférences environnementales (éclairage, scène dynamique, surfaces réfléchissantes) ;
  4. Vérifier si le contenu virtuel est excessivement grand.

Si le problème persiste, fournissez des journaux, captures d'écran, etc. via le forum officiel EasyAR ou l'assistance technique pour une analyse approfondie.