Table of Contents

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

Este artigo fornece métodos sistemáticos de verificação e sugestões de melhoria para problemas comuns de falha na exibição de conteúdo virtual em rastreamento de imagens planas, ajudando desenvolvedores a identificar 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 de imagem, erros de implementação funcional ou restrições de permissão. Abaixo estão as principais causas e etapas de verificação:

Falha no reconhecimento de imagem

Fenómeno: O conteúdo virtual não aparece quando a câmara é direcionada para a imagem alvo.
Métodos de verificação:

  • Verifique a reconhecibilidade da imagem: Use a ferramenta de deteção de imagem alvo para carregar a imagem, garantindo que a pontuação de reconhecibilidade atinja 4-5 estrelas.
  • Valide a qualidade da imagem: Garanta que a imagem cumpra os requisitos de textura, dimensão e proporção nas melhores práticas.
  • Verifique o objeto físico: Garanta que a superfície do objeto físico (ex: poster, cartão) não tenha reflexos e esteja plana, sem dobras.
  • Verifique os registos (logs): Consulte os registos da aplicação, procurando pelo evento TargetLoad para confirmar se a imagem alvo foi carregada com sucesso.

Sugestões de melhoria:

  • Otimize a imagem: Aumente o contraste, evite padrões repetitivos, garanta que o objeto principal ocupe mais de 70% da imagem.
  • Substitua a imagem: Se o problema persistir após otimização, use imagens de teste oficiais do Sample (ex: namecard.jpg) para verificar se o problema está na imagem original.
  • Garanta o objeto físico: Use superfícies fosca ou ásperas, mantendo-as planas sem dobras ou curvaturas.
  • Verifique a lógica: Garanta que a aplicação carregou corretamente a imagem alvo usada no teste.

Erro de implementação funcional

Fenómeno: A imagem é reconhecida, 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 ImageTarget:
    • Conforme o tipo de Source, verifique se aponta para o ficheiro correto na pasta StreamingAssets.
    • Se Scale está definido com o tamanho físico real.
  • Confirme a hierarquia do prefab: O conteúdo virtual (ex: Cube) deve ser um nó filho de ImageTarget e não estar desativado.

Sugestões de melhoria:

  • Reconfigure: Elimine e recrie o ImageTarget na cena, arrastando o prefab conforme normas e vinculando a imagem.
  • Simplifique o teste: Remova temporariamente scripts personalizados, mantendo apenas um Cube básico para confirmar a cena mínima funcional.
  • Verifique registos: Procure erros relacionados a ImageTargetController, como fail to load target data.

Problemas de permissão

Fenómeno: O conteúdo desaparece após funcionar normalmente durante algum tempo.
Métodos de verificação:
Confirme se corresponde a um dos seguintes cenários:

  • Uso em headset XR
  • Uso de câmara personalizada
  • Uso de AR Engine/ARFoundation em telemóvel

Se estiver num destes cenários, provavelmente está a usar uma License de versão trial.

Sugestões de melhoria:

  • Use uma License de versão oficial.

Problemas com conteúdo virtual

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

  • Verifique configurações near/far clip: Garanta que as configurações de recorte próximo (near) e distante (far) na renderização estejam em intervalos adequados.
  • Verifique dimensão do modelo: Modelos muito grandes podem causar "clipping" quando próximos do alvo; modelos muito pequenos tornam-se ilegíveis quando distantes.

Sugestões de melhoria:

  • Defina valores adequados para near/far clip.
  • Dimensione o conteúdo virtual proporcionalmente ao tamanho físico do objeto alvo.

Resumo e melhores práticas

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

  1. Confirme se a License é oficial;
  2. Verifique se o conteúdo virtual está adequado;
  3. Valide a qualidade da imagem alvo;
  4. Confirme erros na implementação ou configuração de desenvolvimento.

Se o problema persistir, forneça registos (logs), gravações de ecrã ou outros detalhes via fórum oficial da EasyAR ou suporte técnico para análise aprofundada.