8 min de leituraTutoriais

Código QR não lê? Quatro causas e como resolver

Um código QR que não lê quase sempre falha por tamanho, zona de silêncio, contraste ou conteúdo longo demais. Teste nessa ordem e corrija a causa certa.

Marius Voß
DevRel · edge infra

Um código QR que não lê quase nunca é 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 bastante para deixar a grade fina demais para ser resolvida.

Essas quatro respondem por quase todas as falhas, e vale testá-las nessa ordem porque as duas primeiras são as mais comuns e as mais baratas de corrigir. Este texto é o complemento do lado da impressão de como criar um código QR; se o seu problema é que as leituras não estão sendo contadas, e não que o código não lê, o que você quer é como rastrear leituras de código QR.

Quatro motivos para um código QR não ser lido, com a causa e a correção de cada um: impresso abaixo do tamanho de leitura, zona de silêncio cortada, reflexo na plastificação e contraste baixo ou invertido

Diagnóstico rápido: associe o sintoma à causa

O que você vêCausa mais provávelPrimeira correção
Lê na tela, falha no papelZona de silêncio cortadaAdicione uma margem de pelo menos quatro módulos
Lê de perto, falha em uma distância normalImpresso pequeno demaisDivida a distância por dez
Funciona na sua mesa, falha na lojaReflexo ou contraste baixoAcabamento fosco, módulos escuros sobre fundo claro
Demora alguns segundos e depois funcionaGrade densa por causa de URL longaCodifique um link curto
Lê, e depois a página dá erroNão é problema de QRVerifique o destino

Causa um: impresso pequeno demais

A regra prática é 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 display de mesa, lido a 40 cm, pode ter 4 cm. Um código em um outdoor é um exercício totalmente diferente, porque a distância legível é definida por quão perto a câmera do celular consegue focar e ainda resolver os módulos individuais.

Designers diminuem 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 quem tem celular antigo é justamente quem tem menos chance de tentar duas vezes.

Qual o tamanho ideal de um código QR traz a tabela completa de tamanhos, inclusive os casos difíceis como embalagens curvas e adesivos de veículos.

Causa dois: a zona de silêncio foi cortada

A margem em branco ao redor de um código faz parte do código. Os leitores a usam 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 é uma borda de pouco mais da metade da largura de um dos quadrados dos cantos (esses quadrados têm sete módulos de largura). Programas de design deixam você cortá-la, encostar o código em um bloco colorido ou levar texto até a beirada, e cada um desses é o mesmo defeito.

Vale conferir esta primeiro quando um código lê na tela mas falha na impressão, porque na versão em tela a página branca do navegador costuma funcionar como uma zona de silêncio acidental.

Causa três: contraste e reflexo

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

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

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

Causa quatro: o conteúdo é longo demais

Esta é a causa que ninguém suspeita, porque o código parece bom na tela.

A quantidade de dados define a versão do código, e a versão define quantos módulos ele tem. A Denso Wave, que inventou o formato, publica a tabela de versões e capacidades. 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 impresso esses módulos são fisicamente menores e mais difíceis de resolver.

Então a correção mais barata está antes da impressão: codifique um link curto em vez do destino completo com tags. As tags da campanha ficam no destino, o código continua esparso, e você ainda ganha dados de cliques de bônus. Geração de códigos QR em massa mostra como fazer isso em um catálogo inteiro de produtos.

A correção de erros puxa na direção oposta. O nível H parece mais seguro e acrescenta redundância que deixa o código mais denso, então é o padrão errado: o nível M recupera cerca de 15 por cento de dano e mantém a grade legível. O designer do Elido usa M como padrão pelo mesmo motivo, e oferece L, M, Q e H. Suba só quando um logo cobrir o centro; design de códigos QR de marca explica quanto de logo cada nível suporta. O texto níveis de correção de erros explicados mostra a contagem de módulos em cada nível para a mesma URL.

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.

Escolhas de design que estragam leituras em silêncio

O estilo é a quinta causa, e ela se esconde dentro das outras quatro. O designer de QR do Elido permite definir cores de primeiro plano e de fundo, escolher estilos de módulo e de olho (quadrado, arredondado, ponto), adicionar um logo e uma moldura. Cada um deles é seguro enquanto mantém o contraste de escuro sobre claro e os quadrados localizadores reconhecíveis, e cada um pode quebrar a leitura quando exagerado: cores de marca claras reduzem o contraste, pontos muito redondos diminuem a área escura de cada módulo, e um logo grande gasta o orçamento de correção de erros.

Designer de QR do Elido com campos de cor de primeiro plano e de fundo, estilos de módulo Quadrado, Arredondado e Ponto, opções de estilo de olho, um botão de envio de logo e botões de download de PNG e SVG

Ao exportar, o designer oferece PNG ou SVG, nada mais. Para impressão, use o SVG: ele continua nítido em qualquer tamanho, então um código que borra em um pôster na resolução do PNG não é problema do código. O designer não tem exportação em PDF nem EPS, então, se a gráfica pedir um, coloque o SVG na sua ferramenta de layout e exporte de lá.

Se você só precisa de um código simples para descartar o design como causa, a ferramenta gratuita de gerador de QR cria códigos de URL, texto, Wi-Fi, vCard, e-mail e SMS. Gere a mesma URL lá, sem estilo, e compare com a sua versão de marca no mesmo celular. Se o simples ler, o estilo é o culpado. Para a lista completa de limites de estilo, veja design de códigos QR de marca, e para saber como um leitor lê a grade, veja o que é um código QR.

Testar direito antes da tiragem

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

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

Para uma tiragem de milhares, teste cinco amostras. Os códigos são gerados em um loop, então um defeito quase nunca está em um código só; está no modelo, e cinco amostras o encontram 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 é problema de QR. O código decodificou corretamente e entregou uma URL ao navegador.

Se o destino dá 404, o certificado não é válido ou o link abre em um app e em outro não, as causas são totalmente diferentes e link curto não funciona as percorre. Vale saber de que lado da linha você está antes de reimprimir qualquer coisa. Reimprimir não corrige nada quando a parte quebrada é o link.

Esse é o argumento mais forte para um código dinâmico em qualquer coisa impressa: quando o destino se revela errado, você redireciona o link em vez de mandar a tiragem para a reciclagem. Um código dinâmico também lhe dá um conteúdo curto de graça, o que ajuda na própria leitura. Uma ressalva: o Elido conta uma leitura de QR como um clique e não separa os dois em sua análise, então uma queda nos cliques não diz se o código parou de ser lido.

Na minha experiência, a correção quase sempre é a mais barata desta página, então resista a reimprimir antes de rodar a tabela de diagnóstico. Comece por como criar um código QR e depois por qual o tamanho ideal de um código QR para dimensionar.

Relacionados no blog

Perguntas frequentes

Por que meu código QR não lê?

Quase sempre por uma de quatro coisas: ele foi 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 bastante para deixar a grade densa demais para a câmera. Teste nessa ordem.

Qual o tamanho necessário para um código QR 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 a qualidade da impressão.

O que é a zona de silêncio e por que cortá-la impede a leitura?

A zona de silêncio é a margem em branco ao redor do código, e faz parte da especificação, não é enfeite. Os leitores a usam para achar 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 código QR pode ser claro sobre fundo escuro?

Pode, mas muitos leitores esperam módulos escuros sobre fundo claro e falham com um código invertido. Se o design pede um visual invertido, teste em vários celulares antes de imprimir e mantenha a razão de contraste alta. Uma foto atrás do código é a versão que falha de forma confiável.

Uma URL mais longa dificulta a leitura de um código QR?

Sim. Mais caracteres significam uma versão mais alta do código, ou seja, mais módulos e menores no mesmo tamanho impresso. Codificar um link curto em vez de uma URL longa com parâmetros é a correção única mais barata, porque reduz o número de módulos antes de qualquer impressão.

Meu código QR 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 ou são decodificáveis ou não são. Teste em um celular mais antigo, na iluminação real, na distância real. Plastificação brilhante sob luzes de loja é um culpado comum que nunca aparece em uma mesa de escritório.

Experimente Elido

Cole uma URL, obtenha um link curto

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

Sem registo. Crie uma conta grátis e obtenha 50 links por mês.

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