Table of Contents

Diagnóstico e reparo: Conteúdo não exibido

Este artigo aborda problemas comuns de falha na exibição de conteúdo virtual em rastreamento de objetos 3D, fornecendo métodos sistemáticos de verificação e sugestões de melhoria para ajudar desenvolvedores a localizar e resolver problemas rapidamente.

Causas comuns e métodos de verificação

A não exibição de conteúdo geralmente envolve falha no reconhecimento do objeto, erro na implementação de funcionalidades ou restrições de permissão. Abaixo estão as principais causas e etapas de verificação:

Falha no reconhecimento do objeto

Fenômeno: O conteúdo virtual não aparece após a câmera focar no objeto-alvo.
Métodos de verificação:

  • Verifique a qualidade do modelo: Certifique-se de que o modelo 3D e o objeto atendem aos requisitos de formato de arquivo, textura, geometria etc. descritos em Preparação do modelo.
  • Verifique o objeto-alvo: Garanta que a superfície do objeto-alvo não tenha materiais reflexivos ou espelhados.
  • Verifique logs: Examine os logs do aplicativo para confirmar se o modelo-alvo foi carregado com sucesso.

Melhorias sugeridas:

  • Otimize o modelo: Garanta texturas suficientemente ricas e ausência de buracos na estrutura geométrica.
  • Verifique a lógica: Certifique-se de que o aplicativo carregou o modelo-alvo corretamente. Em caso de falha no carregamento, consulte o capítulo Falha no carregamento do alvo para verificação e reparo.

Erro na implementação de funcionalidades

Fenômeno: O objeto é reconhecido, mas o conteúdo virtual não é exibido ou aparece em posição anômala.

Métodos de verificação:

  • Verifique a configuração do ObjectTarget:
    • Conforme o tipo Source, verifique se ele aponta para o arquivo correto na pasta StreamingAssets.
    • O Scale foi ajustado conforme as dimensões reais do objeto? (Exemplo: se as dimensões do BoundingBox calculadas do arquivo de modelo forem 10 x 10 x 30, mas o objeto real mede 0.1m x 0.1m x 0.3m, defina Scale como 0.01).
  • Confirme a hierarquia do prefab:
    • O conteúdo virtual deve estar no mesmo nível do modelo 3D alvo, ambos como subnós do ObjectTarget. O conteúdo virtual não pode estar desativado.
    • A propriedade Rotation do modelo 3D alvo deve ter o eixo Y definido como 180.
    • O posicionamento do conteúdo virtual deve orbitar completamente a posição do modelo 3D alvo.

Melhorias sugeridas:

  • Redefina a configuração: Exclua e recrie o ObjectTarget na cena, arrastando o prefab conforme as especificações e vinculando o modelo 3D.
  • Verifique logs: Busque erros relacionados a ObjectTargetController, como fail to load target data.

Problemas de permissão

Fenômeno: O conteúdo desaparece após funcionar normalmente por um período.
Métodos de verificação:
Confirme se seu caso se enquadra em:

  • Uso em headset XR
  • Uso de câmera personalizada
  • Uso de AR Engine/ARFoundation em smartphones

Se for um dos casos acima, você pode estar usando uma License de avaliação.

Melhorias sugeridas:

  • Utilize uma License oficial.

Problemas com o conteúdo virtual

Fenômeno: O conteúdo é exibido normalmente, mas desaparece quando a câmera está muito próxima/distante do objeto.
Métodos de verificação:

  • Verifique configurações de recorte próximo/distante: Garanta que os recortes próximos/distantes (near/far clipping) na renderização do conteúdo estejam em intervalos adequados.
  • Verifique o tamanho do modelo de conteúdo: Modelos muito grandes podem causar "clipping" (perda visual) ao se aproximar do objeto; modelos muito pequenos tornam-se ilegíveis ao se distanciar.

Melhorias sugeridas:

  • Defina recortes próximos/distantes adequados.
  • Ajuste o conteúdo virtual para ter dimensões físicas proporcionais ao objeto-alvo.

Resumo e melhores práticas

Problemas de não exibição geralmente originam-se do modelo 3D, implementação, permissões ou conteúdo em si. Recomenda-se verificar sequencialmente:

  1. A License é oficial?
  2. O conteúdo virtual está adequado?
  3. A qualidade do modelo 3D alvo é satisfatória?
  4. Existem erros na implementação ou configuração de desenvolvimento?

Se o problema persistir, forneça logs, gravações de tela etc. para análise via fórum oficial do EasyAR ou suporte técnico.