Meu QR code não lê: por que e como resolver
Quase sempre é uma de oito coisas, e as três primeiras explicam a maioria dos casos. Estão ordenadas por frequência real, então descer a lista provavelmente encontra o seu problema em um minuto.
1. Falta a margem branca em volta
A causa mais comum e a menos conhecida. Um QR code precisa de uma borda vazia de no mínimo quatro módulos, ou seja quatro vezes a largura de um dos seus quadradinhos pequenos. Sem essa margem, o leitor não distingue onde o código termina e simplesmente não o reconhece.
Acontece sempre que alguém corta o código rente à borda, cola contra o corte de um cartão ou encosta um texto do lado. A solução é deixar em volta um espaço limpo de aproximadamente 10 por cento da largura do código, na mesma cor clara do fundo.
2. O contraste é baixo ou está invertido
Os quadrados precisam ser escuros e o fundo claro. Se você escolheu um tom pastel para os quadrados, ou um fundo meio escuro, o leitor hesita. E se inverteu o esquema, claro sobre escuro, alguns celulares leem e outros não.
O teste rápido: olhe o código com os olhos semicerrados, ou converta para escala de cinza. Se os quadrados não se destacam com clareza do fundo, a câmera também não vai separar. Volte para escuro sobre claro e o problema desaparece.
3. Está pequeno demais para a distância
A regra é um décimo da distância de leitura: 3 centímetros para ler a 30, 20 centímetros para ler a 2 metros. E existe um piso de 2 por 2 centímetros abaixo do qual a impressão junta os quadradinhos, não importa a distância.
Se o código está num cartaz alto ou distante, meça a distância real em que a pessoa vai ficar, não a que você imaginou no desenho. É um erro rotineiro: na tela o QR parece enorme, na parede fica a quatro metros de qualquer olho humano.
4. Guarda texto demais
Mais conteúdo significa mais quadradinhos e mais finos. Um endereço web longo com parâmetros de campanha, ou um vCard com todos os campos preenchidos, gera um código denso que precisa de bem mais tamanho e luz para ser lido.
A solução é reduzir o que ele guarda: encurte o endereço, tire os campos que o vCard não precisa, ou se for um texto longo mova para uma página web e use um QR de link. Um código com menos informação é literalmente mais fácil de ler.
5. Reflexos e superfícies curvas
Se o código está em papel brilhante, plastificado, atrás de vidro ou sobre metal, o reflexo de uma única lâmpada pode cobrir exatamente a parte de que a câmera precisa. A pessoa mexe o celular, não acontece nada, e desiste.
Escolha acabamento fosco quando puder. Quando não puder, aumente o código uns 20 por cento para comprar margem. Em superfícies curvas como garrafas ou latas, posicione na área mais plana e teste na embalagem real antes de fechar a tiragem.
6. O logo cobre demais
Os QR codes toleram alguma obstrução graças à correção de erros, até cerca de 30 por cento no nível mais alto. Mas essa folga não é uma permissão: é o colchão que protege de manchas, dobras e luz ruim. Se gastar tudo no logo, não sobra nada para o mundo real.
Fique abaixo de 15 por cento da área, centralizado, e nunca cubra os três quadrados grandes dos cantos: são eles que o leitor usa para se orientar, e sem eles o código é ilegível.
7. A impressão saiu ruim
Uma impressora com pouco toner, cabeça suja ou papel poroso podem deixar os quadradinhos cinzas, corridos ou empastados. Dá para ver de perto: as bordas precisam estar nítidas, não difusas.
Se você imprimiu de uma foto ou de uma captura de tela do código, o problema está aí: a imagem já vinha degradada. Baixe o PNG original, ou melhor o SVG, e imprima desse arquivo.
8. O código está bom e o destino está quebrado
Vale separar duas falhas que parecem idênticas. Se o celular não reconhece nada ao apontar, o problema é o código. Se o celular lê o código e mostra o endereço, mas depois a página não carrega ou dá erro, o código está perfeito e o problema é o destino.
Nesse segundo caso, confira se o endereço está escrito certo, se inclui o domínio completo e se a página funciona quando você abre na mão num navegador. É surpreendentemente comum descobrir que o QR estava certo o tempo todo.