Table of Contents

Relato e feedback de problemas

Valorizamos muito o seu feedback, pois é fundamental para ajudá - lo a melhorar o produto e serviço do EasyAR Mega. Para que possamos localizar e resolver rapidamente e com precisão os problemas que você enfrenta, por favor, leve alguns minutos para ler este guia antes de enviar um relato.

Nossos canais de contato

Você pode enviar relatos de problemas através dos seguintes canais:

  • Comunidade/Forum oficial de desenvolvedores - Recomendado para questões gerais e comunicação da comunidade.

    • Usuários chineses clique aqui
    • Outros usuários clique aqui

  • Grupo do WeChat empresarial - Adequado para usuários empresariais que precisam de suporte confidencial ou mais formal.

    • Digitalize o código QR abaixo para entrar no grupo

  • Mais canais de contato - Como opção alternativa.

    • Obtenha os canais de contato clicando aqui

Elementos principais para enviar um relato de alta qualidade

Um relato contendo as seguintes informações nos ajudará muito a reproduzir e resolver o problema. Quanto mais completas as informações, mais rápido o problema será resolvido.

Lista de relatos genéricos (necessária para todos os problemas)

  1. Descrição clara do problema:

    • Qual é o efeito que você espera alcançar?
    • O que realmente aconteceu? (Por exemplo: o aplicativo fecha abruptamente, a localização falha, o conteúdo flutua)
    • Qual é a frequência com que o problema ocorre (sempre/ocasionalmente)? Em quais condições ocorre?

  2. Informações do dispositivo e do ambiente:

    • Modelo do dispositivo: Por exemplo, iPhone 14 Pro, Samsung Galaxy S23 Ultra, Apple Vision Pro.
    • Versão do sistema operacional: Por exemplo, iOS 17.2, Android 14, visionOS 26.
    • Versão do EasyAR SDK: Por exemplo, EasyAR Sense Unity Plugin v4.6.0.
    • Ambiente de teste: Indoors/Outdoors, condições de iluminação, se é um ambiente dinâmico.

  3. Dados EIF (a evidência mais importante):

    • Por favor, forneça o arquivo de gravação EIF que possa reproduzir o problema.
    • Os dados EIF contêm todas as informações dos sensores e imagens no momento em que o problema ocorreu e são a ferramenta mais poderosa para diagnosticarmos o problema. Consulte Coletar dados de execução simulada para saber como gravar.

  4. Arquivo de log (Log):

    • Por favor, forneça o log completo do aplicativo no momento em que o problema ocorreu.
    • Android: Saída do Logcat.
    • iOS: Log do Console.app ou saída do console do Xcode.
    • Unity: Log do Console do Unity Editor.
    • Mini - programa do WeChat: Arquivo de log obtido com session.dumpLog().

  5. Gravação de tela ou captura de tela:

    • Gravação de tela ou captura de tela em alta definição no momento em que o problema ocorreu, o que pode mostrar visualmente o fenômeno que você descreveu.
    • As instruções de operação para diferentes dispositivos podem ser consultadas em: Gravação de tela do celular, Gravação de tela do headset.

  6. Informações da biblioteca de localização Mega

    • Exporte as informações de diagnóstico do bloco usadas pelo aplicativo no Unity / as informações do serviço da biblioteca de localização Mega. Método de exportação:

Lista adicional para tipos específicos de problemas

Para localizar o problema com mais precisão, por favor, forneça as seguintes informações adicionais de acordo com o tipo de problema:

A. Falha ou instabilidade na localização

  • Já tentou usar a Mega Toolbox ou a ferramenta do PC na mesma localização para verificar e informe o resultado.
  • Já confirmou que o mapa carregado na biblioteca de localização é consistente com o espaço físico atual.
  • Informe a localização aproximada onde o problema ocorreu (por exemplo, átrio de um shopping, porta de um parque turístico).

B. Conteúdo não é exibido

  • Já forneceu o resultado da verificação da localização usando ferramentas externas.
  • Já confirmou que não há problemas na disposição do conteúdo ou na lógica do código.
  • Se for um problema de renderização, forneça capturas de tela ou descrições do modelo, Shader ou efeito especial usados.

C. Conteúdo treme ou flutua

  • Já informou a forma como o dispositivo se moveu (movimento suave/movimento rápido).
  • Já descreveu as condições de textura e iluminação do ambiente e se há regiões de confusão muito semelhantes.
  • Já informou a lógica de processamento da postura interna do aplicativo e que a disposição do conteúdo está correta.

D. Problemas no mini - programa do WeChat

  • Já forneceu a captura de tela da permissão do usuário para habilitar o serviço Mega no WeChat.
  • Já informou se o modelo do celular do usuário está na lista oficial de suporte do WeChat.
  • Já forneceu o AppID do mini - programa e a descrição do cenário comercial específico.

E. Problemas de desempenho (travamentos, alto consumo de energia)

  • Já informou o modelo do dispositivo em que o problema ocorreu.
  • Já forneceu a taxa de ocupação da CPU/GPU ou as informações de temperatura do dispositivo durante a execução do aplicativo (se possível).
  • Já informou o nível de complexidade do conteúdo 3D (número de faces do modelo, tamanho da textura).
  • Já informou se está usando a configuração de várias imagens.

Exportar informações de desenvolvimento do Unity usando o EasyAR Sense Unity Plugin

Especificamente, para o desenvolvimento de aplicativos Mega na plataforma Unity, preparamos uma ferramenta mais conveniente para gerar informações de feedback. As etapas detalhadas de operação são as seguintes:

  1. Abra EasyAR > Sense > Fazer pergunta no menu
    Fazer pergunta
  2. Forneça as seguintes informações em Fazer pergunta:
    • Marque o ambiente de execução (selecione apenas uma opção), como Android.
    • Copie as informações do dispositivo. No ARSession, defina DiagnosticsController.DumpSession como Log, copie a saída de um quadro e preencha o resultado no campo de informações do dispositivo.
      Dump session
    • Marque todas as funções do EasyAR que seu aplicativo está usando, suporte a seleção múltipla.
    • Certifique - se de que concluiu as quatro verificações na página e marque as caixas. Recomendamos descrever como reproduzir o problema no Sample ao fazer a pergunta.
    • Clique na função de cópia no canto superior direito para concluir a coleta das informações de desenvolvimento do Unity.
      Exportar informações de desenvolvimento do Unity

Recomendação do fluxo de envio de relatos

  1. Prepare os materiais: De acordo com a lista acima, colete EIF, logs, capturas de tela/gravações de tela, informações de serviço, informações de desenvolvimento, etc.
  2. Escreva o relato: Descreva o problema com clareza e anexe todos os materiais.
  3. Envie: Envie o relato através do canal que você escolheu.
  4. Acompanhe: Depois de receber o relato, entraremos em contato com você através do comércio ou e - mail. Por favor, fique atento.

Obrigado pelo seu tempo e pelo suporte ao produto EasyAR Mega! Cada feedback seu está ajudando - nos a construir um futuro melhor para a computação espacial.