Table of Contents

Diagnostic et correction : échec du chargement de target

La fonction de suivi d'objet 3D dépend fortement de la qualité du modèle 3D d'entrée. Lorsque le chargement du modèle cible échoue, EasyAR affiche des logs d'erreur détaillés pour aider les développeurs à localiser le problème. Ce chapitre liste les causes courantes et solutions, couvrant les problèmes de matériau, texture et fichier modèle.

Erreurs de fichier matériau/texture map

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

Message de log Cause de l'erreur Solution
Material file not exist Le chemin du fichier de matériau (.mtl) n'existe pas ou n'est pas correctement référencé Vérifiez que le fichier .mtl existe dans le dossier du modèle et que le chemin mtllib du fichier .obj le référence correctement avec un chemin relatif
Current material has no name La définition du matériau n'a pas de nom (newmtl n'est pas spécifié) Ajoutez un nom pour chaque matériau dans le fichier .mtl, par exemple newmtl Material1
No texture map exists in material Aucune texture map n'est spécifiée dans le matériau (map_Ka ou map_Kd manque) Ajoutez un chemin de texture dans le fichier .mtl, par exemple map_Kd texture.jpg
Read texture map file failed Le fichier de texture map ne peut pas être lu (chemin incorrect ou format non pris en charge) Vérifiez que le fichier de texture se trouve dans le dossier du modèle, qu'il est au format JPG/PNG et que le chemin ne contient pas d'espaces

Erreurs de fichier modèle

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

Message de log Cause de l'erreur Solution
Error in opening OBJ file Le chemin du fichier modèle n'existe pas ou les permissions sont 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 ou fichier endommagé) Ouvrez le fichier .obj dans un éditeur de texte et enregistrez-le avec l'encodage UTF-8
Material not exist Le matériau référencé par la face est introuvable dans le fichier .mtl Vérifiez le champ usemtl dans le fichier .obj et assurez-vous qu'il correspond au nom newmtl dans le fichier .mtl
Vertex format invalid Format de coordonnées vertex invalide (les données de la ligne v ne respectent pas la spécification) Vérifiez le format v : v x y z (par exemple v -4.322898 6.063079 -40.241329) et assurez-vous que les valeurs sont numériques
Vertex texture coordinate format invalid Format de coordonnées de texture vertex invalide (les données de la ligne vt ne respectent pas la spécification) Vérifiez le format vt : vt u v (par exemple vt 0.929688 0.094622) et assurez-vous que les valeurs sont entre 0 et 1
Face format invalid La face contient moins de 3 vertex (les données de la ligne f sont invalides) Vérifiez la ligne f et assurez-vous que chaque face contient au moins 3 vertex
Both vertex index and vertex texture coordinate index are required Format de face incorrect (index vertex ou texture manquant) Vérifiez le format de la ligne f et assurez-vous qu'elle contient les index vertex et texture (par exemple f 1/1 2/2 3/3)
Vertex index format invalid Index vertex de face incorrect (index hors limites ou non entier) Vérifiez les index vertex dans la ligne f et assurez-vous qu'ils sont des entiers positifs ne dépassant pas le nombre total de vertex
Vertex texture coordinate index format invalid Index de coordonnées de texture de face incorrect Vérifiez les index de texture dans la ligne f et assurez-vous qu'ils sont des entiers positifs ne dépassant pas le nombre total de coordonnées de texture

Bonnes pratiques

Lorsqu'une erreur de chargement se produit, diagnostiquez selon les informations des tableaux ci-dessus. En général, suivez ces principes de base :

  • Si votre modèle est exporté depuis des outils professionnels tels que Blender ou Maya, veillez à cocher "write materials" et "include UVs" (ou options similaires) lors de l'export, et assurez-vous que tous les fichiers sont dans le même dossier.
  • Les chemins de référence dans les fichiers modèle exportés par les outils peuvent être absolus. Vérifiez-les et remplacez-les par des 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 du modèle, consultez Préparation du modèle.

Conseil : si le problème ne peut toujours pas être résolu, regroupez les fichiers modèle et les logs d'erreur, puis demandez de l'aide via le forum officiel EasyAR ou le support technique.