Table of Contents

Diagnostic et réparation : échec de chargement de la cible

Le suivi d'objets 3D dépend fortement de la qualité du modèle 3D en entrée. Lorsqu'un modèle cible échoue au chargement, EasyAR imprime des journaux d'erreur détaillés pour aider les développeurs à localiser le problème. Ce chapitre répertorie les causes courantes d'échec et leurs solutions, couvrant les problèmes liés aux matériaux, aux textures et aux fichiers de modèle.

Erreurs de fichiers de matériaux/textures

Ces erreurs sont généralement dues à des problèmes de configuration de chemin ou de format de fichier.

Information du journal Cause de l'erreur Solution
Material file not exist Le chemin du fichier de matériau (.mtl) n'existe pas ou n'est pas référencé correctement Vérifiez que le fichier .mtl existe dans le dossier du modèle et que le chemin mtllib dans le fichier .obj est correct (chemin relatif)
Current material has no name La définition du matériau manque un nom (newmtl non spécifié) Dans le fichier .mtl, ajoutez un nom à chaque matériau, par exemple newmtl Material1
No texture map exists in material Aucune texture n'est spécifiée dans le matériau (absence de map_Ka ou map_Kd) Ajoutez le chemin de la texture dans le fichier .mtl, par exemple map_Kd texture.jpg
Read texture map file failed Échec de lecture du fichier de texture (chemin erroné, format non pris en charge) Vérifiez que le fichier de texture est dans le dossier du modèle, au format JPG/PNG, et que le chemin ne contient pas d'espaces

Erreurs de fichiers de modèle

Ces erreurs sont généralement dues à un format OBJ non conforme ou à des problèmes d'encodage.

Information du journal Cause de l'erreur Solution
Error in opening OBJ file Le chemin du fichier modèle n'existe pas ou permissions insuffisantes Vérifiez le chemin du fichier et assurez-vous qu'il est lisible
Error in reading OBJ file Échec de lecture du fichier (encodage non UTF-8, fichier corrompu) Ouvrez le fichier .obj dans un éditeur de texte et enregistrez-le au format UTF-8
Material not exist Le matériau référencé par une face est introuvable dans le fichier .mtl Vérifiez le champ usemtl dans le fichier .obj, assurez-vous qu'il correspond au nom newmtl dans le .mtl
Vertex format invalid Format des coordonnées de sommet invalide (les données de la ligne v ne sont pas conformes) Vérifiez le format v : v x y z (par exemple v -4.322898 6.063079 -40.241329), assurez-vous que ce sont des valeurs numériques
Vertex texture coordinate format invalid Format des coordonnées de texture de sommet invalide (données de la ligne vt non conformes) Vérifiez le format vt : vt u v (par exemple vt 0.929688 0.094622), assurez-vous que ce sont des valeurs entre 0 et 1
Face format invalid Nombre de sommets par face inférieur à 3 (données de la ligne f invalides) Vérifiez la ligne f, assurez-vous que chaque face contient au moins 3 sommets
Both vertex index and vertex texture coordinate index are required Format de face erroné (absence d'index de sommet ou de texture) Vérifiez le format de la ligne f, assurez-vous qu'il inclut les index de sommet et de texture (par exemple f 1/1 2/2 3/3)
Vertex index format invalid Index de sommet de face erroné (index hors limites ou non entier) Vérifiez les index de sommet dans la ligne f, assurez-vous qu'ils sont des entiers positifs et ne dépassent pas le nombre total de sommets
Vertex texture coordinate index format invalid Index des coordonnées de texture de sommet erroné Vérifiez les index de texture dans la ligne f, assurez-vous qu'ils sont des entiers positifs et ne dépassent pas le nombre total de coordonnées de texture

Bonnes pratiques

En cas d'erreur de chargement, suivez les informations du tableau ci-dessus pour le dépannage. En règle générale, vous devriez respecter les directives de base suivantes :

  • Si votre modèle est exporté depuis un outil professionnel (comme Blender, Maya), cochez toujours "Écrire les matériaux" et "Inclure les UV" (ou options similaires) à l'exportation, et assurez-vous que tous les fichiers sont dans le même dossier.
  • Les chemins de référence internes des fichiers modèles exportés par les outils peuvent être absolus ; vérifiez et convertissez-les en chemins relatifs. Évitez les espaces dans les noms de fichiers et assurez-vous que l'encodage est UTF-8.
  • Pour les exigences détaillées concernant le format et les spécifications des modèles, reportez-vous au chapitre Préparation des modèles.

Astuce : Si le problème persiste, il est recommandé de compresser les fichiers du modèle et les journaux d'erreur, puis de demander de l'aide via le forum officiel EasyAR ou l'assistance technique.