Créez un QR code Wi-Fi, contact ou lien, et vérifiez-le avant impression

Le statique : un choix, pas une limitation

Il existe deux types de QR code, et la distinction n'est pas cosmétique. Un code statique contient la chose elle-même : l'URL, l'enregistrement Wi-Fi, la fiche contact. Un code dynamique contient un lien court appartenant à un prestataire, qui redirige vers l'endroit indiqué par ce prestataire à ce moment-là.

Les codes dynamiques offrent deux fonctions — la destination peut être modifiée après l'impression et chaque scan peut être compté — mais ils vous coûtent quelque chose qui est rarement précisé sur la page qui les vend. Chaque scan passe désormais par un tiers, qui le voit et décide si le code continue de fonctionner. Lorsque ce prestataire modifie ses tarifs, abandonne un produit ou cesse son activité, l'autocollant sur la vitrine cesse de fonctionner et il n'y a rien à faire. Cela s'est produit à plusieurs reprises et à grande échelle.

Un code généré ici est terminé dès que vous le téléchargez. Il n'y a ni redirection, ni compteur, ni compte, ni relation : appvau.lt n'intervient dans aucun scan. Ce qui peut toujours cesser de fonctionner, c'est ce vers quoi le code pointe — un lien peut renvoyer une erreur 404, un mot de passe peut être modifié, un numéro de téléphone peut être réattribué — et aucun générateur, quel que soit le côté de la distinction, ne peut y remédier.

Pourquoi le contenu est affiché avant tout encodage

Un symbole QR est opaque pour la personne qui l'a créé. Vous ne pouvez pas regarder le motif et voir que l'URL ne contient pas son schéma, que le SSID comporte un espace final copié depuis une étiquette ou que le numéro de téléphone n'a pas d'indicatif de pays. L'échec est toujours découvert plus tard, par quelqu'un qui tient un téléphone devant quelque chose déjà imprimé.

Cet outil affiche donc d'abord la chaîne canonique exacte — celle qui entre dans le symbole, dans le format qu'un scanner analyse. Un enregistrement Wi-Fi pour un réseau invité ressemble à ceci :

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

Ce format n'est pas une convention inventée par ce site ; c'est l'enregistrement lu par iOS depuis la version 11 et par Android depuis la version 10. Le voir est le seul moment où un humain peut détecter une erreur, raison pour laquelle il s'agit d'une étape plutôt que d'un détail caché derrière une option avancée.

C'est également à cette étape que les avertissements apparaissent. Un enregistrement Wi-Fi en déclenche un à chaque fois, car le mot de passe se trouve en clair dans le symbole et une photo du code prise depuis l'autre bout d'une pièce suffit à le récupérer. Un numéro de téléphone sans indicatif de pays en déclenche un. Une adresse sans schéma en déclenche un et est corrigée devant vous plutôt que silencieusement.

La vérification, et ce qu'elle prouve ou non

Après l'encodage, l'outil rend le PNG, rastérise le SVG et relit les deux avec un décodeur qui ne sait rien de l'encodeur qui les a produits. Il localise le symbole comme le ferait un appareil photo — seuillage en noir et blanc, détection de l'encre, mesure du pas des modules à partir du motif de repérage — lit les informations de format, annule le masque, désentrelace les blocs de données, puis recalcule les mots de code de correction d'erreurs Reed-Solomon à partir des données récupérées et exige qu'ils soient identiques octet par octet à ceux du symbole.

Cette dernière étape est plus rigoureuse que « il a été décodé ». Elle indique que la redondance est correcte autant que les données, de sorte qu'un lecteur travaillant à partir d'une copie éraflée ou partiellement masquée dispose encore de la marge promise par le niveau choisi. Ce n'est que si les deux fichiers réussissent que l'un ou l'autre téléchargement devient disponible.

Elle prouve que les fichiers sont corrects. Elle ne prouve pas que votre appareil photo, à votre taille d'impression, sur votre surface et dans votre éclairage, les lira. Rien de ce côté-ci ne peut l'établir, et l'instruction honnête reste l'ancienne : imprimez-le à sa taille réelle et scannez-le avec le téléphone auquel il est destiné, avant d'en commander cinq cents.

Cette vérification est justifiée pour une raison qu'il vaut la peine de préciser. La création de cet outil a révélé une erreur dans la table des blocs de correction d'erreurs pour le niveau H, qui aurait produit des symboles structurellement valides mais totalement indécodables au réglage de redondance le plus élevé. Rien dans l'image n'aurait semblé incorrect. Le décodeur l'a trouvée dès le premier test.

La correction d'erreurs n'autorise pas à couvrir le centre

Chaque symbole QR contient des mots de code redondants afin qu'un lecteur puisse encore récupérer les données après une dégradation. Les quatre niveaux récupèrent environ ~7% au niveau L, ~15% au niveau M, ~25% au niveau Q, ~30% au niveau H.

Ces pourcentages expliquent pourquoi les designers placent des logos au centre des codes, et c'est une mauvaise habitude présentée comme une fonction. La redondance sert à résister aux dégradations qui surviennent après l'impression — éraflure, pli, tache de café, faible luminosité. La dépenser à l'avance pour la décoration signifie que le code commence sa vie sans marge, alors que ce sont les codes manipulés qui en ont le plus besoin.

Un niveau supérieur rend aussi le symbole plus dense pour un même contenu, car la redondance doit être placée quelque part. Un symbole de version 1 contient 17 octets au niveau L et 7 au niveau H — la même grille de 21 par 21, avec moins de la moitié du contenu. Plus dense signifie une impression physique plus grande pour rester lisible, si bien que « utiliser H par sécurité » produit fréquemment un code qui se scanne moins bien.

Le niveau M est le bon choix par défaut. Passez à Q ou H lorsque le code sera imprimé en petit, sur une surface courbe ou à un endroit où il sera touché.

L'ensemble de la table est publié en JSON dans qr.json, pour chaque version de 1 à 40, avec les capacités numériques et alphanumériques ainsi que les formats de contenu accompagnés d'exemples détaillés. Elle est générée plutôt que saisie, pour une raison qu'il vaut la peine de répéter : écrire une seconde fois la structure des blocs est précisément ainsi qu'un nombre erroné peut persister.

PNG ou SVG, et pourquoi le pas des pixels compte

Les deux sont produits, les deux sont gratuits et aucun ne comporte de filigrane. Prenez le SVG pour tout ce qui va être imprimé ou intégré à un fichier de conception : c'est un format vectoriel avec une view box entière et un chemin unique, qui s'agrandit d'une carte de visite à une affiche sans flou et s'ouvre proprement dans Illustrator, Figma, Inkscape et les logiciels de mise en page. Prenez le PNG pour un document, une diapositive, un message ou une page web, où un raster fixe est plus simple à placer.

La taille du PNG est arrondie vers le bas afin que chaque module corresponde à un nombre entier de pixels. Cela semble tatillon, mais ne l'est pas : un symbole de 29 modules rendu dans exactement 500 pixels donne 17,24 pixels par module, et ce quart de pixel restant forme un bord gris le long de chaque limite de module. Les appareils photo s'en accommodent la plupart du temps, ce qui est pire que de ne jamais s'en accommoder, car l'échec survient sur l'impression qui comptait.

La zone silencieuse de quatre modules autour du symbole fait partie du symbole, et non d'une marge. C'est une exigence de ISO/IEC 18004 et la raison la plus courante pour laquelle un code recadré à la main ne se scanne pas. Ne la rognez pas, ne placez pas le code directement contre un bloc coloré et ne laissez pas un outil de mise en page le recadrer aux limites de l'encre.

Encodage, jeux de caractères et question de l'ECI

L'encodeur choisit le mode le plus compact autorisé par le contenu : numérique pour les chiffres, alphanumérique pour l'ensemble restreint de majuscules et mode octet pour tout le reste. Une table de capacité correspondant au symbole choisi, pour chaque niveau, est affichée avant la génération.

Lorsque le contenu contient des caractères non ASCII — un nom de réseau accentué, un nom en cyrillique ou en japonais — l'encodeur écrit un en-tête ECI déclarant UTF-8. C'est la déclaration correcte, et c'est également ce que les anciens scanners risquent le plus de mal gérer ; elle n'est donc ajoutée que lorsque les octets l'exigent réellement, et le récapitulatif indique quand elle est présente. Un contenu entièrement ASCII ne contient aucun en-tête ECI et se comporte de la même manière dans tous les lecteurs jamais construits.

Rien sur cette page n'accède au réseau. L'encodeur, le moteur de rendu et le décodeur qui vérifie le résultat sont tous des JavaScript exécutés dans cet onglet, et les modules sous /js/tools/ ne contiennent aucun code qui effectue des requêtes. Déconnectez-vous après le chargement de la page : chaque partie fonctionne encore — ce qui, pour un outil auquel vous allez confier votre mot de passe Wi-Fi, est la propriété qu'il vaut la peine de vérifier plutôt que de croire sur parole.