Por que o seu QR code não está escaneando

Um QR code que “simplesmente não escaneia” raramente está quebrado do jeito que as pessoas imaginam. O desenho costuma estar bem — o que está errado é como ele foi impresso, dimensionado ou posicionado, e cada um desses problemas tem conserto assim que você descobre com qual deles está lidando. Abaixo estão as oito causas que vale conferir, mais ou menos na ordem de quantas vezes cada uma acaba sendo a culpada, com a solução para cada.

1. Ele é pequeno demais para a distância de onde as pessoas estão

Essa é a falha mais comum, e costuma ser autoinfligida: um código dimensionado para ficar bonitinho em um cartão é reaproveitado em um cartaz a três metros, e uma câmera não consegue resolver módulos tão pequenos àquela distância. A solução é uma regra fixa — a largura mínima é igual à distância de leitura dividida por dez. Um cartaz lido de três metros precisa de um código de pelo menos 30cm de largura; uma etiqueta de prateleira lida a 20cm precisa de apenas 2cm. Se você ainda não dimensiona por essa regra, é a primeira coisa a checar — veja a nossa explicação completa da regra 10:1, com exemplos resolvidos para cada tamanho comum de impressão.

2. O contraste entre código e fundo é baixo demais

Um leitor de QR não está lendo cor, está lendo claro contra escuro, e precisa de uma diferença real entre os dois para engatar. Pastel sobre branco, ou uma cor de logo só um tom mais escura que o fundo, muitas vezes parece legível para uma pessoa e é quase invisível para a exposição de uma câmera. O nosso próprio validador rejeita qualquer coisa abaixo de uma razão de contraste de 3:1 entre código e fundo — um piso razoável mesmo sem um validador, e um primeiro plano genuinamente escuro sobre um fundo genuinamente claro é o padrão mais seguro.

3. As cores estão invertidas

Um código claro sobre fundo escuro pode funcionar, mas não é o padrão seguro que parece ser. Muitos aplicativos de leitura, principalmente os mais antigos embutidos em apps que não são de câmera, presumem módulos escuros sobre claro e não checam o contrário. Se você foi de claro em escuro de propósito, teste em mais de um aparelho antes de imprimir em escala — veja o nosso texto sobre esse trade-off para saber o que testar.

4. A zona de silêncio foi cortada

A borda em branco em volta de um QR code não é espaço desperdiçado — é como um leitor encontra o limite do desenho, para começo de conversa. A especificação exige pelo menos quatro módulos de espaço livre em cada lado, e o nosso próprio renderizador usa exatamente isso. Corte essa borda para caber em um layout apertado, ou imprima outro elemento de design dentro dela, e uma câmera que decodifica módulos perfeitamente legíveis ainda pode não achar onde o código começa. Essa é uma falha comum em cartões de visita, em que cada milímetro parece precioso — se um código só falha quando está dentro de outra arte, cheque a margem primeiro.

5. O logo é maior do que o código tolera

Um logo colocado no centro de um QR code consome o orçamento de correção de erros que, de outro modo, se recuperaria do ruído de impressão ou de um pouco de reflexo. Vá longe demais e não sobra nada para a recuperação. O limite depende do nível de correção de erros e é medido como fatia da largura do código, não da área — uma confusão cara, já que 25% de largura é só cerca de 6% de área. Cobrimos os números exatos, e por que o espaçamento os aperta ainda mais, no artigo companheiro sobre tamanho de logo.

6. A superfície está danificada ou curva demais

Um QR code impresso em uma etiqueta de produto curva, em um ingresso amassado ou em uma superfície com um arranhão atravessado está pedindo à correção de erros para trabalhar de verdade, e os níveis mais baixos não têm muito orçamento para gastar. Se um código precisa sobreviver a manuseio, embrulho ou uma superfície áspera, use um nível de correção de erros mais alto — o H tolera visivelmente mais dano que o L — e evite enrolar um código tão apertado em volta de um cilindro que os módulos de uma das bordas se distorçam em elipse.

7. O reflexo está escondendo o desenho da câmera

Laminação brilhante e adesivos brilhantes criam uma mancha refletida forte que o foco automático do celular tem dificuldade de atravessar, especialmente ao ar livre ou sob luz de teto. Isso é um problema de acabamento, não de código: papel fosco, ou inclinar a superfície para longe da luz direta na hora de escanear, costuma resolver sem mexer no código em si.

8. O código decodifica bem, mas o link está morto

Às vezes o escaneamento funciona perfeitamente e o celular ainda assim não mostra nada de útil, porque o destino mudou de lugar, expirou ou nunca esteve no ar. Isso é fácil de confundir com uma falha de leitura, porque o sintoma — “não aconteceu nada” — parece idêntico do lado do usuário. É também a única falha da qual um código estático nunca se recupera: uma vez impresso, o destino dele está fixo para sempre. Se o alvo de um código pode mudar algum dia, decida isso antes de imprimir — veja o nosso artigo sobre códigos estáticos versus dinâmicos.

Checando de forma sistemática

A maioria das falhas reais se resume a tamanho, contraste ou zona de silêncio, porque são as mais fáceis de errar sem perceber em uma tela onde tudo parece bem à primeira vista. Antes de reimprimir qualquer coisa, veja o arquivo no tamanho real de impressão em vez de ampliado em um monitor, e deixe o validador embutido do QRCodeEngine decodificar o código renderizado em vários tamanhos e níveis de contraste antes de você fechar a impressão — ele existe justamente para pegar essas oito causas antes que um cliente pegue.