Crea un codice QR per Wi-Fi, contatti o link e controllalo prima di stamparlo

Statico: una scelta, non una limitazione

Esistono due tipi di codici QR e la differenza non è solo estetica. Un codice statico contiene direttamente ciò che rappresenta: l'URL, il record Wi-Fi, il contatto. Un codice dinamico contiene un link breve appartenente a un servizio, che reindirizza alla destinazione indicata in quel momento dal servizio.

I codici dinamici offrono due funzioni — la destinazione può essere cambiata dopo la stampa e ogni scansione può essere conteggiata — ma hanno un costo che raramente viene esplicitato nella pagina che li vende. Ogni scansione passa ora da una terza parte, che la vede e decide se il codice continuerà a funzionare. Quando quel servizio cambia i prezzi, dismette un prodotto o chiude, l'adesivo sulla vetrina smette di funzionare e non c'è nulla da fare. È successo ripetutamente e su larga scala.

Un codice generato qui è completo nel momento in cui lo scarichi. Non ci sono redirect, contatori, account o relazioni: appvau.lt non interviene in una singola scansione. Ciò che può comunque smettere di funzionare è quello a cui punta il codice: un link può restituire 404, una password può essere cambiata, un numero di telefono può essere riassegnato. Nessun generatore, indipendentemente dal tipo di codice, può aiutare in questi casi.

Perché il contenuto viene mostrato prima della codifica

Un simbolo QR è opaco per chi lo ha creato. Non puoi guardare il disegno e vedere che all'URL manca lo schema, che l'SSID contiene uno spazio finale copiato da un'etichetta o che al numero di telefono manca il prefisso internazionale. Il problema viene sempre scoperto dopo, da qualcuno che tiene un telefono davanti a qualcosa già stampato.

Per questo lo strumento mostra prima la stringa canonica esatta, quella che entra nel simbolo nel formato interpretato da uno scanner. Un record Wi-Fi per una rete guest è simile a questo:

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

Questo formato non è una convenzione inventata da questo sito: è il record che iOS legge dalla versione 11 e Android dalla 10. Vederlo è l'unico momento in cui una persona può accorgersi di un errore, perciò è un passaggio, non un dettaglio nascosto dietro un'opzione avanzata.

È nello stesso passaggio che compaiono gli avvisi. Un record Wi-Fi ne attiva sempre uno, perché la password è dentro il simbolo in chiaro e una fotografia del codice scattata dall'altra parte della stanza è sufficiente per recuperarla. Anche un numero di telefono senza prefisso internazionale attiva un avviso. Lo stesso vale per un indirizzo senza schema, che viene corretto davanti a te invece di essere modificato in silenzio.

La verifica e ciò che dimostra e non dimostra

Dopo la codifica, lo strumento genera il PNG, rasterizza l'SVG e li rilegge entrambi con un decoder che non sa nulla del codificatore che li ha prodotti. Individua il simbolo come farebbe una fotocamera — trasformando l'immagine in bianco e nero tramite soglia, trovando l'inchiostro, misurando il passo dei moduli dal pattern di ricerca — legge le informazioni sul formato, annulla la maschera, deinterlaccia i blocchi di dati, quindi ricalcola le parole di codice per la correzione degli errori Reed-Solomon dai dati recuperati e richiede che siano identiche a livello di byte a quelle presenti nel simbolo.

Quest'ultimo passaggio è più rigoroso di «la decodifica è riuscita». Dice che la ridondanza è corretta quanto i dati, così un lettore che lavora su una copia graffiata o parzialmente coperta conserva il margine promesso dal livello scelto. Il download si sblocca solo se entrambi i file superano il controllo.

Dimostra che i file sono corretti. Non dimostra che la tua fotocamera, alla dimensione di stampa scelta, sulla tua superficie e con la tua illuminazione, riuscirà a leggerli. Nulla da questa parte può stabilirlo, e l'indicazione corretta è quella di sempre: stampalo alla dimensione reale e scansionalo con il telefono per cui è destinato, prima di ordinarne cinquecento.

Il controllo è utile per un motivo che vale la pena dichiarare. Durante la creazione dello strumento è stato trovato un errore nella tabella dei blocchi per la correzione degli errori al livello H, che avrebbe prodotto simboli strutturalmente validi ma completamente indecifrabili con l'impostazione di massima ridondanza. Nell'immagine non ci sarebbe stato nulla di evidentemente sbagliato. Il decoder lo ha trovato al primo test.

La correzione degli errori non autorizza a coprire il centro

Ogni simbolo QR contiene parole di codice ridondanti, così un lettore danneggiato può comunque recuperare i dati. I quattro livelli recuperano approssimativamente ~7% a L, ~15% a M, ~25% a Q, ~30% a H.

Sono queste percentuali a spingere i designer a mettere loghi al centro dei codici, ed è una cattiva abitudine presentata come una funzione. La ridondanza serve a sopravvivere ai danni che si verificano dopo la stampa: graffi, pieghe, macchie di caffè, poca luce. Consumandola in anticipo per la decorazione, il codice inizia senza margine, proprio quando il margine serve di più, cioè per i codici che vengono maneggiati.

Un livello più alto rende inoltre il simbolo più denso a parità di contenuto, perché la ridondanza deve essere inserita da qualche parte. Un simbolo di versione 1 contiene 17 byte al livello L e 7 al livello H: la stessa griglia di 21-by-21 moduli, con meno della metà del contenuto. Più densità significa una stampa fisica più grande per mantenere la leggibilità, quindi «usa H per sicurezza» produce spesso un codice che viene scansionato peggio.

Il livello M è l'impostazione predefinita corretta. Passa a Q o H quando il codice verrà stampato piccolo, su una superficie curva o in un punto che verrà toccato.

L'intera tabella è pubblicata come JSON in qr.json, per ogni versione da 1 a 40, insieme alle capacità numeriche e alfanumeriche e ai formati del contenuto con esempi svolti. Viene generata invece di essere scritta a mano per un motivo che vale la pena ripetere: riportare una seconda volta la struttura dei blocchi è esattamente il modo in cui un numero errato sopravvive.

PNG o SVG, e perché il passo dei pixel è importante

Entrambi vengono prodotti, entrambi sono gratuiti e nessuno dei due contiene una filigrana. Scegli l'SVG per tutto ciò che deve essere stampato o inserito in un file di progetto: è un vettore con un view box intero e un solo tracciato, quindi si adatta da un biglietto da visita a un poster senza sfocarsi e si apre correttamente in Illustrator, Figma, Inkscape e nei software di impaginazione. Scegli il PNG per un documento, una diapositiva, un messaggio o una pagina web, dove un raster fisso è più semplice da posizionare.

La dimensione del PNG viene arrotondata per difetto, così ogni modulo corrisponde a un numero intero di pixel. Sembra una pignoleria, ma non lo è: un simbolo di 29 moduli renderizzato in esattamente 500 pixel produce 17.24 pixel per modulo, e quel quarto di pixel residuo diventa un bordo grigio lungo ogni confine tra i moduli. Le fotocamere riescono a gestirlo nella maggior parte dei casi, il che è peggio del non riuscirci mai, perché fallisce proprio sulla stampa che contava.

La quiet zone di quattro moduli attorno al simbolo fa parte del simbolo, non è un margine. È un requisito della norma ISO/IEC 18004 e il motivo più comune per cui un codice ritagliato a mano non viene scansionato. Non tagliarla, non posizionare il codice a filo di un blocco colorato e non lasciare che uno strumento di impaginazione lo ritagli fino ai bordi dell'inchiostro.

Codifica, set di caratteri e la questione ECI

Il codificatore sceglie la modalità più compatta consentita dal contenuto: numerica per le cifre, alfanumerica per il set ristretto di maiuscole e byte per tutto il resto. Prima della generazione viene mostrata, per ogni livello, una tabella della capacità del simbolo scelto.

Quando il contenuto contiene caratteri non ASCII — un nome di rete accentato, un nome in cirillico o in giapponese — il codificatore scrive un'intestazione ECI che dichiara UTF-8. È la dichiarazione corretta, ma è anche l'elemento che gli scanner più vecchi gestiscono con maggiore probabilità in modo errato, quindi viene aggiunta solo quando i byte ne hanno effettivamente bisogno e la ricevuta indica quando è presente. Un contenuto composto interamente da ASCII non contiene intestazione ECI e si comporta allo stesso modo in ogni lettore mai costruito.

Nulla in questa pagina raggiunge la rete. Il codificatore, il renderer e il decoder che controlla il risultato sono tutti JavaScript in esecuzione in questa scheda, e i moduli sotto /js/tools/ non contengono alcun codice che effettui richieste. Disconnettiti dopo aver caricato la pagina e ogni sua parte continuerà a funzionare: per uno strumento a cui stai per affidare la password Wi-Fi, questa è una proprietà da verificare, non da accettare sulla parola.