Teste de código QR: como testar leitores de código QR

O que o teste de código QR significa

O teste de código QR verifica se o leitor consegue decodificar o conteúdo esperado e se o sistema receptor trata o resultado corretamente. Uma decodificação bem-sucedida é só o primeiro passo: foco, tempo, sufixos, validação e o comportamento do aplicativo também precisam ser conferidos.

1. Gere um código QR de teste

Abra o gerador de código QR, digite um texto ou URL conhecido e gere o código. Comece com um valor simples e depois acrescente os dados mais longos e os caracteres especiais que o aplicativo espera.

O gerador roda localmente, então o conteúdo fica no navegador. Dá para baixar um SVG ou PNG para impressão, gabaritos de teste ou exibição em outra tela.

2. Teste leitores físicos e por câmera

Mostre o código QR num tamanho legível e com contraste suficiente. Leia com o dispositivo físico, um leitor de mão compatível com QR, a câmera do celular ou a câmera do aplicativo. Repita com tamanhos, distâncias, iluminação e amostras impressas diferentes para achar os limites práticos.

Um leitor só de código 1D não lê códigos QR. Confirme que o leitor aceita a simbologia QR antes de diagnosticar o aplicativo.

3. Teste a entrada de QR em aplicativos web, desktop e POS

Coloque o foco no campo pretendido antes de ler e compare o valor recebido com o conteúdo gerado. Teste leituras repetidas, estados vazios ou inválidos do aplicativo, URLs longas e fluxos que passam por vários campos.

No teste de POS, confira se a leitura seleciona o produto ou a ação certa, preserva o comportamento de quantidade e preço e não dispara um envio indesejado.

4. Teste leitores de cunha de teclado e sufixos

Muitos leitores enviam o conteúdo QR decodificado como eventos de teclado. Use o testador de entrada de código de barras para conferir o valor exato, o tempo da rajada e se o dispositivo acrescenta ENTER ou TAB.

Para entender por que isso funciona, veja o guia da cunha de teclado HID. Se o leitor emitir o sufixo errado, compare a configuração dele com o comportamento que o formulário receptor espera.

Resolver leituras de QR que falham

• Confirme que o leitor aceita QR Code e que a simbologia está ligada.
• Aumente o tamanho exibido ou impresso e use um código nítido, de alto contraste.
• Garanta que o código QR inteiro e a zona de silêncio estejam visíveis para o leitor.
• Verifique foco, layout de teclado e a validação de entrada do aplicativo.
• Use o testador de eventos de teclado para inspecionar eventos de tecla brutos.

Testar sem hardware físico

Quando não houver hardware, use o Barcode Scanner Emulator para simular os pressionamentos do leitor e testar o fluxo de entrada do aplicativo. Isso confere o tratamento pelo aplicativo, mas não substitui a decodificação óptica nem o teste de hardware.

Perguntas frequentes

Como gero um código QR para teste?

Use o gerador de código QR para digitar um texto ou URL e criar um código QR localmente no navegador. Exiba ou imprima e depois leia com o dispositivo ou aplicativo em teste.

Um leitor de código de barras lê um código QR?

O leitor precisa aceitar simbologias 2D como QR Code. Um leitor só 1D não decodifica códigos QR, mesmo que os dois aparelhos usem entrada de cunha de teclado.

Como testo ENTER ou TAB depois de uma leitura de QR?

Leia o código QR gerado no testador de entrada de código de barras e confira o sufixo detectado. Configure o leitor ou o aplicativo para o sufixo combinar com o fluxo pretendido.