Por que um QR code não lê, e como saber qual defeito você tem

Por que meu QR code não lê?

Um QR code falha em uma de três etapas: o scanner nunca encontra o símbolo, o scanner encontra mas não consegue ler os módulos com limpeza, ou o scanner lê perfeitamente e aquilo para onde o código aponta está quebrado. Defeitos de detecção, de decodificação e de destino aparecem diferentes por fora e não têm nenhuma solução em comum.

A detecção é a etapa em que um scanner localiza um QR code na imagem da câmera e deduz o contorno, a rotação e a grade de módulos, antes de ler qualquer dado. A decodificação é a etapa em que um scanner lê os módulos dentro de um QR code já localizado e reconstrói os dados que eles codificam. A ordem importa mais que as definições: tudo que o decodificador sabe fazer, ele só faz num símbolo que a detecção já encontrou.

É essa ordem que transforma o sintoma em diagnóstico. Uma falha de detecção é absoluta - o celular não mostra nada, toda vez, de qualquer distância - porque, para ele, não existe código nenhum no enquadramento. Uma falha de decodificação é condicional - o código lê mais perto, ou com luz melhor, ou num celular e no outro não - porque o decodificador está trabalhando com uma imagem no limite e às vezes ganha. Uma falha de destino parece um sucesso seguido de decepção: a notificação aparece, o link abre, e a página atrás dele está morta.

A consequência prática é que a maior parte dos conselhos sobre QR code que não lê mira na etapa errada. Subir o nível de correção de erros, colocar uma borda, gerar de novo em resolução maior: cada uma dessas é a solução certa para exatamente um defeito e uma tiragem jogada fora para os outros dois.

Comece pelo que o celular faz, não pelo código

Aponte um celular para o código e veja o que acontece, em duas distâncias, com dois celulares. A resposta dessa observação reduz o defeito a uma única categoria antes de qualquer medição, e custa uns trinta segundos.

A linha que vale internalizar é a primeira. Silêncio total e repetível não é uma leitura fraca: é a ausência de leitura, e aponta para os três ou quatro centímetros quadrados em volta do símbolo, não para nada que esteja dentro dele.

Não acontece nada: o código nunca é detectado

Um código que não produz reação nenhuma, em nenhuma distância e em mais de um celular, falhou na detecção e não na decodificação, e existem cinco causas comuns. Os dados dentro do símbolo quase sempre estão perfeitos; o que ainda não foi decidido é que ali existe um símbolo para ler.

• A zona de silêncio sumiu. Um QR code precisa de quatro módulos livres em cada lado, e é essa margem que torna a borda do símbolo localizável. Um fio, uma legenda, uma foto sangrando por baixo do código ou uma linha de corte dentro desse anel quebram a detecção com todos os módulos intactos. É, de longe, a causa mais comum de silêncio total.
• Um padrão de localização está coberto, cortado ou danificado. Os três quadrados concêntricos dos cantos não têm correção de erros nenhuma. Um adesivo sobre um canto, uma faca de corte que o corta, ou um logo arrastado para fora do centro em cima dele significam que o código não é encontrado de jeito nenhum.
• O código é de módulos claros sobre fundo escuro. Códigos invertidos são permitidos pela norma e pouco confiáveis na prática: vários apps de câmera nativos nem tentam, então o mesmo arquivo lê num app dedicado e não faz nada no app que as pessoas realmente usam.
• O símbolo não é um QR code modelo 2. Data Matrix, Aztec, PDF417 e Micro QR parecem QR codes para quem não é especialista e não são lidos pelo caminho de QR da câmera do celular. Costumam vir da biblioteca de artes de um fornecedor - QR code vs código de barras explica para que serve cada símbolo.
• A superfície não é plana, ou não está parada. Um código enrolado numa garrafa, vincado sobre uma dobra ou atrás de vidro curvo distorce a grade de módulos além do que os padrões de alinhamento conseguem corrigir. O mesmo vale para um celular que nunca consegue focar, que é o que acontece quando um código pequeno é aproximado além da distância mínima de foco da câmera.

O jeito mais rápido de separar arte de diagramação: passe o arquivo exportado por um decodificador no computador. Se o scanner de QR code lê o arquivo e nenhum celular lê a peça impressa, o defeito entrou em algum ponto entre o arquivo e o objeto pronto - um layout, um ajuste de exportação ou a gráfica. Se nem o arquivo decodifica, pare de olhar para a impressão.

A zona de silêncio trata dessa margem de ponta a ponta: quantos milímetros são quatro módulos no seu tamanho impresso, os hábitos de diagramação que apagam essa margem, e como medir o que um arquivo que te mandaram realmente traz.

Lê de perto mas não de onde as pessoas ficam

Um código que lê a 20 cm e falha a 2 m está dimensionado para a distância errada, e nada mais. Conte cerca de 1 cm de largura de código para cada 10 cm de distância de leitura, com um piso de 2 cm na área total - então um código lido a 3 m precisa de uns 30 cm, e um código lido a 40 cm continua precisando dos seus 2 cm.

A regra da distância é um atalho para o que de fato importa, que é a largura de um módulo dentro do enquadramento da câmera. Um celular precisa resolver um único módulo antes de ler qualquer coisa, então a conta que decide o resultado é a largura impressa dividida pelo número de módulos, e esse número sobe com o tamanho da URL. Dois códigos impressos nos mesmos 3 cm podem se comportar de forma completamente diferente se um carrega um link de 30 caracteres e o outro de 200.

Sintomas que confirmam um defeito de tamanho e não outra coisa:

• Lê com confiabilidade de perto. Não tem nada errado na arte; o código simplesmente não é grande o bastante para ser resolvido de mais longe.
• A distância de leitura melhora com luz forte. Mais luz significa exposição mais curta e menos tremido, o que recupera parte da largura de módulo que falta.
• Um link mais longo derrubou um código que funcionava. Mesmo tamanho impresso, símbolo mais denso, módulos menores. Encurte o destino e reimprima.
• Falha na peça pequena e funciona no cartaz. O mesmo arquivo em dois tamanhos é a prova mais limpa que existe.

Confira a largura de módulo antes de aumentar no chute. Módulos impressos devem ter 0,4 mm ou mais em papel couché e 0,5 mm ou mais em offset, e a calculadora de tamanho de impressão faz essa conta a partir da largura e da distância de leitura. Tamanho mínimo para impressão tem as tabelas por mídia e explica por que o piso está onde está.

Lê na tela mas não na peça impressa

Um código que funciona no monitor e falha no papel geralmente perdeu largura de módulo, contraste ou nitidez de borda no caminho entre os dois, e a tela esconde as três coisas. Um display dá ao decodificador iluminação uniforme, uma taxa de contraste alta e bordas de pixel duras; o papel dá ganho de ponto, luz ambiente e uma borda mole em cada módulo.

O que conferir, na ordem em que costuma estar errado:

• A largura de módulo em milímetros. Divida a largura impressa pelo número de módulos incluindo a zona de silêncio. Abaixo de 0,4 mm em couché ou 0,5 mm em offset, o código é pequeno demais por mais limpo que o arquivo esteja.
• O formato do arquivo. JPEG e WebP têm perdas: deixam franjas cinzas em cada borda de módulo, que é exatamente onde o decodificador precisa de um limite duro. Um print de tela de um código é o mesmo problema com reamostragem por cima. Mande vetor sempre que o destino aceitar - SVG vs PNG vs PDF vs EPS explica qual arquivo vai para onde.
• A resolução efetiva. Um código raster precisa de um número inteiro de pixels por módulo no tamanho final, senão cada borda de módulo cai no meio de um pixel e a suavização a transforma num cinza mole. Resolução e DPI tem a fórmula nos dois sentidos, e a calculadora de DPI executa ela.
• A zona de silêncio no layout montado. A margem quase nunca se perde na exportação; ela se perde depois, quando o código encontra uma página que precisava daquele espaço.
• Ganho de ponto em papel absorvente. Offset, kraft e papel jornal deixam os módulos escuros crescerem por cima dos claros. O símbolo escurece no conjunto e os módulos claros estreitam, e é por isso que o piso de 0,5 mm em offset é mais alto que o do couché.

O validador de QR code mede as três coisas que dá para ler de um arquivo - a margem para fora a partir de cada borda, o contraste entre as duas cores, e o tamanho de módulo numa largura impressa informada - e reporta o pior lado em vez de uma média. Passe a exportação por ele antes de o arquivo ir para a gráfica, e depois tire uma prova no papel de verdade.

Lê num celular e no outro não

Um código que lê num celular e não em outro está bem no limite em vez de quebrado, e esse limite quase sempre é largura de módulo, contraste ou esquema de cores. Nem a Apple nem o Google publicam um limiar de leitura para seus apps de câmera, então a leitura honesta de um resultado dividido é que o código está no limite - não que um celular está com defeito.

A solução para um resultado dividido não é testar mais celulares. É tirar o código do limite em que ele está: some 25% à largura impressa, afaste mais o par de cores, ou desinverta um código invertido. Um código que lê em todo celular do escritório é um código com folga, e folga é a única coisa que sobrevive a uma tiragem, a um corredor mal iluminado e a uma película de tela rachada.

Funcionava no estúdio e falha onde está instalado

Um código que lê na mesa e falha na parede encontrou a luz, e a luz não é culpa da arte. Os dois mecanismos são o reflexo, em que um brilho especular apaga parte do símbolo, e a pouca luz ambiente, em que a câmera alonga a exposição e o tremido come as bordas dos módulos.

O que conferir no local em vez de no arquivo:

• Uma luminária ou janela bem de frente para o código. Laminação brilhante devolve isso direto para a lente. Fique onde quem lê fica e procure a mancha clara no símbolo: se você enxerga, a câmera enxerga mais.
• Se quem lê consegue inclinar o código. Um display de mesa dá para virar na mão e sair do brilho; uma placa de parede não. Essa única pergunta decide o acabamento mais do que o papel - fosco vs brilhante trata disso de ponta a ponta.
• O contraste de cor sob a luz real. Luz quente e baixa achata um código cujas cores foram escolhidas num monitor calibrado. Os números de trabalho são 4:1 na tela e 7:1 na impressão, e o verificador de contraste dá a taxa de um par de cores antes de imprimir qualquer coisa.
• Altura e alcance. Um código montado acima da linha dos olhos é lido em ângulo por todo mundo mais baixo que quem instalou, e uma leitura em ângulo precisa de mais tamanho e mais contraste que uma de frente.
• Atrás de vidro. Uma moldura, uma janela ou uma vitrine somam duas superfícies refletivas, e o código tem que funcionar através das duas.

O contraste é o eixo que mais se julga errado, porque o piso do próprio decodificador está muito abaixo de qualquer diretriz de design: o decodificador de código aberto que dá para ler desiste perto de 1,24:1, um cinza quase invisível sobre branco. Isso não é licença para projetar por ali. Onde iPhone e Android desistem mostra de onde vem esse número e por que o papel, a luz e a lente gastam o resto da folga.

Lê na hora e depois não acontece nada de útil

Se o celular detecta o código e mostra uma notificação, o QR code cumpriu todo o trabalho dele e o defeito está atrás. Nenhuma mudança no símbolo, no tamanho, nas cores ou no nível de correção de erros resolve um problema de destino, e essa é a categoria que a maior parte dos conselhos de diagnóstico ignora completamente.

O que dá errado de verdade atrás de um código que funciona:

• A URL está morta ou foi digitada errado na geração. Um código codifica uma string, não uma promessa. Leia a string decodificada caractere por caractere contra o endereço que você queria, principalmente qualquer parte digitada na mão.
• Falta o esquema no link. Uma string como koloqr.com/menu sem https:// na frente é texto para alguns scanners e link para outros, então abre num celular e mostra uma string para copiar no próximo.
• O destino redireciona para algo que falha no celular. Um link curto para uma página só de desktop, um PDF que abre num leitor que ninguém tem, ou uma cadeia de redirecionamentos que estoura o tempo numa conexão lenta.
• A página exige login, ou está restrita por região. A leitura funciona perfeitamente e quem leu bate numa parede - e vai te relatar isso como "o QR code não funciona".
• Um código de Wi-Fi com o tipo de segurança errado ou uma senha sem escape. Uma rede WPA2 cujo conteúdo declara que não tem senha, um SSID oculto sem a marcação de oculto, ou uma senha com ponto e vírgula ou barra invertida que nunca recebeu escape. Veja QR codes de Wi-Fi para o formato do conteúdo.
• Um número de telefone com formatação dentro. Espaços, parênteses e traços dentro de um conteúdo tel: são tratados de forma inconsistente. O que viaja são os dígitos e um sinal de mais na frente - QR codes de número de telefone têm o formato.
• Um código dinâmico cujo redirecionamento venceu. Um código vendido por assinatura para de resolver quando a assinatura acaba, e a peça impressa não tem como avisar.

A conferência que separa essa categoria de todas as outras leva um minuto: decodifique o arquivo, copie a string e cole num navegador do celular. Se a string está certa e a página está quebrada, a impressão está boa e a reimpressão não teria mudado nada.

Funcionou por meses e depois parou

Um código que parou de funcionar sem ninguém encostar na peça impressa ou perdeu o destino ou perdeu o contraste, e esses são os dois únicos candidatos que valem primeiro. O símbolo em si não muda; o que muda é aquilo para onde ele aponta, ou a tinta com que foi impresso.

Um código estático codifica o destino de forma permanente, e é por isso que a resposta duradoura é uma URL que você controla e pode redirecionar. O que uma assinatura de QR code dinâmico realmente compra mostra essa troca inteira, incluindo o que acontece com a tiragem impressa quando o pagamento para.

Parou de ler depois que alguém mexeu na arte

A maioria dos códigos que quebram durante o design quebra de uma entre seis maneiras, e todas as seis se resolvem gerando o código de novo em vez de consertar o arquivo. A pista é que entrou uma exportação que funcionava numa ferramenta de design e saiu uma quebrada.

• O logo cresceu. Um logo central cobrindo até uns 20% da área do símbolo é recuperado com confiabilidade no nível H, e o teto teórico de 30% não é capacidade sobrando: ganho de ponto, reflexo e uma digital saem do mesmo orçamento. Níveis de correção de erros tem a geometria.
• O logo saiu do centro. Dano centralizado se espalha de forma equilibrada pelos blocos de recuperação intercalados; o mesmo logo fora do centro concentra o dano, e perto de um canto ele cai sobre um padrão de localização, que nível nenhum protege.
• O código foi esticado. Qualquer escala não uniforme deixa os módulos retangulares e a grade inconsistente. Trave as proporções antes de redimensionar qualquer coisa.
• As cores foram trocadas pelas cores da marca. Duas cores de marca de tom médio podem parecer bem contrastadas e carregar quase nenhuma diferença de luminância. Confira o par em vez de confiar nas amostras.
• Desenharam uma moldura ou legenda colada no símbolo. Uma moldura está ok se a borda interna dela ficar a pelo menos quatro módulos. Desenhada no símbolo, ela fica dentro da zona de silêncio.
• Foi exportado como print de tela ou JPEG. Reamostragem e compressão com perdas amolecem as bordas dos módulos - veja copiar um QR code para o Figma para o caminho de posicionamento e exportação que não faz isso.

Gerar de novo não custa nada, e um código gerado de novo é exato onde um consertado é mais ou menos certo. A KoloQR, um gerador de QR code gratuito com QR codes circulares e de formas personalizadas, exporta SVG, PNG, PDF e EPS com a zona de silêncio incluída e o nível de correção de erros definido antes da exportação. Estilo nunca melhora a leitura: formas decorativas de módulo colocam menos tinta em cada célula que as quadradas, então um código estilizado gasta tolerância em vez de criar, e formas personalizadas de QR realmente leem? tem as medições por trás disso.

Como diagnosticar um QR code que não lê

Trabalhe da arte para fora em vez do celular para dentro, porque o arquivo é a única parte da cadeia que você consegue medir com exatidão. O procedimento abaixo dá nome ao defeito em uns dez minutos e funciona numa peça impressa que você não desenhou, sem arquivo original e sem anotações.

1. Veja o que dois celulares fazem, em duas distâncias. Nada nos dois significa detecção. Ler às vezes significa decodificação. Ler na hora significa que o código está bem e o destino não.
2. Decodifique o arquivo no computador. Solte a exportação num decodificador que lê a partir de uma imagem. Se o arquivo decodifica e a impressão não, o defeito entrou depois da exportação.
3. Leia a string decodificada caractere por caractere. Compare com o endereço que você queria codificar e depois abra num navegador de celular. Uma string errada ou morta encerra a investigação aqui.
4. Meça a margem livre no pior lado. Compare o espaço livre com a largura de um módulo no mesmo zoom. Olhe os quatro lados e fique com o menor, no layout montado e não no arquivo.
5. Calcule a largura de módulo em milímetros. Divida a largura impressa pelo número de módulos incluindo a margem. Abaixo de 0,4 mm em couché ou 0,5 mm em offset, o código é pequeno demais.
6. Confira o contraste do par de cores real. Não o das amostras, o do resultado impresso. Abaixo de mais ou menos 7:1 na impressão, o código gasta folga que vai precisar para luz e reflexo.
7. Olhe o código onde ele vive. Fique onde quem lê fica, na altura dessa pessoa, com as luzes da sala acesas. Reflexo e ângulo de leitura são invisíveis em toda conferência de arquivo acima.
8. Mude uma coisa e tire uma prova. Uma folha no tamanho final no papel de produção. Mudar três coisas de uma vez significa que a próxima falha vai ficar tão inexplicada quanto essa.

Se todas as conferências passam e o código continua sem ler, gere ele de novo a partir do destino e compare os dois símbolos lado a lado. Um arquivo que passou por várias ferramentas pode carregar dano que nenhuma medição isolada pega, e uma exportação nova leva menos tempo que mais uma rodada de medir.

Os limiares com que avaliamos um código

A KoloQR avalia um QR code em quatro números, e só um deles vem da norma. Os quatro módulos de zona de silêncio são o número da ISO/IEC 18004; as faixas de contraste, a linha de aviso embaixo da margem e o piso de módulo são nossos, traçados onde um código deixa de ter folga e não onde deixa de funcionar. Os quatro dá para conferir passando um arquivo pelas ferramentas em vez de acreditando na nossa palavra.

Dois deles carregam um julgamento que vale dizer em voz alta. A gente avisa em vez de reprovar com dois ou três módulos de zona de silêncio, porque é isso que a maioria das molduras decorativas deixa e o que a maioria dos decodificadores ainda lê: é um código sem folga, não um código quebrado. E a gente julga o contraste pelo pior entre os módulos escuros e os padrões de localização em vez de por uma média, porque um scanner precisa achar os três quadrados dos cantos antes de ler qualquer coisa, e um código com módulos escuros e padrões de localização claros falha na detecção enquanto a média dele continua parecendo respeitável.

O gerador aplica a mesma regra de contraste ao vivo: o selo ao lado da prévia pega o pior dos dois pares de cores e fica verde em 4:1. Essa é a linha de tela e não a de impressão, e isso é proposital - um código que está sendo desenhado para uma peça impressa deveria estar em 7:1 antes de sair da página, e o verificador de contraste é onde isso se resolve contra uma paleta de marca.

O que não fazer quando um QR code não lê

O erro mais caro no diagnóstico é reimprimir antes de o defeito ter nome. Uma reimpressão muda várias variáveis de uma vez, então um código que funciona depois não te ensina nada, e um código que continua falhando custou a tiragem duas vezes.