Table of Contents

Diagnóstico e reparo: Falha no carregamento de alvos

A funcionalidade de rastreamento de objetos 3D depende fortemente da qualidade do modelo 3D de entrada. Quando o carregamento do modelo alvo falha, o EasyAR registra logs de erro detalhados para auxiliar os desenvolvedores a identificar o problema. Este capítulo lista as causas comuns de falha e soluções, abrangendo problemas de materiais, texturas e arquivos de modelo.

Erros em arquivos de material/textura

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

Informação do log Causa do erro Solução
Material file not exist Caminho do arquivo de material (.mtl) inexistente ou referência incorreta Verifique se o arquivo .mtl existe na pasta do modelo e se o caminho em mtllib do arquivo .obj está correto (caminho relativo)
Current material has no name Definição de material sem nome (newmtl não especificado) Adicione um nome a cada material no arquivo .mtl, ex: newmtl Material1
No texture map exists in material Mapa de textura não especificado no material (falta map_Ka ou map_Kd) Adicione o caminho da textura no arquivo .mtl, ex: map_Kd texture.jpg
Read texture map file failed Falha na leitura do arquivo de textura (caminho errado, formato não suportado) Verifique se o arquivo de textura está na pasta do modelo, se o formato é JPG/PNG e se o caminho não contém espaços

Erros em arquivos de modelo

Esses erros geralmente são causados por formato OBJ não padronizado ou problemas de codificação.

Informação do log Causa do erro Solução
Error in opening OBJ file Caminho do arquivo de modelo inexistente ou permissões insuficientes Verifique o caminho do arquivo e garanta permissões de leitura
Error in reading OBJ file Falha na leitura do arquivo (codificação não UTF-8, arquivo corrompido) Abra o arquivo .obj em um editor de texto e salve-o com codificação UTF-8
Material not exist Material referenciado por uma face não encontrado no arquivo .mtl Verifique o campo usemtl no .obj e garanta correspondência com o nome newmtl no .mtl
Vertex format invalid Formato de coordenadas de vértice inválido (dados da linha v fora do padrão) Verifique o formato v: v x y z (ex: v -4.322898 6.063079 -40.241329), garanta que sejam valores numéricos
Vertex texture coordinate format invalid Formato de coordenadas de textura inválido (dados da linha vt fora do padrão) Verifique o formato vt: vt u v (ex: vt 0.929688 0.094622), garanta valores entre 0-1
Face format invalid Número de vértices por face menor que 3 (dados da linha f inválidos) Verifique linhas f, garanta que cada face tenha pelo menos 3 vértices
Both vertex index and vertex texture coordinate index are required Formato de face incorreto (falta índice de vértice ou textura) Verifique o formato da linha f, garanta que inclua índices de vértice e textura (ex: f 1/1 2/2 3/3)
Vertex index format invalid Índice de vértice da face incorreto (fora do intervalo ou não inteiro) Verifique os índices de vértice em f, garanta que sejam inteiros positivos e não excedam o total de vértices
Vertex texture coordinate index format invalid Índice de coordenada de textura da face incorreto Verifique os índices de textura em f, garanta que sejam inteiros positivos e não excedam o total de coordenadas de textura

Melhores práticas

Ao encontrar erros de carregamento, siga as informações da tabela acima para solução de problemas. Geralmente, você deve seguir estas diretrizes básicas:

  • Se seu modelo foi exportado de ferramentas profissionais (Blender, Maya), marque "Escrever materiais" e "Incluir UV" (ou opção similar) na exportação, e garanta que todos os arquivos estejam na mesma pasta.
  • Os caminhos de referência internos em arquivos de modelo exportados podem ser absolutos; verifique e altere para caminhos relativos. Evite espaços em nomes de arquivos e use codificação UTF-8.
  • Para requisitos detalhados de formato e especificação de modelos, consulte o capítulo Preparação de modelos.

Dica: Se o problema persistir, recomenda-se compactar os arquivos do modelo e os logs de erro e buscar assistência através do fórum oficial do EasyAR ou suporte técnico.