Perché un codice QR non si legge, e come capire quale difetto hai

Perché il mio codice QR non si legge?

Un codice QR fallisce in una di tre fasi: lo scanner non trova mai il simbolo, lo scanner lo trova ma non riesce a leggere i moduli in modo pulito, oppure lo scanner lo legge perfettamente e ciò a cui il codice punta è rotto. I difetti di rilevamento, quelli di decodifica e quelli di destinazione si vedono in modo diverso da fuori e non hanno nessuna soluzione in comune.

Il rilevamento è la fase in cui uno scanner localizza un codice QR nell'immagine della fotocamera e ne ricava il contorno, la rotazione e la griglia dei moduli, prima che venga letto alcun dato. La decodifica è la fase in cui uno scanner legge i moduli dentro un codice QR già localizzato e ricostruisce i dati che essi codificano. L'ordine conta più delle definizioni: tutto quello che il decodificatore sa fare, lo può fare soltanto su un simbolo che il rilevamento ha già trovato.

È proprio quest'ordine a rendere il sintomo una diagnosi. Un fallimento di rilevamento è assoluto - il telefono non mostra niente, ogni volta, da ogni distanza - perché per lui nel riquadro non c'è nessun codice. Un fallimento di decodifica è condizionale - il codice si legge più da vicino, o con luce migliore, o su un telefono e non sull'altro - perché il decodificatore lavora su un'immagine al limite e a volte vince. Un fallimento di destinazione sembra un successo seguito da una delusione: la notifica compare, il link si apre, e la pagina dietro è morta.

La conseguenza pratica è che gran parte dei consigli su come sistemare un codice QR mira alla fase sbagliata. Alzare il livello di correzione d'errore, aggiungere un bordo, rigenerare a risoluzione maggiore: ognuna di queste è la soluzione giusta per esattamente un difetto e una tiratura buttata per gli altri due.

Parti da cosa fa il telefono, non dal codice

Punta un telefono verso il codice e guarda cosa succede, a due distanze, con due telefoni. La risposta a quell'osservazione riduce il difetto a una sola categoria prima di qualunque misurazione, e costa una trentina di secondi.

La riga da mandare a memoria è la prima. Un silenzio totale e ripetibile non è una lettura debole: è l'assenza di lettura, e punta ai tre o quattro centimetri quadrati attorno al simbolo, non a qualcosa dentro di esso.

Non succede proprio niente: il codice non viene mai rilevato

Un codice che non produce nessuna reazione, a nessuna distanza e su più di un telefono, ha fallito il rilevamento e non la decodifica, e le cause comuni sono cinque. I dati dentro il simbolo sono quasi sempre perfetti; quello che non è ancora stato deciso è che lì ci sia un simbolo da leggere.

• La zona di silenzio è sparita. Un codice QR vuole quattro moduli liberi su ogni lato, ed è quel margine a rendere individuabile il bordo del simbolo. Un filetto, una didascalia, una foto che passa sotto il codice o una linea di taglio dentro quell'anello rompono il rilevamento mentre ogni modulo resta intatto. È di gran lunga la causa più comune del silenzio totale.
• Un pattern di rilevamento è coperto, tagliato o rovinato. I tre quadrati concentrici agli angoli non hanno alcuna correzione d'errore. Un adesivo su un angolo, una fustella che lo intacca, o un logo trascinato fuori centro sopra di esso significano che il codice non viene proprio trovato.
• Il codice è a moduli chiari su fondo scuro. I codici invertiti sono ammessi dallo standard e inaffidabili nella pratica: diverse app fotocamera native non ci provano nemmeno, quindi lo stesso file si legge in un'app dedicata e non fa niente nell'app che la gente usa davvero.
• Il simbolo non è un codice QR modello 2. Data Matrix, Aztec, PDF417 e Micro QR sembrano tutti codici QR a chi non è del mestiere e non vengono letti dal percorso QR della fotocamera di un telefono. Di solito arrivano dalla libreria grafica di un fornitore - codice QR vs codice a barre spiega a cosa serve ciascun simbolo.
• La superficie non è piana, o non è ferma. Un codice avvolto su una bottiglia, piegato su una cordonatura o dietro un vetro curvo deforma la griglia dei moduli oltre quello che i pattern di allineamento possono correggere. Lo stesso fa un telefono che non riesce mai a mettere a fuoco, che è quello che succede quando un codice piccolo viene avvicinato oltre la distanza minima di messa a fuoco.

Il modo più rapido per separare la grafica dall'impaginazione: passa il file esportato in un decodificatore sul computer. Se lo scanner di codici QR legge il file e nessun telefono legge lo stampato, il difetto è entrato da qualche parte tra il file e l'oggetto finito - un impaginato, un'impostazione di export o la macchina da stampa. Se è il file stesso a non decodificarsi, smetti di guardare la stampa.

La zona di silenzio affronta quel margine dall'inizio alla fine: quanti millimetri fanno quattro moduli alla tua dimensione di stampa, quali abitudini di impaginazione lo eliminano, e come misurare quello che un file ricevuto porta davvero.

Si legge da vicino ma non da dove sta la gente

Un codice che si legge a 20 cm e fallisce a 2 m è dimensionato per la distanza sbagliata, e nient'altro. Conta circa 1 cm di larghezza del codice ogni 10 cm di distanza di lettura, con una soglia di 2 cm sull'ingombro totale - quindi un codice letto da 3 m vuole circa 30 cm, e uno letto da 40 cm vuole comunque i suoi 2 cm.

La regola della distanza è una scorciatoia per quello che conta davvero, cioè la larghezza di un modulo dentro l'inquadratura. Un telefono deve risolvere un singolo modulo prima di poter leggere qualcosa, quindi il calcolo che decide l'esito è larghezza stampata diviso numero di moduli, e quel numero cresce con la lunghezza dell'URL. Due codici stampati agli stessi 3 cm possono comportarsi in modo completamente diverso se uno porta un link da 30 caratteri e l'altro da 200.

Sintomi che confermano un difetto di dimensione e non altro:

• Si legge in modo affidabile da vicino. Non c'è niente di sbagliato nella grafica; il codice semplicemente non è abbastanza grande per essere risolto da più lontano.
• La distanza di lettura migliora con la luce forte. Più luce significa esposizione più corta e meno mosso, il che recupera una parte della larghezza di modulo che manca.
• Un link più lungo ha messo fuori uso un codice che funzionava. Stessa dimensione stampata, simbolo più denso, moduli più piccoli. Accorcia la destinazione e ristampa.
• Fallisce sul formato piccolo e funziona sul manifesto. Lo stesso file a due dimensioni è la prova più pulita che esista.

Controlla la larghezza del modulo prima di ingrandire a occhio. I moduli stampati dovrebbero essere di 0,4 mm o più su carta patinata e di 0,5 mm o più su carta naturale, e il calcolatore delle dimensioni di stampa fa quel calcolo a partire dalla larghezza e dalla distanza di lettura. Dimensione minima per la stampa ha le tabelle per supporto e spiega perché la soglia sta dov'è.

Si legge sullo schermo ma non sullo stampato

Un codice che funziona sul monitor e fallisce sulla carta di solito ha perso larghezza di modulo, contrasto o nitidezza di bordo nel passaggio tra i due, e lo schermo nasconde tutt'e tre. Un display dà al decodificatore illuminazione uniforme, un rapporto di contrasto alto e bordi di pixel netti; la carta gli dà ingrossamento del punto, luce ambiente e un bordo morbido su ogni modulo.

Cosa controllare, nell'ordine in cui più spesso è sbagliato:

• La larghezza del modulo in millimetri. Dividi la larghezza stampata per il numero di moduli inclusa la zona di silenzio. Sotto 0,4 mm su patinata o 0,5 mm su naturale, il codice è troppo piccolo per quanto pulito sia il file.
• Il formato del file. JPEG e WebP sono con perdita: lasciano frange grigie su ogni bordo di modulo, cioè esattamente dove il decodificatore vuole un confine netto. Uno screenshot di un codice è lo stesso problema con in più un ricampionamento. Manda vettoriale ovunque la destinazione lo accetti - SVG vs PNG vs PDF vs EPS spiega quale file va dove.
• La risoluzione effettiva. Un codice raster vuole un numero intero di pixel per modulo alla dimensione finale, altrimenti ogni bordo di modulo cade a metà pixel e l'antialiasing lo trasforma in un grigio morbido. Risoluzione e DPI ha la formula nei due sensi, e il calcolatore di DPI la esegue.
• La zona di silenzio nell'impaginato finito. Il margine non si perde quasi mai in fase di export; si perde dopo, quando il codice incontra una pagina che aveva bisogno di quello spazio.
• L'ingrossamento del punto su carta assorbente. Carta naturale, kraft e carta da giornale lasciano che i moduli scuri crescano su quelli chiari. Il simbolo si scurisce nel complesso e i moduli chiari si stringono, ed è per questo che la soglia di 0,5 mm su naturale è più alta di quella su patinata.

Il validatore di codici QR misura le tre cose leggibili da un file - il margine verso l'esterno da ciascun bordo, il contrasto tra i due colori, e la dimensione del modulo a una larghezza di stampa dichiarata - e riporta il lato peggiore invece di una media. Passaci l'export prima che il file vada in tipografia, poi tira una prova sulla carta vera.

Si legge su un telefono e sull'altro no

Un codice che si legge su un telefono e non su un altro sta proprio al limite invece di essere rotto, e quel limite è quasi sempre larghezza di modulo, contrasto o schema di colori. Né Apple né Google pubblicano una soglia di lettura per le loro app fotocamera, quindi la lettura onesta di un risultato diviso è che il codice è al limite - non che un telefono è difettoso.

La soluzione a un risultato diviso non è provare più telefoni. È spostare il codice dal limite su cui sta: aggiungi il 25% alla larghezza stampata, allontana di più la coppia di colori, o rimetti dritto un codice invertito. Un codice che si legge su tutti i telefoni dell'ufficio è un codice con margine, e il margine è l'unica cosa che sopravvive a una tiratura, a un corridoio mal illuminato e a una pellicola dello schermo crepata.

Funzionava in studio e fallisce dov'è installato

Un codice che si legge sulla scrivania e fallisce sul muro ha incontrato la luce, e della luce non si può incolpare la grafica. I due meccanismi sono il riflesso, dove un bagliore speculare cancella una parte del simbolo, e la poca luce ambiente, dove la fotocamera allunga l'esposizione e il mosso mangia i bordi dei moduli.

Cosa controllare sul posto invece che nel file:

• Un faretto o una finestra di fronte al codice. La plastificazione lucida lo rimanda dritto nell'obiettivo. Mettiti dove sta chi legge e cerca la macchia chiara sul simbolo: se la vedi tu, la fotocamera ne vede di più.
• Se chi legge può inclinare il codice. Un espositore da tavolo si gira a mano fuori dal bagliore; un'insegna a muro no. Quella sola domanda decide la finitura più della carta - opaco vs lucido la affronta dall'inizio alla fine.
• Il contrasto dei colori sotto la luce reale. Una luce calda e bassa appiattisce un codice i cui colori sono stati scelti su un monitor calibrato. I numeri di lavoro sono 4:1 a schermo e 7:1 in stampa, e il verificatore di contrasto dà il rapporto di una coppia di colori prima che si stampi qualsiasi cosa.
• Altezza e portata. Un codice montato sopra il livello degli occhi viene letto di sbieco da chiunque sia più basso di chi l'ha installato, e una lettura di sbieco vuole più dimensione e più contrasto di una frontale.
• Dietro un vetro. Una cornice, una finestra o una vetrina aggiungono due superfici riflettenti, e il codice deve funzionare attraverso entrambe.

Il contrasto è l'asse che viene valutato peggio, perché la soglia del decodificatore stesso è molto sotto qualunque linea guida di progetto: il decodificatore open source consultabile si arrende attorno a 1,24:1, un grigio appena visibile sul bianco. Questo non è il permesso di progettare da quelle parti. Dove iPhone e Android si arrendono spiega da dove viene quel numero e perché carta, luce e obiettivo si mangiano il resto del margine.

Si legge subito e poi non succede niente di utile

Se il telefono rileva il codice e mostra una notifica, il codice QR ha fatto tutto il suo lavoro e il difetto sta dietro. Nessuna modifica al simbolo, alla dimensione, ai colori o al livello di correzione d'errore risolve un problema di destinazione, e questa è la categoria che la maggior parte dei consigli di diagnosi ignora del tutto.

Cosa va davvero storto dietro un codice che funziona:

• L'URL è morto o è stato digitato male in fase di generazione. Un codice codifica una stringa, non una promessa. Leggi la stringa decodificata carattere per carattere contro l'indirizzo che volevi, soprattutto ogni parte scritta a mano.
• Al link manca lo schema. Una stringa come koloqr.com/menu senza https:// davanti è testo per certi scanner e link per altri, quindi su un telefono si apre e sul successivo mostra una stringa da copiare.
• La destinazione reindirizza a qualcosa che fallisce su mobile. Un link breve verso una pagina solo desktop, un PDF che si apre in un lettore che nessuno ha, o una catena di reindirizzamenti che va in timeout su una connessione lenta.
• La pagina chiede il login, o è bloccata per area geografica. La lettura funziona perfettamente e chi legge sbatte contro un muro, cosa che ti riferirà come "il codice QR non funziona".
• Un codice Wi-Fi con il tipo di sicurezza sbagliato o una password non protetta con escape. Una rete WPA2 il cui contenuto dichiara che non c'è nessuna password, un SSID nascosto senza il flag di nascosto, o una password con un punto e virgola o una barra rovesciata mai gestiti con escape. Vedi codici QR Wi-Fi per il formato del contenuto.
• Un numero di telefono con la formattazione dentro. Spazi, parentesi e trattini dentro un contenuto tel: vengono trattati in modo incoerente. Quello che viaggia sono le cifre e un più iniziale - i codici QR con numero di telefono hanno il formato.
• Un codice dinamico il cui reindirizzamento è scaduto. Un codice venduto in abbonamento smette di risolvere quando finisce l'abbonamento, e lo stampato non ha modo di dirlo.

Il controllo che separa questa categoria da tutte le altre richiede un minuto: decodifica il file, copia la stringa e incollala in un browser sul telefono. Se la stringa è giusta e la pagina è rotta, la stampa va bene e la ristampa non avrebbe cambiato niente.

Ha funzionato per mesi e poi si è fermato

Un codice che ha smesso di funzionare senza che nessuno toccasse lo stampato ha perso o la destinazione o il contrasto, e sono i due soli candidati da guardare per primi. Il simbolo in sé non cambia; cambia ciò a cui punta, o l'inchiostro con cui è stampato.

Un codice statico codifica la sua destinazione in modo permanente, ed è per questo che la risposta duratura è un URL che controlli e puoi reindirizzare. Cosa compra davvero un abbonamento a codici QR dinamici espone quello scambio per intero, compreso cosa succede alla tiratura stampata quando i pagamenti si fermano.

Ha smesso di leggersi dopo che qualcuno ha toccato la grafica

La maggior parte dei codici che si rompono durante la progettazione si rompe in uno di sei modi, e tutti e sei si risolvono rigenerando il codice invece di riparare il file. La spia è che un export funzionante è entrato in uno strumento di design e ne è uscito uno rotto.

• Il logo è cresciuto. Un logo centrale che copre fino a circa il 20% dell'area del simbolo viene recuperato in modo affidabile al livello H, e il tetto teorico del 30% non è capacità avanzata: ingrossamento del punto, riflesso e un'impronta attingono allo stesso budget. I livelli di correzione d'errore ne hanno la geometria.
• Il logo è uscito dal centro. Un danno centrato si distribuisce in modo uniforme sui blocchi di recupero interlacciati; lo stesso logo fuori centro lo concentra, e vicino a un angolo finisce su un pattern di rilevamento, che nessun livello protegge.
• Il codice è stato stirato. Qualsiasi scalatura non uniforme rende i moduli rettangolari e la griglia incoerente. Blocca le proporzioni prima di ridimensionare qualsiasi cosa.
• I colori sono stati sostituiti con quelli del marchio. Due colori aziendali di tono medio possono sembrare molto contrastati e portare quasi nessuna differenza di luminanza. Controlla la coppia invece di fidarti dei campioni.
• Una cornice o una didascalia è stata disegnata a filo del simbolo. Una cornice va bene se il suo bordo interno resta a almeno quattro moduli. Disegnata a filo del simbolo, sta dentro la zona di silenzio.
• È stato esportato come screenshot o come JPEG. Ricampionamento e compressione con perdita ammorbidiscono entrambi i bordi dei moduli - vedi copiare un codice QR in Figma per il percorso di posizionamento ed export che non lo fa.

Rigenerare non costa niente, e un codice rigenerato è esatto dove uno riparato è all'incirca giusto. KoloQR, un generatore di codici QR gratuito con codici QR circolari e di forme personalizzate, esporta SVG, PNG, PDF ed EPS con la zona di silenzio inclusa e il livello di correzione d'errore impostato prima dell'export. Lo stile non migliora mai la lettura: le forme decorative dei moduli mettono meno inchiostro in ogni cella rispetto a quelle quadrate, quindi un codice stilizzato consuma tolleranza invece di crearla, e le forme QR personalizzate si leggono? ha le misurazioni che lo mostrano.

Come diagnosticare un codice QR che non si legge

Lavora dalla grafica verso l'esterno invece che dal telefono verso l'interno, perché il file è l'unica parte della catena che puoi misurare con esattezza. La procedura qui sotto dà un nome al difetto in una decina di minuti e funziona su uno stampato che non hai progettato tu, senza file sorgente e senza appunti.

1. Guarda cosa fanno due telefoni, a due distanze. Niente su entrambi significa rilevamento. Si legge a volte significa decodifica. Si legge subito significa che il codice sta bene e la destinazione no.
2. Decodifica il file sul computer. Trascina l'export in un decodificatore che legge da un'immagine. Se il file si decodifica e la stampa no, il difetto è entrato dopo l'export.
3. Leggi la stringa decodificata carattere per carattere. Confrontala con l'indirizzo che volevi codificare, poi aprila in un browser mobile. Una stringa sbagliata o morta chiude qui l'indagine.
4. Misura il margine libero sul lato peggiore. Confronta lo spazio libero con la larghezza di un modulo allo stesso ingrandimento. Guarda tutti e quattro i lati e tieni il minore, nell'impaginato finito e non nel file.
5. Calcola la larghezza del modulo in millimetri. Dividi la larghezza stampata per il numero di moduli incluso il margine. Sotto 0,4 mm su patinata o 0,5 mm su naturale, il codice è troppo piccolo.
6. Controlla il contrasto della coppia di colori reale. Non quello dei campioni, quello del risultato stampato. Sotto circa 7:1 in stampa, il codice consuma margine che gli servirà per luce e riflessi.
7. Guarda il codice dove vive. Mettiti dove sta chi legge, alla sua altezza, con le luci della stanza accese. Riflessi e angolo di lettura sono invisibili in tutti i controlli sul file qui sopra.
8. Cambia una cosa e tira una prova. Un foglio a dimensione finale sulla carta di produzione. Cambiare tre cose insieme significa che il prossimo fallimento resterà inspiegato quanto questo.

Se tutti i controlli passano e il codice ancora non si legge, rigeneralo dalla destinazione e confronta i due simboli affiancati. Un file passato per diversi strumenti può portare danni che nessuna singola misurazione coglie, e un export nuovo richiede meno tempo di un altro giro di misure.

Le soglie con cui valutiamo un codice

KoloQR valuta un codice QR su quattro numeri, e uno solo di essi viene dallo standard. I quattro moduli di zona di silenzio sono la cifra di ISO/IEC 18004; le fasce di contrasto, la linea di avviso sotto il margine e la soglia del modulo sono nostre, tracciate dove un codice smette di avere margine e non dove smette di funzionare. Tutte e quattro si possono verificare passando un file negli strumenti invece che credendoci sulla parola.

Due di queste portano un giudizio che vale la pena dire apertamente. A due o tre moduli di zona di silenzio avvisiamo invece di bocciare, perché è quello che lascia la maggior parte delle cornici decorative e quello che la maggior parte dei decodificatori legge ancora: è un codice senza margine, non un codice rotto. E giudichiamo il contrasto sul peggiore tra i moduli scuri e i pattern di rilevamento invece che su una media, perché uno scanner deve trovare i tre quadrati agli angoli prima di leggere qualsiasi cosa, e un codice con moduli scuri e pattern di rilevamento pallidi fallisce il rilevamento mentre la sua media continua a sembrare rispettabile.

Il generatore applica la stessa regola di contrasto dal vivo: il badge accanto all'anteprima prende la peggiore delle due coppie di colori e diventa verde a 4:1. Quella è la linea per lo schermo e non quella per la stampa, ed è voluto - un codice progettato per uno stampato dovrebbe essere a 7:1 prima di lasciare la pagina, e il verificatore di contrasto è dove si chiude la questione contro una palette di marca.

Cosa non fare quando un codice QR non si legge

L'errore più caro nella diagnosi è ristampare prima che il difetto abbia un nome. Una ristampa cambia più variabili insieme, quindi un codice che poi funziona non ti insegna niente, e uno che continua a fallire ha fatto pagare la tiratura due volte.