Pourquoi un code QR ne scanne pas, et comment savoir quel défaut vous avez

Pourquoi mon code QR ne scanne-t-il pas ?

Un code QR échoue à l'une de trois étapes : le scanneur ne trouve jamais le symbole, le scanneur le trouve mais n'arrive pas à lire proprement les modules, ou le scanneur le lit parfaitement et ce que le code désigne est cassé. Les défauts de détection, de décodage et de destination se voient différemment de l'extérieur et n'ont aucune solution commune.

La détection est l'étape où un scanneur localise un code QR dans l'image de la caméra et en déduit la limite, la rotation et la grille de modules, avant que la moindre donnée soit lue. Le décodage est l'étape où un scanneur lit les modules à l'intérieur d'un code QR déjà localisé et reconstitue les données qu'ils encodent. L'ordre compte davantage que les définitions : tout ce que le décodeur sait faire, il ne peut le faire que sur un symbole que la détection a déjà trouvé.

C'est cet ordre qui rend le symptôme diagnostique. Un échec de détection est absolu - le téléphone n'affiche rien du tout, à chaque fois, à toute distance - parce que pour lui il n'y a aucun code dans le cadre. Un échec de décodage est conditionnel - le code se lit de plus près, ou sous une meilleure lumière, ou sur un téléphone et pas sur l'autre - parce que le décodeur travaille sur une image limite et l'emporte parfois. Un échec de destination ressemble à une réussite suivie d'une déception : la notification apparaît, le lien s'ouvre, et la page derrière est morte.

La conséquence pratique, c'est que la plupart des conseils de dépannage QR visent la mauvaise étape. Monter le niveau de correction d'erreurs, ajouter une bordure, régénérer en plus haute résolution : chacune de ces actions est la bonne solution pour exactement un défaut et un tirage gâché pour les deux autres.

Commencez par ce que fait le téléphone, pas par le code

Pointez un téléphone vers le code et regardez ce qui se passe, à deux distances, sur deux téléphones. La réponse à cette observation réduit le défaut à une seule catégorie avant toute mesure, et elle coûte une trentaine de secondes.

La ligne à retenir est la première. Un silence total et reproductible n'est pas une lecture faible : c'est l'absence de lecture, et elle désigne les trois ou quatre centimètres carrés autour du symbole plutôt que quoi que ce soit à l'intérieur.

Il ne se passe rien du tout : le code n'est jamais détecté

Un code qui ne produit aucune réaction, à aucune distance et sur plus d'un téléphone, a échoué à la détection et non au décodage, et il y a cinq causes courantes. Les données à l'intérieur du symbole sont presque toujours parfaites ; ce qui n'est pas encore décidé, c'est qu'il y ait là un symbole à lire.

• La zone de silence a disparu. Un code QR a besoin de quatre modules libres sur chaque côté, et c'est cette marge qui rend le bord du symbole repérable. Un filet, une légende, une photo qui passe sous le code ou un bord de coupe à l'intérieur de cet anneau cassent la détection alors que chaque module reste intact. C'est de loin la cause la plus fréquente d'un silence total.
• Un motif de détection est recouvert, rogné ou abîmé. Les trois carrés concentriques des coins ne portent aucune correction d'erreurs. Un autocollant sur un coin, une découpe qui l'entame, ou un logo tiré hors du centre jusque sur lui signifient que le code n'est pas trouvé du tout.
• Le code est en modules clairs sur fond sombre. Les codes inversés sont autorisés par la norme et peu fiables en pratique : plusieurs applications appareil photo natives n'essaient même pas, si bien que le même fichier scanne dans une application dédiée et ne fait rien dans celle que les gens utilisent réellement.
• Le symbole n'est pas un code QR modèle 2. Data Matrix, Aztec, PDF417 et Micro QR ressemblent tous à des codes QR pour un non-spécialiste et ne sont pas lus par la voie QR d'un appareil photo de téléphone. Ils viennent le plus souvent de la bibliothèque de visuels d'un fournisseur - code QR vs code-barres explique à quoi sert chaque symbole.
• La surface n'est pas plane, ou pas immobile. Un code enroulé autour d'une bouteille, plié sur une pliure ou derrière un verre bombé déforme la grille de modules au-delà de ce que les motifs d'alignement peuvent corriger. Un téléphone qui n'arrive jamais à faire le point produit le même résultat, ce qui arrive quand un petit code est tenu plus près que la distance minimale de mise au point.

La façon la plus rapide de séparer le visuel de la mise en page : passez le fichier exporté dans un décodeur sur ordinateur. Si le scanneur de code QR lit le fichier et qu'aucun téléphone ne lit la pièce imprimée, le défaut est entré quelque part entre le fichier et l'objet fini - une maquette, un réglage d'export ou la presse. Si le fichier lui-même ne se décode pas, arrêtez de regarder l'impression.

La zone de silence traite cette marge de bout en bout : combien font quatre modules en millimètres à votre taille imprimée, les habitudes de maquette qui la suppriment, et comment mesurer ce qu'un fichier reçu porte réellement.

Il scanne de près mais pas depuis l'endroit où les gens se tiennent

Un code qui se lit à 20 cm et échoue à 2 m est dimensionné pour la mauvaise distance, et rien d'autre. Comptez environ 1 cm de largeur de code pour 10 cm de distance de lecture, avec un plancher de 2 cm sur l'encombrement total - un code lu depuis 3 m demande donc à peu près 30 cm, et un code lu depuis 40 cm a toujours besoin de ses 2 cm.

La règle de distance est un raccourci pour ce qui compte vraiment : la largeur d'un module dans le cadre de la caméra. Un téléphone doit résoudre un seul module avant de pouvoir lire quoi que ce soit, donc le calcul qui décide du résultat est la largeur imprimée divisée par le nombre de modules, et ce nombre monte avec la longueur de l'URL. Deux codes imprimés aux mêmes 3 cm peuvent se comporter de façon totalement différente si l'un porte un lien de 30 caractères et l'autre de 200.

Symptômes qui confirment un défaut de taille et pas autre chose :

• Il se lit de façon fiable à courte distance. Rien ne cloche dans le visuel ; le code n'est simplement pas assez grand pour être résolu de plus loin.
• La distance de lecture s'améliore en pleine lumière. Plus de lumière signifie une exposition plus courte et moins de flou de bougé, ce qui rachète une partie de la largeur de module manquante.
• Un lien plus long a mis hors service un code qui marchait. Même taille imprimée, symbole plus dense, modules plus petits. Raccourcissez la destination et réimprimez.
• Il échoue sur le petit format et marche sur l'affiche. Le même fichier à deux tailles est la preuve la plus nette qui soit.

Vérifiez la largeur de module avant d'agrandir à l'estime. Les modules imprimés devraient faire 0,4 mm ou plus sur papier couché et 0,5 mm ou plus sur non couché, et le calculateur de taille d'impression fait ce calcul à partir de la largeur et de la distance de lecture. Taille minimale pour l'impression contient les tableaux par support et explique pourquoi le plancher se situe là.

Il scanne à l'écran mais pas sur la pièce imprimée

Un code qui marche sur un moniteur et échoue sur papier a généralement perdu de la largeur de module, du contraste ou de la netteté de bord dans l'étape intermédiaire, et l'écran masque les trois. Un écran donne au décodeur un éclairage uniforme, un rapport de contraste élevé et des bords de pixel francs ; le papier lui donne de l'engraissement, de la lumière ambiante et un bord flou sur chaque module.

Ce qu'il faut vérifier, dans l'ordre où c'est le plus souvent en cause :

• La largeur de module en millimètres. Divisez la largeur imprimée par le nombre de modules zone de silence comprise. Sous 0,4 mm sur couché ou 0,5 mm sur non couché, le code est trop petit, aussi propre soit le fichier.
• Le format du fichier. JPEG et WebP sont avec pertes : ils déposent des franges grises sur chaque bord de module, c'est-à-dire exactement là où le décodeur a besoin d'une limite franche. Une capture d'écran d'un code, c'est le même problème avec un rééchantillonnage en plus. Envoyez du vectoriel partout où la destination l'accepte - SVG vs PNG vs PDF vs EPS explique quel fichier va où.
• La résolution effective. Un code matriciel a besoin d'un nombre entier de pixels par module à la taille finale, sinon chaque bord de module tombe au milieu d'un pixel et l'anticrénelage le transforme en gris flou. Résolution et DPI contient la formule dans les deux sens, et le calculateur de DPI l'exécute.
• La zone de silence dans la maquette montée. La marge n'est presque jamais perdue à l'export ; elle se perd après, quand le code rencontre une page qui avait besoin de la place.
• L'engraissement sur papier absorbant. Le non couché, le kraft et le papier journal laissent les modules sombres empiéter sur les clairs. Le symbole s'assombrit dans l'ensemble et les modules clairs se resserrent, et c'est pour cela que le plancher de 0,5 mm sur non couché est plus haut que celui du couché.

Le validateur de code QR mesure les trois choses lisibles dans un fichier - la marge vers l'extérieur depuis chaque bord, le contraste entre les deux couleurs, et la taille de module à une largeur imprimée donnée - et rapporte le côté le pire plutôt qu'une moyenne. Passez-y l'export avant que le fichier parte chez l'imprimeur, puis tirez une épreuve sur le vrai papier.

Il scanne sur un téléphone et pas sur un autre

Un code qui se lit sur un téléphone et pas sur un autre est pile à la limite plutôt que cassé, et cette limite est presque toujours la largeur de module, le contraste ou le schéma de couleurs. Ni Apple ni Google ne publie de seuil de lecture pour ses applications appareil photo, donc la lecture honnête d'un résultat partagé est que le code est limite - pas qu'un téléphone est défectueux.

La solution à un résultat partagé n'est pas de tester plus de téléphones. C'est de sortir le code de la limite où il se trouve : ajoutez 25 % à la largeur imprimée, écartez davantage la paire de couleurs, ou remettez un code inversé à l'endroit. Un code qui se lit sur tous les téléphones du bureau est un code avec de la marge, et la marge est la seule chose qui survive à un tirage, à un couloir mal éclairé et à une protection d'écran fêlée.

Il marchait au studio et échoue là où il est installé

Un code qui se lit sur le bureau et échoue sur le mur a rencontré la lumière, et on ne peut pas reprocher la lumière au visuel. Les deux mécanismes sont le reflet, où une réflexion spéculaire efface une partie du symbole, et la faible lumière ambiante, où la caméra allonge l'exposition et où le flou de bougé mange les bords des modules.

Ce qu'il faut vérifier sur place plutôt que dans le fichier :

• Un spot ou une fenêtre en face du code. Le pelliculage brillant le renvoie droit dans l'objectif. Placez-vous là où se place le lecteur et cherchez la tache claire sur le symbole : si vous la voyez, la caméra en voit davantage.
• Si le lecteur peut incliner le code. Un chevalet de table s'oriente à la main hors du reflet ; une enseigne murale non. Cette seule question décide de la finition davantage que le papier - mat vs brillant traite cela de bout en bout.
• Le contraste des couleurs sous l'éclairage réel. Une lumière chaude et faible aplatit un code dont les couleurs ont été choisies sur un moniteur calibré. Les valeurs de travail sont 4:1 à l'écran et 7:1 en impression, et le vérificateur de contraste donne le rapport d'une paire de couleurs avant toute impression.
• La hauteur et la portée. Un code posé au-dessus du niveau des yeux est lu de biais par tous ceux qui sont plus petits que l'installateur, et une lecture de biais demande plus de taille et plus de contraste qu'une lecture de face.
• Derrière une vitre. Un cadre, une fenêtre ou une vitrine ajoutent deux surfaces réfléchissantes, et le code doit fonctionner à travers les deux.

Le contraste est l'axe le plus mal jugé, parce que le plancher du décodeur lui-même se situe très en dessous de toute recommandation de conception : le décodeur open source consultable abandonne autour de 1,24:1, un gris à peine visible sur blanc. Ce n'est pas une autorisation de concevoir dans ces eaux-là. Où l'iPhone et Android abandonnent expose d'où vient ce chiffre et pourquoi le papier, la lumière et l'objectif dépensent le reste de la marge.

Il scanne instantanément et ensuite rien d'utile ne se passe

Si le téléphone détecte le code et affiche une notification, le code QR a fait tout son travail et le défaut est derrière lui. Aucune modification du symbole, de la taille, des couleurs ou du niveau de correction d'erreurs ne corrigera un problème de destination, et c'est la catégorie que la plupart des conseils de dépannage ignorent complètement.

Ce qui se passe vraiment derrière un code qui fonctionne :

• L'URL est morte ou a été mal saisie à la génération. Un code encode une chaîne, pas une promesse. Lisez la chaîne décodée caractère par caractère face à l'adresse voulue, surtout toute partie tapée à la main.
• Le lien n'a pas de schéma. Une chaîne comme koloqr.com/menu sans https:// devant est du texte pour certains scanneurs et un lien pour d'autres, si bien qu'elle s'ouvre sur un téléphone et affiche une chaîne à copier sur le suivant.
• La destination redirige vers quelque chose qui échoue sur mobile. Un lien court vers une page réservée au bureau, un PDF qui s'ouvre dans une visionneuse que personne n'a, ou une chaîne de redirections qui expire sur une connexion lente.
• La page demande une connexion, ou est bloquée géographiquement. La lecture fonctionne parfaitement et le lecteur se heurte à un mur, ce qu'il vous rapportera comme "le code QR ne marche pas".
• Un code Wi-Fi avec le mauvais type de sécurité ou un mot de passe non échappé. Un réseau WPA2 dont les données déclarent qu'il n'y a aucun mot de passe, un SSID masqué sans l'indicateur de masquage, ou un mot de passe contenant un point-virgule ou une barre oblique inverse jamais échappé. Voir les codes QR Wi-Fi pour le format des données.
• Un numéro de téléphone avec de la mise en forme dedans. Les espaces, les parenthèses et les tirets à l'intérieur de données tel: sont traités de façon incohérente. Ce qui voyage, ce sont les chiffres et un plus en tête - les codes QR de numéro de téléphone donnent le format.
• Un code dynamique dont la redirection a expiré. Un code vendu par abonnement cesse de résoudre en même temps que l'abonnement, et la pièce imprimée n'a aucun moyen de le dire.

La vérification qui sépare cette catégorie de toutes les autres prend une minute : décodez le fichier, copiez la chaîne, et collez-la dans un navigateur sur le téléphone. Si la chaîne est bonne et que la page est cassée, l'impression va bien et le retirage n'aurait rien changé.

Il a marché pendant des mois puis s'est arrêté

Un code qui a cessé de fonctionner sans que personne ne touche à la pièce imprimée a perdu soit sa destination, soit son contraste, et ce sont les deux seuls candidats à examiner en premier. Le symbole lui-même ne change pas ; ce qui change, c'est ce qu'il désigne, ou l'encre avec laquelle il est imprimé.

Un code statique encode sa destination de façon permanente, et c'est pourquoi la réponse durable est une URL que vous contrôlez et pouvez rediriger. Ce qu'achète vraiment un abonnement de code QR dynamique expose ce marché en entier, y compris ce qui arrive au tirage imprimé quand le paiement s'arrête.

Il a cessé de scanner après que quelqu'un a retouché le visuel

La plupart des codes qui se cassent pendant la conception se cassent de l'une de six façons, et les six se réparent en régénérant le code plutôt qu'en réparant le fichier. L'indice : un export qui fonctionnait est entré dans un outil de design et un export cassé en est sorti.

• Le logo a grossi. Un logo central couvrant jusqu'à environ 20 % de la surface du symbole se récupère de façon fiable au niveau H, et le plafond théorique de 30 % n'est pas de la capacité disponible : l'engraissement, un reflet et une trace de doigt sont prélevés sur le même budget. Les niveaux de correction d'erreurs en donnent la géométrie.
• Le logo est sorti du centre. Un dégât centré se répartit uniformément entre les blocs de récupération entrelacés ; le même logo décentré le concentre, et près d'un coin il tombe sur un motif de détection, qu'aucun niveau ne protège.
• Le code a été étiré. Toute mise à l'échelle non uniforme rend les modules rectangulaires et la grille incohérente. Verrouillez les proportions avant de redimensionner quoi que ce soit.
• Les couleurs ont été remplacées par celles de la marque. Deux couleurs de marque de valeur moyenne peuvent paraître très contrastées et porter presque aucun écart de luminance. Vérifiez la paire plutôt que de vous fier aux nuanciers.
• Un cadre ou une légende a été dessiné au ras du symbole. Un cadre convient si son bord intérieur reste à quatre modules au moins. Dessiné au ras du symbole, il se trouve dans la zone de silence.
• Il a été exporté en capture d'écran ou en JPEG. Le rééchantillonnage et la compression avec pertes ramollissent tous deux les bords des modules - voir copier un code QR dans Figma pour la voie de placement et d'export qui ne le fait pas.

Régénérer ne coûte rien, et un code régénéré est exact là où un code réparé est approximativement correct. KoloQR, un générateur de codes QR gratuit avec des codes QR ronds et de formes personnalisées, exporte en SVG, PNG, PDF et EPS avec la zone de silence incluse et le niveau de correction d'erreurs fixé avant l'export. Le style n'améliore jamais la lecture : les formes de module décoratives déposent moins d'encre dans chaque cellule que les carrées, donc un code stylisé dépense de la tolérance au lieu d'en créer, et les formes de QR personnalisées scannent-elles ? contient les mesures qui le montrent.

Comment diagnostiquer un code QR qui ne scanne pas

Travaillez du visuel vers l'extérieur plutôt que du téléphone vers l'intérieur, parce que le fichier est la seule partie de la chaîne que vous pouvez mesurer exactement. La procédure ci-dessous nomme le défaut en une dizaine de minutes et fonctionne sur une pièce imprimée que vous n'avez pas conçue, sans fichier source et sans notes.

1. Observez ce que font deux téléphones, à deux distances. Rien du tout sur les deux signifie détection. Se lit parfois signifie décodage. Se lit instantanément signifie que le code va bien et la destination non.
2. Décodez le fichier sur ordinateur. Déposez l'export dans un décodeur qui lit depuis une image. Si le fichier se décode et pas l'impression, le défaut est entré après l'export.
3. Lisez la chaîne décodée caractère par caractère. Comparez-la avec l'adresse que vous vouliez encoder, puis ouvrez-la dans un navigateur mobile. Une chaîne fausse ou morte arrête l'enquête ici.
4. Mesurez la marge libre sur son côté le pire. Comparez l'espace libre à la largeur d'un module au même zoom. Regardez les quatre côtés et retenez le plus petit, dans la maquette montée et non dans le fichier.
5. Calculez la largeur de module en millimètres. Divisez la largeur imprimée par le nombre de modules marge comprise. Sous 0,4 mm sur couché ou 0,5 mm sur non couché, le code est trop petit.
6. Vérifiez le contraste de la vraie paire de couleurs. Pas celui des nuanciers, celui du résultat imprimé. Sous 7:1 environ en impression, le code dépense la marge dont il aura besoin pour la lumière et les reflets.
7. Regardez le code là où il vit. Placez-vous là où se place le lecteur, à sa hauteur, avec les lumières de la pièce allumées. Les reflets et l'angle de lecture sont invisibles dans toutes les vérifications sur fichier ci-dessus.
8. Changez une chose et tirez une épreuve. Une feuille à la taille finale sur le papier de production. Changer trois choses à la fois, c'est garantir que le prochain échec sera aussi inexpliqué que celui-ci.

Si toutes les vérifications passent et que le code ne se lit toujours pas, régénérez-le depuis la destination et comparez les deux symboles côte à côte. Un fichier passé par plusieurs outils peut porter des dégâts qu'aucune mesure isolée n'attrape, et un export neuf prend moins de temps qu'un tour de mesures supplémentaire.

Les seuils selon lesquels nous notons un code

KoloQR note un code QR sur quatre chiffres, et un seul d'entre eux vient de la norme. Les quatre modules de zone de silence sont le chiffre d'ISO/IEC 18004 ; les paliers de contraste, la ligne d'avertissement sous la marge et le plancher de module sont les nôtres, tracés là où un code cesse d'avoir de la marge et non là où il cesse de fonctionner. Les quatre se vérifient en passant un fichier dans les outils plutôt qu'en nous croyant sur parole.

Deux d'entre eux portent un jugement qui mérite d'être dit franchement. À deux ou trois modules de zone de silence nous avertissons au lieu de recaler, parce que c'est ce que laissent la plupart des cadres décoratifs et ce que la plupart des décodeurs lisent encore : c'est un code sans marge, pas un code cassé. Et nous jugeons le contraste sur le pire entre les modules sombres et les motifs de détection plutôt que sur une moyenne, parce qu'un scanneur doit trouver les trois carrés d'angle avant de lire quoi que ce soit, et qu'un code aux modules sombres et aux motifs de détection pâles échoue à la détection alors que sa moyenne reste tout à fait présentable.

Le générateur applique la même règle de contraste en direct : le badge à côté de l'aperçu retient la pire des deux paires de couleurs et passe au vert à 4:1. C'est la ligne écran et non la ligne impression, et c'est délibéré - un code conçu pour une pièce imprimée devrait être à 7:1 avant de quitter la page, et le vérificateur de contraste est l'endroit où trancher cela face à une palette de marque.

Ce qu'il ne faut pas faire quand un code QR ne scanne pas

L'erreur de dépannage la plus coûteuse est de réimprimer avant que le défaut ait un nom. Un retirage change plusieurs variables à la fois, donc un code qui fonctionne ensuite ne vous apprend rien, et un code qui échoue encore a coûté le tirage deux fois.