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 3D object 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 un échec d'object recognition, des erreurs d'implémentation de fonction ou des restrictions de permission. Voici les principales causes et étapes de troubleshooting :

Échec d'object recognition

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

  • Vérifier la qualité du modèle : assurez-vous que le 3D model et l'object respectent les exigences de file format, texture, geometry, etc. dans model preparation.
  • Vérifier le target object : assurez-vous que la surface du target object n'a pas de matériau réfléchissant ou miroir.
  • Consulter les logs : vérifiez les application logs et confirmez si le target model a été chargé avec succès.

Suggestions d'amélioration :

  • Optimiser le modèle : assurez-vous que les textures sont suffisamment riches et que la geometry n'a pas de trous.
  • Vérifier la logique : assurez-vous que l'application a correctement chargé le target model. En cas d'échec de chargement, consultez target loading failure pour vérifier et corriger.

Erreurs d'implémentation de fonction

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

Troubleshooting :

  • Vérifier la configuration ObjectTarget :
    • Vérifier, selon le type Source, qu'il pointe vers le bon fichier dans le dossier StreamingAssets.
    • Vérifier si Scale a été modifié selon la taille réelle de l'object. Par exemple, si la taille BoundingBox calculée à partir du fichier modèle est 10 x 10 x 30 et que la taille réelle de l'object est 0.1m x 0.1m x 0.3m, Scale doit être défini sur 0.01.
  • Confirmer la hiérarchie du prefab :
    • Le contenu virtuel doit être au même niveau que le target 3D model, et tous deux doivent être child nodes de ObjectTarget. Le contenu virtuel ne doit pas être désactivé.
    • La propriété Rotation du target 3D model doit définir la direction Y sur 180.
    • Le placement du contenu virtuel doit être entièrement organisé autour de la position du target 3D model.

Suggestions d'amélioration :

  • Réinitialiser la configuration : supprimer et recréer ObjectTarget dans la scene, glisser le prefab selon la spécification et lier le 3D model.
  • Vérifier les logs : rechercher les erreurs liées à ObjectTargetController, 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 au target object.

Résumé et bonnes pratiques

Le problème de contenu non affiché est généralement causé par l'object 3D model, 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. Confirmer la qualité du target 3D model ;
  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.