Table of Contents

Solução de problemas: Conteúdo não exibido/ativado

Ao usar o reconhecimento de imagens na nuvem, podem ocorrer problemas em que o conteúdo virtual não é exibido ou ativado. Este artigo fornece métodos sistemáticos de solução de problemas. É importante lembrar que, na maioria dos casos, as causas de falha no reconhecimento de imagens na nuvem são idênticas às falhas no reconhecimento local. Consulte o capítulo de Solução de problemas do rastreamento de imagens planas. Aqui, abordaremos apenas problemas e soluções específicos do reconhecimento na nuvem.

Causas comuns e métodos de solução de problemas

Problemas de conexão de rede

Sintomas: Nenhuma resposta após o envio da solicitação de reconhecimento ou retorno de código de erro.
Métodos de solução:

  • Verifique se o dispositivo está conectado à internet (Wi-Fi/4G/5G), tente abrir uma página da web para testar.
  • Verifique se o aplicativo possui permissão de acesso à internet.
  • Capture logs de erro de rede no código.
  • Teste a conectividade da API CRS em um navegador (consulte: Verificação de integridade | GET /ping).

Sugestões de melhoria:

  • Adicione detecção de status de rede no aplicativo e notifique quando a rede estiver fraca.
  • Configure tentativas de repetição após o tempo limite da solicitação ou reduza para rastreamento local.

Erros de configuração do serviço

Sintomas: Solicitação de reconhecimento rejeitada, retornando Unauthorized ou Invalid Key.
Métodos de solução:

  • Verifique se a API Key e o Secret do CRS estão corretos no código.
  • Confirme se a URL do Client-end está correta (ex: se não foi acidentalmente preenchida com a URL do Server-end).
  • Confirme se a License Key está ativa e não expirou (verifique no centro de contas do EasyAR).

Sugestões de melhoria:

  • Use o botão Copiar na galeria CRS para copiar suas configurações de serviço relevantes, garantindo o preenchimento correto.

Erros de configuração do banco de dados de alvos/aplicativo

Sintomas: Uma imagem alvo que era reconhecida anteriormente agora falha nas solicitações de reconhecimento.
Métodos de solução:

  • Obtenha o status do alvo via API CRS, confirme se a imagem alvo está com status "Ativado" ("active":"1").
  • Verifique se o ID do alvo é exatamente igual ao usado no código (diferenciando maiúsculas/minúsculas).

Sugestões de melhoria:

  • Ao atualizar/modificar a galeria na nuvem, garanta que os alvos específicos do aplicativo estejam sempre ativados.
  • Verifique o código cuidadosamente.

Falha no carregamento local no modo híbrido

Sintomas: Reconhecimento na nuvem bem-sucedido, mas o rastreamento local não inicia, conteúdo não é exibido.
Métodos de solução:

  • Confirme que o carregamento local do ImageTarget não gerou exceções (verifique logs).
  • Valide se o ImageTracker está habilitado.

Sugestões de melhoria:

  • Use try-catch ao redor da lógica de carregamento local para capturar exceções e tentar novamente.
  • Garanta que o conteúdo virtual seja objetos filhos do ImageTarget e não esteja desativado.

Resumo e práticas recomendadas

Problemas de conteúdo não exibido no reconhecimento na nuvem concentram-se principalmente em três aspectos: rede, configuração do serviço e status do alvo. O modo híbrido requer atenção adicional ao carregamento local. Recomenda-se priorizar a verificação nesta ordem:

  1. Verifique a conexão de rede e a conectividade do serviço CRS;
  2. Verifique as configurações de serviço: License, API Key/Secret, URL do Client-end;
  3. Verifique o status da imagem alvo na galeria CRS e garanta que o ID do alvo corresponda ao do aplicativo;

Para problemas complexos, ative os logs de depuração do EasyAR ou entre em contato com o suporte técnico.