Table of Contents

Diagnóstico y corrección: fallo al cargar target

La función de seguimiento de objetos 3D depende en gran medida de la calidad del modelo 3D de entrada. Cuando falla la carga del modelo objetivo, EasyAR imprime registros de error detallados para ayudar a localizar el problema. Este capítulo enumera causas comunes y soluciones, cubriendo problemas de material, textura y archivo de modelo.

Errores de archivo de material/texture map

Estos errores suelen deberse a configuración de rutas o problemas de formato de archivo.

Mensaje de log Causa del error Solución
Material file not exist La ruta del archivo de material (.mtl) no existe o no se referencia correctamente Compruebe que el archivo .mtl exista en la carpeta del modelo y que la ruta mtllib del archivo .obj apunte correctamente como ruta relativa
Current material has no name La definición de material no tiene nombre (newmtl no está especificado) Añada un nombre para cada material en el archivo .mtl, por ejemplo newmtl Material1
No texture map exists in material No se especifica texture map en el material (falta map_Ka o map_Kd) Añada una ruta de textura en el archivo .mtl, por ejemplo map_Kd texture.jpg
Read texture map file failed No se puede leer el archivo de texture map (ruta incorrecta o formato no compatible) Compruebe que el archivo de textura esté dentro de la carpeta del modelo, tenga formato JPG/PNG y que la ruta no contenga espacios

Errores de archivo de modelo

Estos errores suelen deberse a un formato OBJ no estándar o problemas de codificación.

Mensaje de log Causa del error Solución
Error in opening OBJ file La ruta del archivo de modelo no existe o los permisos son insuficientes Compruebe la ruta del archivo y asegúrese de que el archivo sea legible
Error in reading OBJ file Falló la lectura del archivo (codificación no UTF-8 o archivo dañado) Abra el archivo .obj en un editor de texto y guárdelo con codificación UTF-8
Material not exist El material referenciado por la cara no se encuentra en el archivo .mtl Compruebe el campo usemtl del archivo .obj y asegúrese de que coincida con el nombre newmtl del archivo .mtl
Vertex format invalid Formato de coordenadas vertex incorrecto (la línea v no cumple la especificación) Compruebe el formato v: v x y z (por ejemplo v -4.322898 6.063079 -40.241329) y asegúrese de que sean valores numéricos
Vertex texture coordinate format invalid Formato de coordenadas de textura vertex incorrecto (la línea vt no cumple la especificación) Compruebe el formato vt: vt u v (por ejemplo vt 0.929688 0.094622) y asegúrese de que los valores estén entre 0 y 1
Face format invalid La cara tiene menos de 3 vértices (la línea f no es válida) Compruebe la línea f y asegúrese de que cada cara contenga al menos 3 vértices
Both vertex index and vertex texture coordinate index are required Formato de cara incorrecto (falta índice de vértice o de textura) Compruebe el formato de la línea f y asegúrese de que contenga índices de vértice y textura (por ejemplo f 1/1 2/2 3/3)
Vertex index format invalid Índice de vértice de cara incorrecto (índice fuera de rango o no entero) Compruebe los índices de vértice en la línea f y asegúrese de que sean enteros positivos y no superen el número total de vértices
Vertex texture coordinate index format invalid Índice de coordenada de textura de cara incorrecto Compruebe los índices de textura en la línea f y asegúrese de que sean enteros positivos y no superen el número total de coordenadas de textura

Prácticas recomendadas

Cuando ocurra un error de carga, solucione el problema según la información de las tablas anteriores. En general, siga estas pautas básicas:

  • Si su modelo se exporta desde herramientas profesionales como Blender o Maya, asegúrese de marcar "write materials" e "include UVs" (u opciones similares) durante la exportación, y asegúrese de que todos los archivos estén en la misma carpeta.
  • Las rutas de referencia dentro de los archivos de modelo exportados por herramientas pueden ser rutas absolutas. Revise y cámbielas a rutas relativas, evite espacios en los nombres de archivo y asegúrese de que la codificación sea UTF-8.
  • Para requisitos detallados sobre formato y especificaciones del modelo, consulte Preparación del modelo.

Consejo: Si el problema aún no se puede resolver, empaquete los archivos de modelo y los registros de error, y obtenga ayuda a través del foro oficial de EasyAR o soporte técnico.