Relatório de problema e feedback

Valorizamos muito seu feedback. Ele é essencial para nos ajudar a melhorar os produtos e serviços EasyAR Mega. Para que possamos localizar e resolver de forma rápida e precisa os problemas encontrados, leia este guia por alguns minutos antes de enviar um relatório.

Nossos contatos

Você pode nos enviar relatórios de problemas pelos seguintes canais:

Comunidade/fórum oficial de desenvolvedores - recomendado para perguntas gerais e comunicação da comunidade.
- Usuários chineses clicam aqui
- Outros usuários clicam aqui
Grupo Enterprise WeChat - adequado para usuários enterprise que precisam de confidencialidade ou suporte mais formal.
- Escaneie o QR code abaixo para entrar no grupo
Mais contatos - como alternativa.
- Para obter contatos, clique aqui

Elementos centrais de um relatório de alta qualidade

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

Checklist geral do relatório (necessária para todos os problemas)

Descrição clara do problema:
- Que efeito você esperava alcançar?
- O que aconteceu de fato? Por exemplo: app crash, falha de localization, conteúdo drift.
- Qual a frequência do problema, sempre ou ocasionalmente? Em quais condições ocorre?
Informações de dispositivo e 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: indoor/outdoor, condições de iluminação e se é um ambiente dinâmico.
Dados EIF (a evidência mais importante):
- Forneça obrigatoriamente um arquivo de gravação EIF capaz de reproduzir o problema.
- Os dados EIF contêm todas as informações de sensores e imagens quando o problema ocorre, sendo nossa ferramenta mais poderosa de diagnóstico. Consulte Coletar dados de execução simulada para saber como gravar.
Arquivo de log (Log):
- Forneça o log completo da aplicação quando o problema ocorre.
- Android: saída Logcat.
- iOS: log Console.app ou saída do console Xcode.
- Unity: log Console do Unity Editor.
- WeChat Mini Program: arquivo de log obtido por session.dumpLog().
Gravação de tela ou screenshot:
- Gravação de tela ou screenshot HD quando o problema ocorre, mostrando intuitivamente o fenômeno descrito.
- Guias de operação para diferentes dispositivos: gravação de tela móvel, gravação de tela de headsets.
Informações da Mega localization library
- No Unity, exporte as informações de diagnóstico do block usadas pela aplicação / informações de serviço da Mega localization library. Método de exportação:

Checklist complementar para tipos específicos de problema

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

A. Localization falha ou é instável

Você já tentou usar Mega Toolbox ou tool de PC para verificar no mesmo local e explicou o resultado.
Você confirmou que o mapa carregado na localization library corresponde ao espaço físico atual.
Você indicou a localização aproximada do problema, por exemplo átrio de shopping ou entrada de área turística.

B. Conteúdo não aparece

Você forneceu o resultado de verificação localization usando tool externo.
Você deixou claro que não há problema na colocação do conteúdo ou na lógica do código.
Se for problema de rendering, forneça screenshot ou descrição do modelo, Shader ou efeito usado.

C. Conteúdo salta ou drift

Você descreveu o modo de movimento do dispositivo, por exemplo movimento suave ou rápido.
Você descreveu a textura e iluminação do ambiente, e se existem áreas de confusão extremamente semelhantes.
Você explicou a lógica interna de processamento de pose da aplicação e confirmou que o conteúdo está colocado corretamente.

D. Problema WeChat Mini Program

Você forneceu screenshot do usuário ativando a permissão do serviço Mega no WeChat.
Você explicou se o modelo de celular do usuário está na lista oficial de suporte do WeChat.
Você forneceu o AppID do Mini Program e uma descrição específica do cenário de negócio.

E. Problema de desempenho (lag, alto consumo de energia)

Você descreveu o modelo do dispositivo onde o problema ocorreu.
Você forneceu uso de CPU/GPU ou temperatura do dispositivo durante a execução da aplicação, se possível.
Você descreveu a complexidade do conteúdo 3D, como número de faces do modelo e tamanho de textura.
Você explicou se usa configuração multi-map.

Exportar informações de desenvolvimento Unity com EasyAR Sense Unity Plugin

Especialmente para desenvolvimento de aplicações Mega na plataforma Unity, preparamos um tool mais conveniente para gerar informações de feedback. Os passos detalhados são:

Abra EasyAR > Sense > Ask a Question na barra de menus
Em Ask a Question, forneça as seguintes informações:
- Marque o runtime environment, seleção única, como Android.
- Copie as informações do dispositivo. Em ARSession, defina DiagnosticsController.DumpSession como Log, copie a saída de um frame e preencha o resultado na caixa de informações do dispositivo.
- Marque todas as funções EasyAR usadas em sua aplicação; múltipla seleção é suportada.
- Confirme que concluiu as quatro verificações da página e marcou todas. Ao fazer a pergunta, recomenda-se descrever como reproduzir o problema no Sample.
- Clique na função copiar no canto superior direito para concluir a coleta das informações de desenvolvimento Unity.

Sugestão de fluxo para envio de relatório

Preparar materiais: conforme o checklist acima, colete EIF, logs, screenshots/gravações de tela, informações de serviço, informações de desenvolvimento etc.
Escrever relatório: descreva claramente o problema e anexe todos os materiais.
Enviar: envie o relatório pelo canal escolhido.
Acompanhar: após receber o relatório, entraremos em contato por via comercial ou email. Fique atento.

Obrigado pelo seu tempo e apoio aos produtos EasyAR Mega. Cada feedback seu nos ajuda a construir um futuro melhor para spatial computing.