Table of Contents

Diagnostic et réparation : contenu non affiché

Ce document fournit des méthodes systématiques de dépannage et des suggestions d'amélioration pour les problèmes courants où le contenu virtuel ne s'affiche pas dans le suivi d'image plane, aidant les développeurs à localiser et résoudre rapidement les problèmes.

Causes courantes et méthodes de dépannage

Le non-affichage du contenu implique généralement une reconnaissance d'image défaillante, une erreur d'implémentation fonctionnelle ou des restrictions de permissions. Voici les principales causes et étapes de dépannage :

Échec de la reconnaissance d'image

Symptôme : le contenu virtuel n'apparaît pas du tout lorsque la caméra est pointée vers l'image cible.
Méthode de dépannage :

  • Vérifier la reconnaissance d'image : utilisez l'outil de détection d'image cible pour télécharger l'image et confirmer son score de reconnaissance (doit atteindre 4~5 étoiles).
  • Valider la qualité de l'image : assurez-vous que l'image respecte les exigences de texture, taille et proportion des bonnes pratiques.
  • Inspecter l'objet physique : vérifiez que la surface de l'objet physique (affiche, carte, etc.) n'est pas réfléchissante et reste plate sans pli.
  • Consulter les logs : examinez les logs de l'application, recherchez l'événement TargetLoad pour confirmer le chargement réussi de l'image cible.

Suggestions d'amélioration :

  • Optimiser l'image : augmentez le contraste, évitez les motifs répétitifs, assurez-vous que le sujet occupe plus de 70% de l'image.
  • Remplacer l'image : si le problème persiste après optimisation, testez avec une image d'échantillon officielle (ex: namecard.jpg) pour vérifier si l'image est défectueuse.
  • Garantir l'intégrité physique : utilisez des surfaces mates ou texturées, maintenez l'objet plat sans pli ni courbure.
  • Vérifier la logique : confirmez que l'application charge correctement l'image cible testée.

Erreur d'implémentation fonctionnelle

Symptôme : l'image est reconnue, mais le contenu virtuel ne s'affiche pas ou est mal positionné.

Méthode de dépannage :

  • Vérifier la configuration d'ImageTarget :
    • Vérifiez que Source pointe vers le fichier correct dans le dossier StreamingAssets.
    • Confirmez que Scale correspond à la taille physique réelle.
  • Valider la hiérarchie des préfabriqués : le contenu virtuel (ex: Cube) doit être un enfant de ImageTarget et ne pas être désactivé.

Suggestions d'amélioration :

  • Réinitialiser la configuration : supprimez et recréez ImageTarget dans la scène, liez l'image et glissez-y le préfabriqué selon les normes.
  • Simplifier le test : retirez temporairement les scripts personnalisés, ne conservez qu'un Cube basique pour valider la scène minimale.
  • Examiner les logs : recherchez les erreurs liées à ImageTargetController, comme fail to load target data.

Problèmes de permissions

Symptôme : le contenu disparaît après un fonctionnement initialement normal.
Méthode de dépannage :
Confirmez si vous êtes dans l'un de ces cas :

  • Utilisation sur un casque XR
  • Utilisation d'une caméra personnalisée
  • Utilisation d'AR Engine/ARFoundation sur mobile

Si oui, vous utilisez probablement une licence d'essai.

Suggestions d'amélioration :

  • Passez à une licence officielle.

Problème lié au contenu virtuel

Symptôme : le contenu s'affiche normalement, mais disparaît lorsque la caméra est très proche/éloignée de la cible.
Méthode de dépannage :

  • Vérifier les paramètres de découpage : assurez-vous que les réglages de découpage proche/lointain (near/far clipping) sont dans une plage raisonnable.
  • Contrôler la taille du modèle : un modèle trop grand peut causer un "clipping" en approche ; un modèle trop petit peut devenir invisible en s'éloignant.

Suggestions d'amélioration :

  • Définissez des valeurs de découpage appropriées.
  • Ajustez la taille physique du contenu virtuel par rapport à l'objet cible.

Résumé et bonnes pratiques

Le non-affichage du contenu provient généralement de l'image, de l'implémentation, des permissions ou du contenu lui-même. Procédez dans cet ordre :

  1. Vérifiez que la licence est officielle.
  2. Contrôlez l'adéquation du contenu virtuel.
  3. Validez la qualité de l'image cible.
  4. Confirmez l'absence d'erreurs dans l'implémentation ou la configuration.

Si le problème persiste, fournissez des logs, captures d'écran ou vidéos via le forum officiel EasyAR ou l'assistance technique.