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 d'affichage de contenu virtuel dans le suivi d'objets 3D, aidant les développeurs à identifier et résoudre rapidement les problèmes.

Causes courantes et méthodes de dépannage

L'absence de contenu implique généralement un échec de reconnaissance d'objet, une erreur d'implémentation fonctionnelle ou une restriction d'autorisation. Voici les causes principales et les étapes de dépannage :

Échec de reconnaissance d'objet

Phénomène : Le contenu virtuel n'apparaît pas du tout après avoir pointé la caméra vers l'objet cible.
Méthodes de dépannage :

  • Vérifier la qualité du modèle : Assurez-vous que le modèle 3D et l'objet respectent les exigences de format de fichier, de texture, de géométrie, etc., décrites dans Préparation des modèles.
  • Vérifier l'objet cible : Assurez-vous que la surface de l'objet cible n'est pas réfléchissante ou n'a pas de matériau miroir.
  • Consulter les logs : Vérifiez les logs de l'application pour confirmer le chargement réussi du modèle cible.

Suggestions d'amélioration :

  • Optimiser le modèle : Assurez-vous que les textures sont suffisamment riches et que la structure géométrique n'a pas de trous.
  • Vérifier la logique : Assurez-vous que l'application a correctement chargé le modèle cible. En cas d'échec de chargement, reportez-vous au chapitre Échec de chargement de la cible pour vérifier et réparer.

Erreur d'implémentation fonctionnelle

Phénomène : L'objet est reconnu, mais le contenu virtuel n'est pas affiché ou sa position est anormale.

Méthodes de dépannage :

  • Vérifier la configuration d'ObjectTarget :
    • Selon le type de Source, vérifiez s'il pointe vers le fichier correct dans le dossier StreamingAssets.
    • Scale doit être modifié en fonction de la taille réelle de l'objet (par exemple, si les dimensions du BoundingBox calculées à partir du fichier modèle sont 10 x 10 x 30, mais que la taille réelle de l'objet est de 0,1m x 0,1m x 0,3m, alors Scale doit être défini sur 0,01).
  • Confirmer la hiérarchie des préfabriqués :
    • Le contenu virtuel doit être au même niveau que le modèle 3D cible, et tous deux doivent être des nœuds enfants de ObjectTarget. Le contenu virtuel ne doit pas être désactivé.
    • La propriété Rotation du modèle 3D cible nécessite que la direction Y soit définie sur 180.
    • Le placement du contenu virtuel doit être entièrement centré sur la position du modèle 3D cible.

Suggestions d'amélioration :

  • Réinitialiser la configuration : Supprimez et recréez ObjectTarget dans la scène, faites glisser le préfabriqué conformément aux normes et liez le modèle 3D.
  • Vérifier les logs : Recherchez les erreurs liées à ObjectTargetController, comme fail to load target data.

Problèmes d'autorisation

Phénomène : Fonctionnait normalement, mais le contenu disparaît après un certain temps d'exécution.
Méthodes de dépannage :
Confirmez si vous êtes dans l'un des cas suivants :

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

Si c'est l'un de ces cas, vous utilisez probablement une licence d'essai.

Suggestions d'amélioration :

  • Utilisez une licence officielle.

Problème de contenu virtuel

Phénomène : Le contenu s'affichait normalement, mais devient invisible lorsque la caméra est très proche/très loin de l'objet cible.
Méthodes de dépannage :

  • Vérifier les paramètres near/far clipping : Assurez-vous que les paramètres near/far clipping lors du rendu du contenu virtuel sont dans une plage raisonnable.
  • Vérifier la taille du modèle de contenu : Un modèle de contenu trop grand peut provoquer un "clipping" (le modèle traverse l'objet) lorsqu'on s'approche, le rendant invisible. Un modèle trop petit peut devenir imperceptible à distance.

Suggestions d'amélioration :

  • Définissez des valeurs near/far clipping appropriées.
  • Assurez-vous que la taille physique du contenu virtuel est proportionnelle à celle de l'objet cible.

Résumé et meilleures pratiques

Les problèmes d'affichage de contenu proviennent généralement du modèle 3D, de l'implémentation logicielle, des autorisations ou du contenu lui-même. Il est recommandé de vérifier dans cet ordre :

  1. Vérifiez que la licence est officielle ;
  2. Vérifiez l'adéquation du contenu virtuel ;
  3. Confirmez la qualité du modèle 3D cible ;
  4. Identifiez les problèmes d'implémentation ou de configuration de développement.

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