Table of Contents

Diagnóstico e correção: falha ao carregar target

O recurso de tracking de objetos 3D depende muito da qualidade do modelo 3D de entrada. Quando o carregamento do modelo alvo falha, o EasyAR imprime logs de erro detalhados para ajudar os desenvolvedores a localizar o problema. Este capítulo lista causas comuns e soluções, cobrindo problemas de material, textura e arquivo de modelo.

Erros de arquivo de material/texture map

Esses erros geralmente são causados por configuração de caminho ou problemas de formato de arquivo.

Mensagem de log Causa do erro Solução
Material file not exist O caminho do arquivo de material (.mtl) não existe ou não foi referenciado corretamente Verifique se o arquivo .mtl existe na pasta do modelo e se o caminho mtllib no arquivo .obj aponta corretamente para ele como caminho relativo
Current material has no name A definição do material não tem nome (newmtl não especificado) Adicione um nome para cada material no arquivo .mtl, por exemplo newmtl Material1
No texture map exists in material Nenhum texture map foi especificado no material (map_Ka ou map_Kd ausente) Adicione um caminho de textura no arquivo .mtl, por exemplo map_Kd texture.jpg
Read texture map file failed O arquivo texture map não pode ser lido (caminho errado ou formato não suportado) Verifique se o arquivo de textura está dentro da pasta do modelo, está em formato JPG/PNG e se o caminho não contém espaços

Erros de arquivo de modelo

Esses erros geralmente são causados por formato OBJ fora do padrão ou problemas de encoding.

Mensagem de log Causa do erro Solução
Error in opening OBJ file O caminho do arquivo de modelo não existe ou as permissões são insuficientes Verifique o caminho do arquivo e certifique-se de que ele pode ser lido
Error in reading OBJ file Falha ao ler o arquivo (encoding não UTF-8 ou arquivo corrompido) Abra o arquivo .obj em um editor de texto e salve-o com encoding UTF-8
Material not exist O material referenciado pela face não foi encontrado no arquivo .mtl Verifique o campo usemtl no arquivo .obj e certifique-se de que corresponde ao nome newmtl no arquivo .mtl
Vertex format invalid Formato de coordenadas vertex inválido (dados da linha v não atendem à especificação) Verifique o formato v: v x y z (por exemplo v -4.322898 6.063079 -40.241329) e certifique-se de que os valores são numéricos
Vertex texture coordinate format invalid Formato de coordenadas de textura vertex inválido (dados da linha vt não atendem à especificação) Verifique o formato vt: vt u v (por exemplo vt 0.929688 0.094622) e certifique-se de que os valores estejam entre 0 e 1
Face format invalid A face tem menos de 3 vertices (dados da linha f inválidos) Verifique a linha f e certifique-se de que cada face contém pelo menos 3 vertices
Both vertex index and vertex texture coordinate index are required Formato de face incorreto (índice vertex ou de textura ausente) Verifique o formato da linha f e certifique-se de que contém índices vertex e de textura (por exemplo f 1/1 2/2 3/3)
Vertex index format invalid Índice vertex da face incorreto (índice fora do intervalo ou não inteiro) Verifique os índices vertex na linha f e certifique-se de que são inteiros positivos e não excedem o número total de vertices
Vertex texture coordinate index format invalid Índice de coordenada de textura da face incorreto Verifique os índices de textura na linha f e certifique-se de que são inteiros positivos e não excedem o número total de coordenadas de textura

Melhores práticas

Quando ocorrer erro de carregamento, investigue de acordo com as informações nas tabelas acima. Em geral, siga estas diretrizes básicas:

  • Se seu modelo for exportado de ferramentas profissionais como Blender ou Maya, certifique-se de selecionar "write materials" e "include UVs" (ou opções similares) durante a exportação, e garanta que todos os arquivos estejam na mesma pasta.
  • Os caminhos de referência dentro dos arquivos de modelo exportados por ferramentas podem ser caminhos absolutos. Verifique e altere para caminhos relativos, evite espaços nos nomes de arquivos e garanta que o encoding seja UTF-8.
  • Para requisitos detalhados sobre formato e especificações de modelo, consulte Preparação de modelo.

Dica: se o problema ainda não puder ser resolvido, compacte os arquivos de modelo e logs de erro e obtenha ajuda pelo fórum oficial EasyAR ou suporte técnico.