Uma gravação de relatório de bug deve mostrar uma sequência ininterrupta desde a primeira ação até a falha, com o número da versão, o cursor e o texto exato do erro todos visíveis na tela. Grave em uma aba do navegador, mantenha o clipe abaixo de um minuto e não envie uma tela interna a um serviço de gravação de terceiros.
O clipe é evidência, não uma demonstração, então ele só precisa ser longo o bastante para provar que a falha existe e permitir que outra pessoa a reproduza. Isso costuma ser 20 a 45 segundos: abra a tela, clique pelos dois ou três passos que acionam o problema, depois segure no erro por um instante. Deixe o microfone ligado e narre o que você está fazendo, porque uma voz dizendo que o botão deveria ter fechado a caixa de diálogo remove a adivinhação que um clipe silencioso deixa. Depois de gravado, corte o silêncio das duas pontas e comprima o arquivo antes de anexá-lo ao ticket.
Um vídeo de relatório de bug tem dois públicos que puxam em direções opostas. O desenvolvedor quer cada detalhe que comprova a falha, e a pessoa que aprova o envio não quer nenhum dos dados de cliente que por acaso estão na mesma tela. Um bom clipe satisfaz os dois, e leva cerca de trinta segundos de preparação.
Gravador de tela
Grave uma tela, uma janela ou uma aba do navegador com o seu microfone, inteiramente na aba do navegador. Nada é enviado, e o arquivo cai direto na sua pasta de downloads.
O que contém um vídeo de reprodução de bug utilizável
Um clipe que faz um bug ser corrigido tem que responder a quatro perguntas sem uma mensagem de acompanhamento: o que você fez, o que esperava, o que de fato aconteceu e em qual versão você estava. Uma captura silenciosa da área de trabalho inteira não responde a nenhuma delas, porque quem assiste tem que adivinhar onde olhar.
| Elemento | Por que isso pertence ao clipe |
|---|---|
| A sequência completa de cliques | Mostra a causa, e não apenas o sintoma |
| Número de build ou versão | Vincula a correção a uma versão |
| O texto exato do erro | Pode ser pesquisado; uma paráfrase não |
| A URL ou o caminho do arquivo | Diz qual ambiente e quais dados |
| Um cursor visível | Comprova onde o clique de fato caiu |
Uma sequência contínua, em ordem
Grave a reprodução desde o primeiro clique, e não a partir do momento em que quebra. A causa costuma estar dois ou três passos antes do sintoma, então um clipe que começa na tela de erro deixa o desenvolvedor pedindo a parte que falta. Um único arquivo que vai da primeira ação até a falha é mais convincente do que três clipes que cada um começa no meio do fluxo.
A versão e o ambiente, na tela
Abra a caixa Sobre, o rodapé ou a barra de status que mostra o número de build antes de começar, e deixe-a no quadro. "Quebrou na minha máquina" não é acionável; "quebrou na 4.11.2, Windows 11, Chrome 140" é. Se houver uma sobreposição de depuração ou um selo de ambiente, mantenha-o visível durante todo o clipe.
O texto exato do erro, não o seu resumo
Mantenha o console, o toast ou a mensagem de erro em linha na tela e fique parado por um segundo. Um desenvolvedor consegue pesquisar um stack trace, mas não "ele disse algo sobre null". Se a mensagem estiver em um console de desenvolvedor, abra esse console antes do passo final, para que o texto chegue à câmera, e role-o para a vista devagar.
Feedback de cursor e clique
Mova o ponteiro de forma deliberada e faça uma pequena pausa antes de cada clique. Uma gravação de tela não carrega nenhum feedback de clique que um compartilhamento de tela ao vivo oferece, então um movimento lento e visível é a única pista de onde a ação caiu. Um ritmo calmo também torna o clipe mais fácil de cortar.
Antes de você apertar gravar
A maior parte da qualidade em um clipe de bug é decidida nos trinta segundos antes de a gravação começar. Duas das verificações abaixo são sobre legibilidade e duas são sobre não publicar nada que você não pretendia publicar.
Feche janelas não relacionadas e silencie as notificações
Ative o Não Perturbe, saia do cliente de chat e feche as abas que não fazem parte da reprodução. Uma faixa de notificação deslizando sobre a mensagem de erro pode esconder o único quadro que o desenvolvedor precisava, e é o motivo mais comum pelo qual um clipe tem que ser gravado de novo. Um aviso de atualização faz o mesmo.
Decida o que não pode estar no quadro
Olhe a tela inteira como um estranho olharia: barras de favoritos, um segundo monitor, um e-mail aberto, a linha de outro cliente na mesma tabela. Se a falha só se reproduz com dados reais de cliente, use o menor registro que ainda mostre o problema, ou uma conta de teste. Censurar um vídeo depois é bem mais trabalho do que escolher uma janela limpa.
Ajuste o tamanho da janela antes de capturá-la
Redimensione o navegador ou o aplicativo para uma janela normal em vez de capturar tela cheia em um monitor grande. Uma captura de 2560 pixels de largura encolhe o texto além da legibilidade quando o visualizador de tickets a reduz, enquanto uma janela de 1280 pixels permanece legível no reprodutor em linha. Ela também mantém o arquivo bruto menor.
Como gravar a reprodução
- Abra o gravador e escolha o que compartilhar. Escolha a aba do navegador ou a janela única em vez da tela inteira quando a falha fica em um só lugar, porque o navegador então entrega apenas essa superfície. Deixe a opção "Incluir microfone" ligada para que a sua narração seja capturada com o vídeo.
- Percorra a reprodução uma vez, devagar, em voz alta. Diga a versão em que você está, diga o que espera antes do clique final, e depois diga o que aconteceu em vez disso. Faça uma pausa no erro para que um quadro possa ser citado, e pare com o botão Parar.
- Assista à pré-visualização antes de baixar. O gravador mostra o clipe finalizado e seu tamanho assim que você para, então confira se a mensagem de erro é realmente legível antes de salvá-lo. Se uma notificação estragou a tomada, grave de novo; uma segunda tentativa é mais barata do que uma ida e volta no ticket.
Você também pode pausar e retomar no meio da gravação se um passo precisar de um momento de preparação que não pertence à evidência. A gravação é escrita como um único arquivo de qualquer forma, e o navegador a para automaticamente se você encerrar o compartilhamento de tela pela barra de compartilhamento.
O microfone é o único áudio que você obtém
Este gravador captura vídeo da tela e, se você deixar a opção ativada, mistura o seu microfone por meio de um pedido de permissão separado. Ele não captura o áudio do sistema: nenhum som de aplicativo, nenhum áudio de aba, nenhum dos toques que o sistema operacional faz. Para um relatório de bug esse costuma ser o padrão correto, porque o áudio que ajuda um desenvolvedor é a sua descrição do comportamento esperado, e não o ruído que o aplicativo faz.
O que dizer em voz alta
- Diga a versão e o ambiente no início, mesmo que o número de build também esteja na tela.
- Diga o que você espera antes do clique decisivo: "isso deveria salvar e fechar a caixa de diálogo".
- Diga o que de fato aconteceu logo depois: "ficou aberto e o indicador de carregamento nunca parou".
- Mencione com que frequência acontece: sempre, ou uma vez em cinco.
Mantenha a narração curta e factual. Um desenvolvedor assistindo em velocidade deveria conseguir acompanhar o clipe com o som desligado e ainda entender a sequência, com a voz apenas confirmando a intenção por trás de cada clique.
Corte e comprima antes de anexá-lo
Uma captura bruta é quase sempre mais longa e maior do que o ticket precisa. Os primeiros dois segundos geralmente mostram você trocando de janela para chegar ao gravador, e os últimos mostram você procurando o botão de parar. Cortar as duas pontas não custa nada.
Use o cortador de vídeo para o corte. Seu modo rápido copia os fluxos originais sem recodificar, então o corte é rápido e a qualidade não é tocada, embora o novo ponto de início se ajuste ao keyframe mais próximo. O modo preciso recodifica para que o corte caia exatamente no quadro que você escolheu, o que vale a pena quando o primeiro clique acontece a menos de um segundo do início.
Depois passe o resultado pelo compressor de vídeo se o arquivo ainda estiver pesado para um anexo de rastreador. Reduzir uma captura de 1080p para 720p a 30 fps normalmente tira de 60 a 80 por cento do tamanho, e o texto na tela permanece legível nessa resolução, que é a única coisa que um clipe de bug realmente precisa preservar.
Cortador de vídeo
Corte o silêncio das duas pontas. O modo rápido copia os fluxos, então a qualidade não é tocada; o modo preciso corta exatamente onde você marcou.
O que este gravador não faz
Vale saber antes de começar, porque esses são os casos em que uma abordagem diferente é a resposta certa.
- Sem áudio do sistema ou da aba. O fluxo da tela é capturado apenas como vídeo, e o seu microfone é misturado separadamente. A ferramenta não consegue gravar o som que um aplicativo ou uma aba do navegador está tocando.
- A saída é WebM. Os navegadores codificam WebM nativamente, então é isso que você obtém. O botão "Converter para MP4" abre o conversor de vídeo, o caminho para um MP4 para rastreadores que não pré-visualizam WebM.
- Sem anotação, desfoque ou destaque do cursor. Você não consegue desenhar no quadro nem censurar uma região depois, então grave uma versão limpa se um quadro precisar ser coberto.
- Nada é editado dentro do gravador. Pausar e retomar são os únicos controles em andamento. Cortar e comprimir acontecem depois, nas ferramentas acima.
- A gravação fica na memória até você parar. Uma captura longa em alta resolução preenche a memória da página, então mantenha os clipes de reprodução curtos e deixe a aba fechar só depois de você ter salvado o arquivo.
- Sem sobreposição de webcam. Não há inserção de picture-in-picture para o seu rosto. Se você quiser uma tomada de câmera junto com a tela, grave-a separadamente com o gravador de webcam.
Por que uma reprodução de bug não deve passar por um gravador de terceiros
O atalho óbvio é um gravador em nuvem: aperte gravar, receba um link compartilhável, cole no ticket. Esse link tem a forma errada para um relatório de bug, porque do outro lado está uma tela de administração interna, uma lista de clientes, uma URL de staging ou um recurso não lançado. Um gravador hospedado armazena isso no disco de outra pessoa, sob uma política de retenção que você não controla.
| Aihangsoft | Gravador em nuvem | |
|---|---|---|
| Para onde vai o vídeo | Fica na aba do navegador | Enviado para os servidores deles |
| Quem pode assistir | Apenas as pessoas a quem você envia o arquivo | Qualquer pessoa com o link, até ele expirar |
| Retenção | Nenhum, é um arquivo no seu disco | A política deles, que você não consegue auditar |
| Conta | Não necessário | Geralmente obrigatório para manter o link ativo |
| Corte e compressão | Ferramentas locais separadas, sem upload | Às vezes atrás de um plano pago |
Você não precisa aceitar a alegação de privacidade por fé. Abra as ferramentas de desenvolvedor do navegador, mude para o painel de rede e grave um clipe curto enquanto observa a lista de requisições. Nenhuma requisição carrega o vídeo, porque a codificação acontece na página; o único tráfego é o próprio código do gravador, buscado uma vez.