Crie um QR code de Wi-Fi, contacto ou link e confira antes de imprimir

Estático, o que é uma decisão, não uma limitação

Existem dois tipos de QR code, e a diferença não é apenas cosmética. Um código estático contém a própria coisa: a URL, o registo Wi-Fi, o cartão de contacto. Um código dinâmico contém um link curto pertencente a um fornecedor, que redireciona para onde quer que o fornecedor determine naquele momento.

Os códigos dinâmicos oferecem dois recursos — o destino pode ser alterado depois da impressão e cada scan pode ser contado — e cobram algo que raramente é explicado na página que os vende. Cada scan passa agora por um terceiro, que o vê e decide se o código continuará a funcionar. Quando esse fornecedor muda os preços, encerra um produto ou deixa de operar, o autocolante na janela para de funcionar e não há nada a fazer a respeito. Isso já aconteceu repetidamente e em grande escala.

Um código gerado aqui está concluído no momento em que você o baixa. Não há redirecionamento, contador, conta ou relação: appvau.lt não participa de um único scan. O que ainda pode deixar de funcionar é aquilo para que o código aponta — um link pode retornar 404, uma senha pode ser alterada, um número de telefone pode ser reatribuído — e nenhum gerador, de nenhum dos dois tipos, pode ajudar com isso.

Por que o conteúdo é mostrado antes de qualquer codificação

Um símbolo QR é opaco para quem o criou. Você não pode olhar para o padrão e perceber que falta o esquema na URL, que foi copiado um espaço no final do SSID a partir de uma etiqueta ou que falta o código do país no número de telefone. A falha é sempre descoberta mais tarde, por alguém segurando um telefone diante de algo que já foi impresso.

Por isso, esta ferramenta mostra primeiro a string canónica exata — aquela que entra no símbolo, no formato interpretado por um scanner. Um registo Wi-Fi para uma rede de convidados tem este aspeto:

WIFI:T:WPA;S:Studio Guest;P:weeknight-parcel-7;;

Esse formato não é uma convenção inventada por este site; é o registo que o iOS lê desde a versão 11 e o Android desde a 10. Vê-lo é o único momento em que uma pessoa pode identificar um erro, por isso é uma etapa, não um detalhe escondido atrás de uma opção avançada.

É também nessa etapa que os avisos aparecem. Um registo Wi-Fi sempre gera um aviso, porque a senha está dentro do símbolo em texto simples e uma fotografia do código tirada do outro lado de uma sala permite recuperá-la. Um número de telefone sem código do país gera um aviso. Um endereço sem esquema gera um aviso e é corrigido diante de você, em vez de silenciosamente.

A verificação e o que ela prova, e não prova

Depois da codificação, a ferramenta renderiza o PNG, rasteriza o SVG e lê os dois novamente com um decoder que não sabe nada sobre o encoder que os produziu. Ele localiza o símbolo como uma câmara faria — convertendo para preto e branco por limiarização, encontrando a tinta, medindo o passo dos módulos a partir do padrão finder — lê as informações de formato, desfaz a máscara, desentrelaça os blocos de dados e recalcula os codewords de correção de erros Reed-Solomon a partir dos dados recuperados, exigindo que sejam idênticos byte a byte aos que estão no símbolo.

Essa última etapa é mais forte do que “foi decodificado”. Ela diz que a redundância está correta, além dos dados, para que um leitor que trabalhe a partir de uma cópia desgastada ou parcialmente coberta ainda tenha a margem prometida pelo nível escolhido. Só quando os dois ficheiros passam é que qualquer download é liberado.

Isso prova que os ficheiros estão corretos. Não prova que a sua câmara, no tamanho da sua impressão, sobre a sua superfície e sob a sua iluminação, os lerá. Nada deste lado pode estabelecer isso, e a instrução honesta é a antiga: imprima no tamanho real e faça o scan com o telefone para o qual ele se destina, antes de encomendar quinhentas unidades.

A verificação tem uma razão para existir que vale a pena mencionar. A criação desta ferramenta revelou um erro na tabela de blocos de correção de erros para o nível H, que teria produzido símbolos estruturalmente válidos e completamente indecodificáveis na configuração de maior redundância. Nada na imagem pareceria errado. O decoder encontrou o erro na primeira execução de teste.

Correção de erros não é uma licença para cobrir o centro

Cada símbolo QR contém codewords redundantes para que um leitor ainda possa recuperar os dados mesmo com danos. Os quatro níveis recuperam aproximadamente ~7% em L, ~15% em M, ~25% em Q, ~30% em H.

Essas percentagens explicam por que designers colocam logótipos no centro dos códigos, e esse é um mau hábito disfarçado de recurso. A redundância existe para resistir a danos que acontecem depois da impressão — desgaste, uma dobra, uma mancha de café, pouca luz. Gastá-la antecipadamente em decoração significa que o código começa sem margem, e são justamente os códigos manuseados que mais precisam de margem.

Um nível mais alto também torna o símbolo mais denso para o mesmo conteúdo, porque a redundância precisa caber em algum lugar. Um símbolo de versão 1 comporta 17 bytes no nível L e 7 no nível H — a mesma grelha de 21 por 21, com menos de metade do conteúdo. Mais densidade significa uma impressão física maior para continuar legível, portanto “use H por segurança” frequentemente produz um código que é mais difícil de ler.

O nível M é o padrão adequado. Use Q ou H quando o código for impresso pequeno, numa superfície curva ou num local onde será tocado.

A tabela completa é publicada como JSON em qr.json, para cada versão de 1 a 40, juntamente com as capacidades numéricas e alfanuméricas e os formatos de conteúdo com exemplos completos. Ela é gerada, em vez de digitada, por uma razão que vale repetir: escrever a estrutura dos blocos uma segunda vez é precisamente como um número errado consegue permanecer.

PNG ou SVG, e por que o passo dos pixels importa

Os dois são produzidos, os dois são gratuitos e nenhum contém marca-d'água. Escolha o SVG para qualquer coisa que vá para impressão ou para um ficheiro de design: ele é vectorial, com uma view box inteira e um único path, portanto escala de um cartão de visita a um cartaz sem desfocar e abre corretamente no Illustrator, Figma, Inkscape e em software de paginação. Escolha o PNG para um documento, slide, mensagem ou página web, onde um raster fixo é mais simples de posicionar.

O tamanho do PNG é arredondado para baixo para que cada módulo seja um número inteiro de pixels. Isto parece preciosismo, mas não é: um símbolo de 29 módulos renderizado exatamente em 500 pixels dá 17.24 pixels por módulo, e esse quarto de pixel aparece como uma borda cinzenta ao longo de cada limite de módulo. As câmaras conseguem lidar com isso na maior parte do tempo, o que é pior do que nunca conseguirem, porque falha na única impressão que importava.

A zona de silêncio de quatro módulos à volta do símbolo faz parte do símbolo, não é uma margem. É uma exigência da ISO/IEC 18004 e a razão mais comum para um código recortado manualmente não ser lido. Não a corte, não coloque o código encostado a um bloco colorido e não deixe uma ferramenta de paginação recortá-lo até aos limites da tinta.

Codificação, conjuntos de caracteres e a questão do ECI

O encoder escolhe o modo mais compacto permitido pelo conteúdo: numérico para dígitos, alfanumérico para o conjunto restrito de maiúsculas e modo byte para todo o resto. Uma tabela de capacidade do símbolo escolhido, em cada nível, é mostrada antes da geração.

Quando o conteúdo contém caracteres não ASCII — um nome de rede acentuado, um nome em cirílico ou japonês — o encoder escreve um cabeçalho ECI que declara UTF-8. Essa é a declaração correta, mas também é o elemento que os scanners antigos têm maior probabilidade de tratar incorretamente, por isso ela só é adicionada quando os bytes realmente precisam dela, e o recibo informa quando isso acontece. Um conteúdo apenas ASCII não contém cabeçalho ECI e comporta-se de forma idêntica em todos os leitores já criados.

Nada nesta página chega à rede. O encoder, o renderer e o decoder que confere o resultado são todos JavaScript executados nesta aba, e os módulos em /js/tools/ não contêm nenhum código que faça requisições. Desligue a rede depois de carregar a página e todas as partes continuarão a funcionar — o que, para uma ferramenta à qual você está prestes a entregar a senha do Wi-Fi, é a propriedade que vale conferir em vez de apenas acreditar.