Funzionamento e modalità di input del Lettore di codici QR
Questo strumento consente di decodificare il contenuto di un codice QR partendo da un'immagine, direttamente all'interno del browser web. Il processo non richiede l'uso di applicazioni dedicate o lettori hardware esterni, rendendo immediata l'estrazione delle informazioni digitali memorizzate nei codici bidimensionali.
L'utente può fornire l'immagine da analizzare attraverso tre modalità di input:
- Caricamento di un file: Selezionando un'immagine memorizzata sul proprio dispositivo tramite il pulsante "Carichi una foto".
- Trascina e rilascia (Drag and drop): Rilasciando il file d'immagine direttamente nell'area contrassegnata dalla dicitura "o trascini l'immagine qui".
- Scatto in tempo reale: Utilizzando la fotocamera del proprio dispositivo tramite l'opzione "Scatti una foto" per acquisire direttamente il codice QR.
I formati di file d'immagine accettati per l'elaborazione sono JPG, PNG e WebP. Non sono invece supportate le foto in formato HEIC provenienti direttamente dalla galleria fotografica di un iPhone.
Gestione dei risultati e limitazioni tecniche
Una volta elaborata l'immagine, lo strumento mostra il testo o i dati estratti sotto la dicitura "Contenuto decodificato". L'interfaccia mette a disposizione due azioni principali per gestire il risultato ottenuto:
- Copia: Il pulsante "Copia" permette di salvare il testo decodificato negli appunti del dispositivo.
- Apri link: Se il contenuto decodificato corrisponde a un indirizzo web completo che utilizza il protocollo HTTP o HTTPS, compare il pulsante "Apri link".
Per motivi di sicurezza, quando si fa clic su "Apri link", l'indirizzo viene aperto in una nuova finestra del browser impostando gli attributi noopener,noreferrer. Questa configurazione impedisce alla pagina di destinazione di accedere alla finestra di origine e protegge la riservatezza dell'utente non trasmettendo l'indirizzo di provenienza (referrer).
Il sistema applica regole specifiche ed è soggetto ad alcune limitazioni tecniche durante la fase di decodifica:
- Risoluzione massima: Se il lato più lungo dell'immagine caricata supera i 2200px, l'immagine viene ridimensionata a una scala inferiore prima di avviare la decodifica.
- Codici multipli: Se all'interno della stessa foto sono presenti più codici QR, il sistema decodifica esclusivamente il primo che viene individuato.
- Nessun flusso video continuo: Lo strumento non effettua la scansione di video in tempo reale, ma analizza singole immagini statiche caricate o scattate.
- Nessuna esecuzione automatica: Il lettore non esegue istruzioni di pagamento, configurazioni di reti Wi-Fi, salvataggi di contatti in rubrica o avvii di applicazioni integrate nel codice, né verifica la firma o la sorgente del codice QR. Inoltre, non effettua alcun accesso preventivo all'URL contenuto nel codice.
- Annullamento: L'azione di cancellazione dell'input interrompe il processo di decodifica in corso, elimina l'URL di anteprima generato e nasconde i risultati visualizzati.
Messaggi di errore e diagnostica
Durante l'uso del lettore, il sistema può restituire messaggi specifici in base allo stato dell'operazione o a eventuali problemi riscontrati nel file fornito:
- Stato iniziale: All'avvio, l'interfaccia mostra il messaggio "Pronto. Carichi una foto o ne scatti una per decodificare il codice QR.".
- Fase di elaborazione: Durante l'analisi del file, compare la dicitura "Lettura della foto in corso...".
- Decodifica riuscita: Al completamento dell'operazione, viene mostrato il testo "Decodificato." insieme ai dati estratti.
- Codice non rilevato: Se l'algoritmo non individua alcuna matrice bidimensionale leggibile, viene mostrato l'errore "Nessun codice QR trovato in questa foto.".
- Formato non supportato: Se si tenta di caricare un file con estensione non idonea (come i file HEIC), il sistema mostra l'avviso "Questo tipo di immagine non è supportato. Utilizzi JPG, PNG o WebP.".
- Errore di lettura: Nel caso in cui il file sia danneggiato o il browser non riesca ad accedere ai dati dell'immagine, compare il messaggio "Impossibile leggere questa immagine.".
Elaborazione locale e tutela della privacy
La gestione dei dati avviene interamente all'interno del browser web dell'utente. La foto caricata o scattata e il contenuto testuale decodificato non vengono trasmessi a server esterni, rimanendo confinati nel dispositivo locale. L'intero processo di decodifica viene eseguito lato client e nessun dato viene caricato sui server di BroBroGo. Questo approccio garantisce che le informazioni sensibili contenute nei codici QR, come dati personali o indirizzi privati, non vengano esposte a transiti di rete non necessari o a memorizzazioni di terze parti.
Destinatari dello strumento
La decodifica di codici QR a partire da immagini statiche risponde alle esigenze di diverse categorie di utenti:
- Sviluppatori: Che hanno la necessità di verificare rapidamente la correttezza dei dati codificati all'interno di codici QR generati durante la fase di test di software o servizi.
- Personale operativo e addetti al servizio clienti: Che ricevono screenshot, foto di etichette o documenti digitalizzati inviati dagli utenti e devono estrarne il contenuto informativo senza dover utilizzare un dispositivo fisico separato per inquadrare lo schermo.
- Utenti privati: Chiunque riceva un codice QR tramite sistemi di messaggistica, email o lo trovi all'interno di una pagina web e desideri leggerne il contenuto direttamente dal proprio computer o smartphone senza dover ricorrere a un secondo telefono per la scansione.
Domande frequenti
La mia foto viene caricata su qualche server?
No. La decodifica avviene interamente sul suo dispositivo: la foto non lascia mai il browser.
Perché non è stato possibile trovare alcun codice QR nella mia foto?
Di solito la causa è la sfocatura, il riflesso della luce, un'angolazione troppo accentuata o un codice che occupa solo una minima parte dell'inquadratura. Provi a scattare una foto più ravvicinata, nitida e ben illuminata. Se l'immagine contiene più codici QR, verrà decodificato solo il primo rilevato.
Perché la foto del mio iPhone non funziona?
Le foto in formato HEIC provenienti direttamente dalla galleria dell'iPhone non sono ancora supportate. Può convertirle preventivamente con il nostro strumento di conversione da HEIC a JPG, oppure utilizzare l'opzione di acquisizione fotocamera integrata qui, che salva direttamente in formato JPG.