Table of Contents

Diagnostic et correction : contenu non affiché

Cet article traite des problèmes courants où le contenu virtuel ne peut pas être affiché dans le planar image tracking. Il fournit des méthodes systématiques de troubleshooting et des suggestions d'amélioration pour aider les développeurs à localiser et résoudre rapidement les problèmes.

Causes courantes et méthodes de troubleshooting

Le contenu non affiché implique généralement image recognition, des erreurs d'implémentation de fonction ou des restrictions de permission. Voici les principales causes et étapes de troubleshooting :

Échec d'image recognition

Symptôme : après avoir pointé la caméra vers la target image, le contenu virtuel n'apparaît pas du tout. Troubleshooting :

  • Vérifier le recognition score de l'image : utilisez le target image detection tool pour téléverser l'image et confirmer le recognition score, qui doit atteindre 4-5 étoiles.
  • Vérifier la qualité de l'image : assurez-vous que l'image respecte les exigences de texture, taille et ratio dans best practices.
  • Vérifier la target image entity : assurez-vous que la surface de la target image entity, comme une affiche ou une carte, ne réfléchit pas la lumière et reste plane sans pli.
  • Consulter les logs : vérifiez les application logs, recherchez l'event TargetLoad et confirmez si la target image a été chargée avec succès.

Suggestions d'amélioration :

  • Optimiser l'image : augmenter le contraste, éviter les motifs répétés et s'assurer que le sujet principal occupe plus de 70% de l'image.
  • Remplacer l'image : si le problème persiste après optimisation, utilisez une image de test du Sample officiel, comme namecard.jpg, pour vérifier si le problème vient de l'image elle-même.
  • Garantir l'entité physique : la target entity doit autant que possible utiliser une surface mate ou relativement rugueuse, et rester plane sans pli ni courbure.
  • Vérifier la logique : assurez-vous que l'application a correctement chargé la target image utilisée pour le test.

Erreurs d'implémentation de fonction

Symptôme : l'image a été reconnue, mais le contenu virtuel n'est pas affiché ou sa position est anormale.

Troubleshooting :

  • Vérifier la configuration ImageTarget :
    • Vérifier, selon le type Source, qu'il pointe vers le bon fichier dans le dossier StreamingAssets.
    • Vérifier si Scale est défini sur la taille physique réelle.
  • Confirmer la hiérarchie du prefab : le contenu virtuel, comme Cube, doit être un child node de ImageTarget et ne doit pas être désactivé.

Suggestions d'amélioration :

  • Réinitialiser la configuration : supprimer et recréer ImageTarget dans la scene, glisser le prefab selon la spécification et lier l'image.
  • Simplifier le test : supprimer temporairement les custom scripts et ne garder que le Cube de base pour confirmer la scene minimale exécutable.
  • Vérifier les logs : rechercher les erreurs liées à ImageTargetController, comme fail to load target data.

Problèmes de permission

Symptôme : le fonctionnement était normal au départ, mais le contenu disparaît après un certain temps d'exécution. Troubleshooting : Confirmez si vous êtes dans l'un des cas suivants :

  • Utilisation sur XR headset
  • Utilisation d'une custom camera
  • Utilisation de AR Engine/ARFoundation sur téléphone

Si vous êtes dans l'un de ces cas, vous utilisez peut-être une License d'essai.

Suggestions d'amélioration :

  • Utiliser une License officielle.

Problèmes de contenu virtuel

Symptôme : le contenu était initialement affiché normalement, mais il devient invisible lorsque la caméra est très proche ou très éloignée du target object. Troubleshooting :

  • Vérifier les paramètres near et far clipping : assurez-vous que les paramètres near et far clipping utilisés lors du rendering du contenu virtuel sont dans une plage raisonnable.
  • Vérifier la taille du content model : lorsque le content model est trop grand, se rapprocher du target object peut provoquer une traversée du modèle et rendre le contenu invisible ; lorsque le content model est trop petit, s'éloigner du target object peut le rendre trop petit pour être clairement visible.

Suggestions d'amélioration :

  • Définir un near et far clipping approprié.
  • La taille physique du contenu virtuel doit être appropriée par rapport à la target image entity.

Résumé et bonnes pratiques

Le problème de contenu non affiché est généralement causé par l'image, l'implémentation du programme, les permissions ou le contenu lui-même. Il est recommandé d'effectuer le troubleshooting dans l'ordre suivant :

  1. Vérifier si la License est une version officielle ;
  2. Vérifier si le contenu virtuel lui-même est approprié ;
  3. Vérifier la qualité de la target image ;
  4. Confirmer s'il existe des problèmes dans l'implémentation du programme ou la configuration de développement.

Si le problème persiste, fournissez log files, enregistrements d'écran et autres ressources via le forum officiel EasyAR ou le support technique pour une analyse plus approfondie.