Table of Contents

FAQ Mega

Encontrar problemas durante o desenvolvimento e inevitavel. Este artigo ajuda voce a localizar e resolver rapidamente problemas comuns. Comecamos com uma lista de perguntas frequentes (FAQ). Se nao encontrar a resposta aqui, consulte os capitulos seguintes ou envie um relatorio de problema.

Perguntas frequentes (FAQ)

A seguir estao alguns dos problemas e solucoes mais comuns que desenvolvedores encontram ao integrar e usar EasyAR Mega.

Q: Por que minha aplicação mostra Invalid Key?

A: Isso geralmente é causado por um dos seguintes motivos:

  1. A License é inválida ou expirou
  2. A License não corresponde ao Bundle ID / Package Name
  3. Dispositivos headset exigem uma XR License separada
  4. O recurso de câmera personalizada exige uma License oficial
Q: Por que minha aplicação tem uma marca d'água?

A: Isso indica que a License usada é uma versão trial, não uma versão oficial.

Q: Por que minha aplicação mostra um aviso de contagem regressiva, timeout within * seconds?

A: Esta é uma limitação durante o período do produto trial. Usar uma licença oficial do EasyAR Sense e o serviço oficial EasyAR Mega pode resolver esse problema.

Q: Por que minha aplicação abre com tela preta?

A: Nesse caso, o motivo do erro geralmente é impresso nas informações da tela ou nos logs. Você pode resolver conforme o motivo específico impresso pelo sistema. Se não conseguir resolver, envie informações técnicas, incluindo logs, capturas de tela, informações detalhadas do dispositivo etc.

Q: Por que minha aplicação não consegue fazer localization e o status retornado permanece NotFound?

A: Isso geralmente é causado por um dos seguintes motivos:

  1. O serviço localization ainda está iniciando:
    Nesse momento, o serviço localization ainda não carregou completamente todos os mapas Mega, portanto não é possível garantir localization bem-sucedida em uma determinada área.
  2. Fora da cobertura do mapa:
    Certifique-se de que sua localização física atual esteja dentro da área de cobertura do mapa Mega carregado.
  3. Configuração incorreta de simulation test:
    A aplicação não está rodando no local, mas MegaLocationInputMode foi definido incorretamente como Onsite.
  4. Condições ambientais ruins:
    Iluminação extrema, escura demais ou clara demais, grandes áreas de paredes ou pisos de cor sólida, como paredes brancas ou pisos polidos, podem afetar visual localization.
Q: Por que minha aplicação não consegue fazer localization e o status retornado é anormal?

A: Isso geralmente é causado por um dos seguintes motivos:

  1. Request timeout:
    O sistema retorna RequestTimeout.
  2. Intervalo de request muito curto:
    O sistema retorna RequestIntervalTooLow.
  3. Outros erros anormais:
    O sistema retorna UnknownError. Em geral, essas anomalias correspondem a falhas durante conexão ou transmissão, ou a erros do próprio serviço Mega. Você pode obter detalhes pela interface MegaBlockLocalizationResponse.ErrorMessage.
Q: Por que minha solicitação de uso do plugin Mini Program falhou?

A: Isso ocorre porque plugins Mini Program não suportam uso no “visitor mode” do WeChat Developer Tools, nem suportam Mini Programs cujo sujeito é individual. Use o AppId de um WeChat Mini Program com sujeito empresarial para solicitar.

Q: Por que a autorização do meu Mini Program não foi aprovada?

A: Você precisa obter uma Mega Mini Program plugin license no developer center e garantir que o AppId usado seja o mesmo da license.

Q: Por que meu Mini Program não pode ser usado no telefone XX?

A: Integrar Mega em um Mini Program depende do componente VisionKit do WeChat. Para system requirements e lista de device support, consulte WeChat documentation.

Q: Localization foi bem-sucedida, mas por que a posição do conteúdo virtual parece ter offset ou drifting?

A: Problemas envolvendo efeitos de localization muitas vezes têm causas complexas. As causas possíveis incluem:

  1. Problema de precisão do mapping:
    A Mega map desta área pode ter erros de precisão. Isso geralmente ocorre durante a etapa de map collection ou reconstruction. Entre em contato com o suporte comercial para confirmação.
  2. Saltos durante initialization:
    Nos primeiros segundos após o início da localization, a posição pode saltar levemente. Isso ocorre porque o sistema SLAM do device ainda não concluiu initialization. No WeChat Mini Program, esse processo é especialmente evidente, e em alguns devices pode até levar bastante tempo.
  3. Mudanças dinâmicas no ambiente:
    Se o ambiente físico mudar significativamente, como mover grandes instalações ou adicionar painéis temporários, a map pode deixar de corresponder à realidade. Nesse caso, a map precisa ser atualizada.
  4. Erro do sistema do device:
    Depois que a maioria dos devices funciona continuamente por muito tempo, os erros acumulados de seus sistemas SLAM podem causar drifting.
  5. Problema de erro de localization:
    Visual localization em si tem erros de precisão. Normalmente, esse tipo de erro não afeta a experiência visual do conteúdo virtual. Se o erro for grande o suficiente para causar offset ou drifting evidente, dados detalhados serão necessários para análise e resolução. Consulte os métodos descritos em issue diagnosis and report para coletar dados e fornecer feedback.
Q: Como coletar e usar dados EIF para debugging?

A: Dados EIF são uma debugging tool poderosa. Consulte as seções a seguir:

  • Como coletar: Leia collect simulated runtime data para saber como gravar arquivos EIF em um telefone ou headset.
  • Como replay: De acordo com seu development environment, Unity ou WeChat Mini Program, consulte a replay guide correspondente nessa seção.

Encontrar ajuda mais especifica

Se o FAQ acima nao resolver seu problema, visite as seguintes paginas de topico para obter solucoes mais aprofundadas:

Relatar um novo problema

Se voce encontrar um problema nao coberto acima que pareca estar relacionado ao SDK ou a propria plataforma, ajude-nos a melhorar o produto. Para etapas ou orientacoes detalhadas, consulte: relatorio de problema.

Antes de enviar um relatorio, certifique-se de ter preparado as seguintes informacoes. Isso nos ajudara muito a resolver o problema:

  1. Descricao do problema: Descreva claramente o fenomeno, a frequencia e as etapas de operacao.
  2. Informacoes do dispositivo: Modelo do dispositivo, versao do sistema operacional e versao do EasyAR SDK.
  3. Dados EIF: Forneca obrigatoriamente o arquivo de gravacao EIF que possa reproduzir o problema. Esta e a evidencia diagnostica mais importante.
  4. Arquivos de log: Logs completos do aplicativo, saida Logcat ou Console.
  5. Gravacao de tela ou screenshots: Gravacao de tela ou screenshots quando o problema ocorre.

Envie as informacoes acima por forum, email ou contato comercial. Obrigado pelo feedback!