5 min de leituraTutoriais

QR Code Não Lê? Quatro Causas e Como Resolver

Um QR code que não lê quase sempre falha por causa do tamanho, da zona silenciosa, do contraste ou de um payload longo demais. Teste nessa ordem e corrija o motivo certo.

Marius Voß
DevRel · edge infra
Por que um QR code não lê: as quatro causas físicas de uma leitura falhada, do tamanho e da zona silenciosa ao contraste e a um payload longo demais

Um QR code que não lê quase nunca é um problema do leitor. É uma de quatro causas físicas: o código foi impresso pequeno demais para a distância de onde as pessoas o leem, a margem branca ao redor foi cortada, o contraste está baixo demais, ou a URL dentro dele é longa o suficiente para deixar a grade fina demais para ser resolvida.

Essas quatro respondem por quase todas as falhas, e vale a pena testá-las nessa ordem porque as duas primeiras são as mais comuns e as mais baratas de corrigir. Este é o complemento voltado à impressão de como criar um QR code; se o seu problema é que as leituras não estão sendo contabilizadas, e não que o código não lê, como monitorar leituras de QR code é o texto certo.

Quatro motivos para um QR code não ler, com a causa e a correção de cada um: impresso abaixo do tamanho de leitura, zona silenciosa cortada, reflexo na laminação e contraste baixo ou invertido

Causa Um: Está Impresso Pequeno Demais

A regra prática é a distância dividida por dez. Um código lido a dois metros precisa ter cerca de 20 cm de largura. Um código em um totem de mesa lido a 40 cm pode ter 4 cm. Um código em um outdoor é um exercício completamente diferente, porque a distância legível é definida por quão perto a câmera de um celular consegue focar e ainda resolver os módulos individuais.

Designers encolhem os códigos porque eles parecem uma mancha no layout. A taxa de leitura despenca abaixo de cerca de 2 cm em celulares mais antigos, e as pessoas com celulares mais antigos são exatamente as menos propensas a tentar uma segunda vez.

Que tamanho deve ter um QR code traz a tabela completa de tamanhos, incluindo os casos difíceis, como embalagens curvas e pintura de veículos.

Causa Dois: A Zona Silenciosa Foi Cortada

A margem em branco ao redor de um código faz parte do código. Os leitores usam essa margem para descobrir onde a grade começa, então removê-la pode impedir que um código tecnicamente perfeito seja encontrado.

Quatro módulos é o mínimo especificado, o que em um código impresso típico equivale a uma borda com aproximadamente a largura de um dos quadrados de canto. Os programas de design deixam você cortar essa margem, encostar o código em um bloco colorido ou levar o texto até a borda sem qualquer aviso, e todos esses casos são o mesmo defeito.

Vale a pena checar isso primeiro quando um código lê na tela, mas falha na impressão, porque a versão na tela costuma ter a página branca do navegador funcionando como uma zona silenciosa acidental.

Causa Três: Contraste e Reflexo

Os leitores precisam distinguir módulos escuros de um campo claro. Três coisas quebram isso.

O contraste baixo é o mais óbvio: um código cinza médio sobre um fundo cinza claro parece elegante e lê mal. Códigos invertidos, com módulos claros sobre um campo escuro, são decodificáveis por muitos leitores, mas não por todos, então um design invertido precisa ser testado em vários celulares reais, não em apenas um.

O reflexo é o traiçoeiro. Uma laminação brilhante ou um código impresso atrás de vidro joga as luzes do teto da loja direto de volta para a câmera, e o código que lia perfeitamente na prova falha na prateleira. Um acabamento fosco, ou afastar o código do reflexo, resolve.

Um QR code que falha no campo comparado com um que lê do outro lado da sala, contrastando comprimento do payload, zona silenciosa, contraste e tamanho de impressão

Causa Quatro: O Payload É Longo Demais

Essa é a causa que ninguém desconfia, porque o código parece perfeito na tela.

A quantidade de dados decide a versão do código, e a versão decide quantos módulos ele contém. A Denso Wave, que inventou o formato, publica a tabela de versões e capacidade. Um link curto de 30 caracteres produz uma grade esparsa com módulos grandes. Uma URL de 180 caracteres com cinco parâmetros UTM produz uma grade densa, e no mesmo tamanho de impressão esses módulos ficam fisicamente menores e mais difíceis de resolver.

Então a correção mais barata disponível acontece antes da impressão: codifique um link curto em vez do destino completo com parâmetros. As tags de campanha ficam no destino, o código permanece esparso, e você ganha dados de clique de bônus. Geração de QR code em massa mostra como fazer isso em todo um catálogo de produtos.

A correção de erros empurra na direção oposta. O nível H parece mais seguro e adiciona redundância que torna o código mais denso, então é o padrão errado: o nível M recupera cerca de 15% de dano e mantém a grade legível. Suba de nível apenas quando um logotipo cobrir o centro.

Quer testar a teoria rapidamente? Crie um link curto no plano gratuito, codifique-o em vez da URL longa, e imprima os dois no mesmo tamanho para comparar.

Testando Direito Antes da Tiragem

Testes na tela não provam quase nada. As falhas acima são todas físicas.

Imprima o código no tamanho final, coloque-o onde ele realmente vai ficar, e leia-o de onde uma pessoa realmente vai estar. Faça isso em pelo menos dois celulares, um deles não tão novo, e uma vez sob a iluminação em que o código vai viver. Dez minutos disso pegam todas as causas desta página.

Para uma tiragem de milhares, amostre cinco. Os códigos são gerados em um loop, então um defeito quase nunca está em um único código; ele está no modelo, e cinco amostras vão encontrá-lo enquanto a correção ainda é gratuita.

Às vezes a leitura funciona e nada acontece, ou o celular abre uma página com erro. Isso já não é um problema de QR: o código foi decodificado corretamente e entregou uma URL para o navegador.

Se o destino retorna 404, o certificado não é válido, ou o link abre em um aplicativo e não em outro, as causas são completamente diferentes, e link curto não funciona percorre elas. Vale a pena saber de que lado dessa linha você está antes de reimprimir qualquer coisa, porque uma reimpressão não resolve nada quando o link por trás do código é a parte quebrada.

Esse é o argumento mais forte para um código dinâmico em qualquer coisa impressa: quando o destino acaba estando errado, você reaponta o link em vez de destruir a tiragem inteira.

Leia a Série Principal

Este texto está no cluster de tutoriais. Comece com como criar um QR code para o básico, depois que tamanho deve ter um QR code para o dimensionamento e design de QR code com marca para manter um código legível enquanto ele carrega um logotipo.

Relacionados no Blog

Perguntas frequentes

Por que meu QR code não lê?

Quase sempre é uma destas quatro coisas: está impresso menor do que a distância de leitura permite, a margem branca ao redor foi cortada, o contraste entre o código e o fundo está baixo demais, ou a URL dentro dele é longa o suficiente para deixar a grade densa demais para a câmera. Teste nessa ordem.

Que tamanho um QR code precisa ter para ser lido?

Divida a distância de leitura por dez. Alguém a dois metros de um pôster precisa de um código com cerca de 20 cm de largura; um código em um cartão de visita lido a 30 cm pode ter 3 cm. Qualquer coisa abaixo de cerca de 2 cm é pouco confiável em câmeras de celulares mais antigos, não importa quão boa seja a impressão.

O que é a zona silenciosa e por que cortá-la quebra a leitura?

A zona silenciosa é a margem em branco ao redor do código, e ela faz parte da especificação, não é decoração. Os leitores usam essa margem para encontrar onde o código começa e termina, então um design que corta a borda para economizar espaço pode impedir que um código tecnicamente perfeito seja reconhecido. Quatro módulos é o mínimo.

Um QR code pode ser claro sobre um fundo escuro?

Pode, mas muitos leitores esperam módulos escuros sobre um campo claro e falham em um código invertido. Se o design precisa de uma aparência invertida, teste em vários celulares antes de imprimir e mantenha o contraste alto. Uma foto atrás do código é a versão que falha de forma quase garantida.

Uma URL mais longa torna um QR code mais difícil de ler?

Sim. Mais caracteres significam uma versão mais alta do código, o que significa mais módulos e menores no mesmo tamanho de impressão. Codificar um link curto em vez de uma URL longa com parâmetros é a correção mais barata de todas, porque reduz a contagem de módulos antes mesmo de qualquer coisa ser impressa.

Meu QR code lê no meu celular, mas não no do meu cliente. E agora?

Isso aponta para contraste, reflexo ou tamanho, e não para o código em si, porque os dados são decodificáveis ou não são. Teste em um celular mais antigo, na iluminação real e na distância real. Uma laminação brilhante sob as luzes da loja é uma causa comum que nunca aparece em cima de uma mesa.

Experimente Elido

Cole uma URL, obtenha um link curto

Sem cadastro. O link vive 30 dias. Cadastre-se para mantê-lo para sempre.

Grátis, sem necessidade de registo · 2 por dia

Experimente o Elido

Encurtador de URL hospedado na UE: domínios personalizados, análises profundas e API aberta. Plano gratuito - sem cartão de crédito.

Tags
qr code not scanning
qr code won't scan
qr code too small
qr code quiet zone
fix qr code
qr code contrast

Continuar lendo