Relatório de problemas e feedback

Valorizamos muito o seu feedback, pois é crucial para nos ajudar a melhorar o produto e os serviços do EasyAR Mega. Para que possamos identificar e resolver os problemas que você enfrenta de forma rápida e precisa, por favor, reserve alguns minutos para ler este guia antes de enviar um relatório.

Nossos contatos

Você pode nos enviar relatórios de problemas através dos seguintes canais:

• Comunidade/Fórum oficial de desenvolvedores - Recomendado para perguntas gerais e discussões na comunidade.

  • Usuários em chinês clique aqui
  • Outros usuários clique aqui

• Grupo WeChat corporativo - Adequado para usuários corporativos que precisam de suporte confidencial ou mais formal.

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

• Mais formas de contato - Como alternativa.

  • Para obter informações de contato clique aqui

Elementos essenciais para um relatório de alta qualidade

Um relatório que inclua as informações abaixo nos ajudará imensamente a reproduzir e resolver o problema. Quanto mais completa a informação, mais rápida será a resolução.

Lista geral de relatórios (necessária para todos os problemas)

1. Descrição clara do problema:

   • O que você esperava que acontecesse?
   • O que realmente aconteceu? (Ex.: aplicativo falha repentinamente, falha no posicionamento, conteúdo desloca-se)
   • Com que frequência o problema ocorre (sempre/ocasionalmente)? Sob quais condições ocorre?

2. Informações do dispositivo e ambiente:

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

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

   • Forneça obrigatoriamente o arquivo de gravação EIF que reproduz o problema.
   • Os dados EIF contêm todas as informações de sensores e imagens no momento do problema, sendo nossa ferramenta mais poderosa para diagnóstico. Consulte Coletar dados de simulação de operação para saber como gravar.

4. Arquivo de log (Log):

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

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

   • Gravação de tela ou captura de tela em alta resolução no momento do problema, o que demonstra visualmente o fenômeno descrito.
   • Guias de operação para diferentes dispositivos: Gravação em smartphone, Gravação em headsets.

6. Informações da biblioteca de posicionamento Mega

   • Informações de serviço da biblioteca de posicionamento Mega usada para exportar o aplicativo no Unity. Método de exportação:
     

Lista complementar para tipos específicos de problemas

Para uma localização mais precisa do problema, forneça as seguintes informações adicionais de acordo com o tipo de problema:

A. Falha ou instabilidade no posicionamento

• Já tentou validar no mesmo local usando o Mega Toolbox ou a ferramenta para PC, e qual foi o resultado.
• Confirmou que o mapa carregado na biblioteca de posicionamento corresponde ao espaço físico atual.
• Indique a localização aproximada onde o problema ocorre (ex.: átrio do shopping, entrada de ponto turístico).

B. Conteúdo não exibido

• Já forneceu resultados de validação do posicionamento usando ferramentas externas.
• Já verificou se o posicionamento do conteúdo ou a lógica do código está correta.
• Se for um problema de renderização, forneça uma captura de tela ou descrição do modelo, Shader ou efeito utilizado.

C. Conteúdo pulando ou deslocando

• Descreva como o dispositivo estava sendo movido (movimento suave/rápido).
• Descreva a textura e iluminação do ambiente, e se há áreas confusas extremamente semelhantes.
• Explique a lógica de processamento da pose dentro do aplicativo e confirme que o conteúdo está posicionado corretamente.

D. Problemas em mini-programas WeChat

• Forneceu uma captura de tela mostrando que o usuário concedeu permissão para o serviço Mega dentro do WeChat.
• Esclareceu se o modelo do celular do usuário está na lista oficial de suporte do WeChat.
• Forneceu o AppID do mini-programa e uma descrição específica do cenário de negócios.

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

• Especificou o modelo do dispositivo onde o problema ocorre.
• Forneceu informações sobre uso de CPU/GPU ou temperatura do dispositivo durante a execução do aplicativo (se possível).
• Descreveu a complexidade do conteúdo 3D (número de polígonos do modelo, tamanho das texturas).
• Indicou se está usando configuração de múltiplos mapas.

Exportando 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. Os passos detalhados são:

1. Na barra de menus, acesse EasyAR > Sense > Perguntar
   
2. Em Perguntar, forneça as seguintes informações:

• Marque o ambiente de execução (opção única), por exemplo, 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 na caixa de informações do dispositivo.
  
• Marque todas as funcionalidades do EasyAR que seu aplicativo utiliza, suporta múltipla seleção.
• Confirme que as quatro verificações na página foram concluídas e marcadas, recomenda-se descrever como reproduzir o problema no Sample ao perguntar.
• Clique na função copiar no canto superior direito para concluir a coleta das informações de desenvolvimento do Unity.
  

Sugestão de fluxo para envio de relatório

1. Prepare os materiais: Colete EIF, logs, capturas de tela/gravações, informações de serviço, informações de desenvolvimento, etc., conforme as listas acima.
2. Redija o relatório: Descreva o problema claramente e anexe todos os materiais.
3. Envie: Envie o relatório através do canal escolhido.
4. Acompanhe: Após recebermos o relatório, entraremos em contato via comercial ou e-mail. Por favor, fique atento.

Agradecemos seu tempo e apoio ao produto EasyAR Mega! Cada feedback seu nos ajuda a construir um futuro melhor para a computação espacial.