QR codes de Wi-Fi e de contato: o formato exato do texto e o escape de caracteres

Um QR code de Wi-Fi é texto simples com uma estrutura fixa. Geramos códigos com o codificador do Apps24 para uma rede Wi-Fi, uma rede oculta, um nome e uma senha com caracteres especiais e um cartão de contato, e depois decodificamos cada imagem com o ZXing-C++ 3.1.1.

Entrada e resultado

WIFI:T:WPA;S:Cafe Guest;P:sunny-2026;;3829 × 29
WIFI:T:WPA;S:Office;P:sunny-2026;H:true;;4129 × 29
WIFI:T:WPA;S:Cafe\;Guest;P:pa\:ss\\word;;4129 × 29
BEGIN:VCARD … END:VCARD10041 × 41

Interpretar o resultado

Cada amostra foi decodificada exatamente como o texto digitado, incluindo WIFI:T:WPA;S:Cafe\;Guest;P:pa\:ss\\word;;, em que cada um dos caracteres \ ; , : e " dentro do nome ou da senha vem precedido de uma barra invertida. Um texto de Wi-Fi com 38 caracteres gerou um código de 29 × 29 módulos, e um texto de 100 caracteres, 41 × 41. O gerador aceitou até 2331 caracteres ASCII ou 777 sílabas coreanas.

Próximo passo

1. Escreva o texto como WIFI:T:WPA;S:nome;P:senha;; (T:nopass para redes abertas, H:true para redes ocultas). 2. Escape os caracteres especiais com uma barra invertida. 3. Baixe o PNG e escaneie com o celular que será usado. 4. Mantenha o texto curto para que os módulos continuem grandes na impressão.

Usar a ferramenta

Limites e condições de teste

A decodificação foi feita apenas por software, em imagens digitais. Não escaneamos códigos impressos nem testamos modelos específicos de celular, e o que o celular faz depois de ler um código depende do aplicativo de câmera. As senhas de exemplo não pertencem a redes reais.

qr-format-results.json

Referências

O Apps24 compara os exemplos com a implementação e testes de regressão. Experimentos no navegador indicam suas condições, sem certificar todos os dispositivos. Relate erros com URL, entrada, resultado esperado e navegador. Não envie senhas, documentos privados ou dados pessoais.