Table of Contents

Mega FAQ

É inevitável encontrar problemas durante o desenvolvimento. Este documento visa ajudá-lo a localizar e resolver rapidamente questões comuns. Começamos com uma lista de perguntas frequentes (FAQ); se não encontrar aqui a resposta, consulte as seções subsequentes ou envie-nos um relatório de problema.

Perguntas frequentes (FAQ)

Aqui estão alguns dos problemas mais comuns enfrentados pelos desenvolvedores ao integrar e usar o EasyAR Mega, juntamente com suas soluções.

Q: Por que meu aplicativo mostra "Invalid Key"?

A: Geralmente ocorre devido aos seguintes motivos:

  1. License inválida ou expirada
  2. License não corresponde ao Bundle ID / Package Name
  3. Dispositivos headset requerem XR License separada
  4. Funcionalidade de câmera personalizada requer License de versão oficial
Q: Por que há uma marca d'água no meu aplicativo?

A: Isso indica que você está usando uma License de avaliação (trial), não a versão oficial.

Q: Por que meu aplicativo mostra uma contagem regressiva (timeout within * seconds)?

A: Esta é uma limitação durante o período de avaliação do produto. Utilizar a autorização EasyAR Sense de versão oficial e o serviço EasyAR Mega de versão oficial resolve esse problema.

Q: Por que meu aplicativo abre com tela preta?

A: Neste caso, o motivo do erro geralmente é exibido nas informações da tela ou nos logs. Você pode resolver o problema com base na causa específica exibida pelo sistema. Se não conseguir resolver, forneça informações técnicas (incluindo logs, capturas de tela, informações detalhadas do dispositivo, etc.).

Q: Por que meu aplicativo não consegue localizar, retornando sempre o estado "NotFound"?

A: Geralmente ocorre devido aos seguintes motivos:

  1. Serviço de localização ainda está iniciando:
    Neste momento, o serviço de localização ainda não carregou completamente todos os mapas Mega, portanto, não pode garantir sucesso na localização em uma determinada área.
  2. Fora da área de cobertura do mapa:
    Certifique-se de que sua localização física atual esteja dentro da área coberta pelo mapa Mega que você carregou.
  3. Erro de configuração de teste simulado:
    Não está sendo executado no local, mas MegaLocationInputMode foi definido erroneamente como Onsite.
  4. Condições ambientais inadequadas:
    Iluminação extrema (muito escuro ou muito claro), grandes superfícies de parede ou piso monocromático (como parede branca, piso polido) prejudicam a localização visual.
Q: Por que meu aplicativo não consegue localizar, retornando um estado anômalo?

A: Geralmente ocorre devido aos seguintes motivos:

  1. Tempo limite da solicitação:
    O sistema retornará RequestTimeout.
  2. Intervalo entre solicitações muito curto:
    O sistema retornará RequestIntervalTooLow.
  3. Outros erros anômalos:
    O sistema retornará UnknownError. Geralmente, essas exceções correspondem a falhas na conexão ou transmissão, ou a um erro no próprio serviço Mega. Detalhes podem ser obtidos através da interface MegaBlockLocalizationResponse.ErrorMessage.
Q: Por que meu aplicativo mini-programa falha ao solicitar o uso do plugin?

A: Isso ocorre porque os plugins de mini-programa não são compatíveis com o "modo visitante" da ferramenta de desenvolvimento do WeChat e também não são compatíveis com mini-programas cujo titular seja uma pessoa física. Solicite usando um AppId de mini-programa WeChat com titularidade empresarial.

P: Por que minha autorização de mini programa não foi aprovada?

R: Você precisa obter a licença do plugin Mega Mini Program no centro de desenvolvimento e garantir que o AppId utilizado seja o mesmo da licença.

P: Por que meu mini programa não funciona em celulares XX?

R: A integração do Mega em mini programas depende do componente VisionKit do WeChat. Os requisitos de sistema e lista de dispositivos suportados estão na documentação do WeChat.

P: A localização foi bem-sucedida, mas o conteúdo virtual parece desalinhado ou com deriva?

R: Problemas de posicionamento geralmente têm causas complexas. Possíveis razões:

  1. Problema de precisão de mapeamento:
    O mapa Mega dessa área pode ter imprecisões. Isso geralmente ocorre durante a coleta/reconstrução do mapa. Contate o comercial para confirmar.
  2. Salto durante inicialização:
    Nos primeiros segundos de localização, pode haver leve oscilação. Isso ocorre porque o sistema SLAM do dispositivo ainda não finalizou a inicialização – especialmente perceptível em mini programas WeChat (em alguns dispositivos pode demorar mais).
  3. Alterações ambientais dinâmicas:
    Mudanças físicas significativas (como reposição de objetos grandes ou adição de placas temporárias) podem causar incompatibilidade entre mapa e ambiente. Nesse caso, o mapa precisa ser atualizado.
  4. Erro sistêmico do dispositivo:
    A maioria dos dispositivos acumula erros no sistema SLAM após uso contínuo prolongado, causando deriva.
  5. Problema de precisão de localização:
    A própria localização visual tem margem de erro, normalmente não afetando a experiência. Se o erro causar desalinhamento ou deriva evidentes, serão necessários dados detalhados para análise. Siga o método em diagnóstico e relatório de problemas para coleta de dados e feedback.
P: Como coletar e usar dados EIF para depuração?

R: Dados EIF são ferramentas poderosas de depuração. Consulte:

  • Como coletar: Leia gravação de dados simulados para gravar arquivos EIF em celulares ou headsets.
  • Como reproduzir: Siga o guia de reprodução correspondente no capítulo, conforme seu ambiente (Unity ou mini programa WeChat).

Encontrando ajuda mais específica

Se as FAQ acima não resolverem seu problema, você pode visitar as seguintes páginas temáticas para soluções mais aprofundadas:

Reportar um problema novo

Se você encontrou um problema não coberto acima, suspeitando ser do SDK ou da própria plataforma, ajude-nos a melhorar o produto. Para etapas ou orientações detalhadas, consulte: Relatório de problemas.

Antes de enviar o relatório, certifique-se de ter as seguintes informações prontas, o que nos ajudará muito a resolver o problema:

  1. Descrição do problema: Descreva claramente o fenômeno encontrado, frequência e etapas para reproduzi-lo.
  2. Informações do dispositivo: Modelo do dispositivo, versão do sistema operacional, versão do EasyAR SDK.
  3. Dados EIF: Forneça obrigatoriamente o arquivo de gravação EIF que reproduz o problema. Esta é a evidência de diagnóstico mais importante.
  4. Arquivo de log: Log completo do aplicativo (saída do Logcat ou Console).
  5. Gravação de tela ou captura de tela: Gravação ou captura de tela no momento em que o problema ocorreu.

Envie essas informações através de nosso fórum, e-mail ou contato comercial. Agradecemos seu feedback!