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

O que significa testar códigos QR

Testar códigos QR confirma que o leitor consegue descodificar o conteúdo esperado e que o sistema receptor trata o resultado corretamente. Uma descodificação bem-sucedida é apenas o primeiro passo: o foco, a temporização, os sufixos, a validação e o comportamento da aplicação também têm de ser verificados.

1. Gerar um código QR de teste

Abra o gerador de códigos QR, introduza um texto ou um URL conhecido e gere o código. Comece por um valor simples e só depois acrescente os dados mais longos e os caracteres especiais que a aplicação espera.

O gerador corre localmente, pelo que o conteúdo permanece no navegador. É possível transferir um SVG ou um PNG para impressão, dispositivos de ensaio ou apresentação noutro ecrã.

2. Testar leitores físicos e por câmara

Apresente o código QR num tamanho legível e com contraste suficiente. Leia-o com o dispositivo físico, um leitor manual compatível com QR, a câmara do telemóvel ou a câmara da aplicação. Repita com tamanhos, distâncias, iluminação e amostras impressas diferentes para identificar os limites práticos.

Um leitor apenas de códigos 1D não lê códigos QR. Confirme que o leitor suporta a simbologia QR antes de diagnosticar a aplicação.

3. Testar a introdução de QR em aplicações web, de secretária e de POS

Coloque o foco no campo previsto antes de ler e compare o valor recebido com o conteúdo gerado. Ensaie leituras repetidas, estados vazios ou inválidos da aplicação, URL longos e fluxos que percorrem vários campos.

No teste de POS, confirme que a leitura seleciona o artigo ou a ação correta, preserva o comportamento de quantidade e de preço e não desencadeia uma submissão indesejada.

4. Testar leitores de cunha de teclado e sufixos

Muitos leitores enviam o conteúdo QR descodificado como eventos de teclado. Utilize o testador de introdução de códigos de barras para confirmar o valor exacto, a temporização da rajada e se o dispositivo acrescenta ENTER ou TAB.

Para compreender porque isto funciona, consulte 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 falhadas

• Confirme que o leitor suporta QR Code e que a simbologia está ativa.
• Aumente o tamanho apresentado ou impresso e utilize um código nítido, de contraste elevado.
• Assegure que o código QR completo e a zona de silêncio ficam visíveis para o leitor.
• Verifique o foco, a disposição do teclado e a validação de introdução da aplicação.
• Utilize o testador de eventos de teclado para inspecionar eventos de tecla em bruto.

Testar sem equipamento físico

Quando não há equipamento, utilize o Barcode Scanner Emulator para simular as premidas do leitor e testar o fluxo de introdução da aplicação. Isto verifica o tratamento pela aplicação, mas não substitui a descodificação ótica nem o ensaio do equipamento.

Perguntas frequentes

Como gero um código QR para testes?

Utilize o gerador de códigos QR para introduzir texto ou um URL e criar um código QR localmente no navegador. Apresente-o ou imprima-o e leia-o em seguida com o dispositivo ou a aplicação em ensaio.

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

O leitor tem de suportar simbologias 2D como QR Code. Um leitor apenas 1D não descodifica códigos QR, ainda que ambos os aparelhos possam usar introdução por cunha de teclado.

Como testo ENTER ou TAB após uma leitura de QR?

Leia o código QR gerado no testador de introdução de códigos de barras e observe o sufixo detectado. Configure o leitor ou a aplicação de modo que o sufixo corresponda ao fluxo previsto.