Scansione di codici a barre
Grazie al machine learning, la fotocamera di un dispositivo può leggere in tempo reale i dati codificati nella maggior parte dei formati standard di codici a barre.

Utilizzo
I codici a barre rappresentano un modo semplice e pratico per trasferire al dispositivo dati complessi o strutturati presenti nel mondo reale. L'API di scansione dei codici a barre di ML Kit consente alla tua app di leggere la maggior parte dei formati standard senza che gli utenti debbano passare a un'app dedicata alla scansione.
La scansione di codici a barre può supportare gli utenti in attività semplici di identificazione e consultazione dei contenuti, ad esempio cercare un prodotto da acquistare, accedere ai dettagli di un evento o compilare un modulo.
Queste linee guida di progettazione riguardano la scansione di codici a barre tramite il flusso video live della fotocamera.
Guide per sviluppatori sulla scansione di codici a barre
Link correlato
Esempio – AndroidApp dimostrativa di ML Kit per Android
Link correlato
Principi
La progettazione di questa funzionalità si basa sui seguenti principi:
Navigazione con la fotocamera del dispositivo
Invece di digitare un termine di ricerca, l'utente utilizza la fotocamera del dispositivo come “telecomando” per scansionare i codici a barre.
Per spiegare agli utenti come scansionare i codici a barre con la fotocamera, fornisci una guida iniziale e istruzioni sempre visibili.
Mantieni libera e leggibile l'inquadratura della fotocamera
Allinea i componenti dell'interfaccia utente della fotocamera ai bordi superiore e inferiore dello schermo, in modo che testo e icone restino leggibili quando sono sovrapposti all'immagine.
Tutti gli elementi non attivabili sovrapposti al flusso video live della fotocamera dovrebbero essere traslucidi, per ridurre al minimo l'ostruzione della visuale.

Fornisci feedback
L'uso della fotocamera per scansionare codici a barre introduce requisiti d'uso specifici. La qualità dell'immagine deve essere adeguata e gli utenti devono sapere come correggere i problemi di acquisizione dell'immagine causati dall'illuminazione o da una distanza eccessiva dal codice a barre.
Gli stati di errore dovrebbero essere comunicati attraverso molteplici segnali di design (come componenti e animazioni) e includere indicazioni su come gli utenti possono migliorare la scansione.

Componenti
La scansione di codici a barre tramite il flusso video live della fotocamera utilizza componenti Material Design esistenti, oltre a nuovi elementi specifici per l'interazione con la fotocamera. Per esempi di codice e demo dei nuovi elementi (come il frame del codice a barre), consulta il codice sorgente dell'app dimostrativa di ML Kit Material Design per Android.

1. Barra dell’applicazione superiore
2. Frame del codice a barre
3. Tooltip
4. Bottom sheet modale

Barra dell’applicazione superiore
La barra dell’applicazione superiore fornisce sempre l'accesso alle seguenti azioni:
- Un pulsante per uscire dall'esperienza di ricerca
- Un interruttore per aumentare la luminosità (utilizzando il flash della fotocamera)
- Una sezione di assistenza per la risoluzione dei problemi di ricerca

Da fare
Frame del codice a barre
Il frame del codice a barre è un'area al centro dello schermo in cui l'utente può scansionare un codice a barre. Per impostazione predefinita, il frame è quadrato, ma la tua app dovrebbe adattarne dimensioni e proporzioni ai tipi di codici a barre supportati.
Svolge tre funzioni:
- Conferma: la forma del frame corrisponde alle dimensioni di un singolo codice a barre, per indicare chiaramente che è possibile scansionarne uno solo alla volta.
- Leggibilità: mentre i formati semplici possono essere letti a distanza, i formati complessi (come PDF417) richiedono un'immagine più ravvicinata e di qualità superiore per una lettura accurata. Un bordo parziale sul frame del codice a barre segnala all'utente che occorre avvicinarsi per completare la scansione.
- Attività: durante la fase di “rilevamento”, il bordo del frame pulsa per indicare che l'app sta cercando codici a barre da scansionare.
1. Durante il rilevamento, un'animazione pulsante indica che l'app sta cercando codici a barre da scansionare
2. Un bordo parziale sul frame (insieme a un tooltip) indica che l'utente deve avvicinarsi a un codice a barre
3. Durante la ricerca, un indicatore di avanzamento indeterminato attraversa il frame del codice a barre
4. In caso di errore, il bordo continuo del frame del codice a barre diventa tratteggiato
Tooltip
I tooltip mostrano agli utenti testo informativo. Ad esempio, comunicano sia lo stato corrente (“Ricerca in corso…”) sia un invito al passaggio successivo (“Inquadra un codice a barre con la fotocamera”).

Da fare

Da non fare

Da non fare
Bottom sheet modale
I bottom sheet modali consentono di accedere alle informazioni di un codice a barre senza che l'utente esca dalla funzionalità di scansione. Il layout e il contenuto del bottom sheet dipendono dal tipo di dati restituiti dalla scansione, ad esempio:
- I dati strutturati (come le informazioni di contatto) possono essere mostrati in campi di testo, per consultarli e modificarli
- Le informazioni provenienti da un database devono essere mostrate con uno stile adatto al contenuto: i tipi di contenuto variano e, ad esempio, un contenuto dei social media ha una struttura diversa rispetto a quello di un prodotto commerciale
Visualizzazione dei risultati
Se per l'utente è più rapido o semplice completare l'attività su un'altra schermata dell'app, mostra le informazioni del codice a barre su quella schermata invece che in un bottom sheet modale. Consulta la sezione Esperienza per ulteriori informazioni su quando e dove comunicare le informazioni del codice a barre all'interno dell'app.


Esperienza
La scansione di codici a barre tramite il flusso video live della fotocamera avviene in tre fasi:
- Rilevamento: usa la fotocamera per cercare i dati da leggere
- Riconoscimento: identifica un codice a barre
- Comunicazione: mostra i risultati del codice a barre direttamente durante la scansione o su una schermata separata dell'app
Rilevamento
“Rilevamento” si riferisce alla fase in cui la fotocamera cerca codici a barre nel flusso video live. La scansione di codici a barre inizia quando l'utente apre la funzionalità di scansione dei codici a barre in un'app.
Durante questa fase, l'app dovrebbe:
- Descrivere il funzionamento della funzionalità
- Comunicare le azioni dell'app
- Guidare l'utente nelle regolazioni del controllo della fotocamera
Da fare
Da fare
Guida alle regolazioni
Le condizioni ambientali possono rendere difficile la scansione di un codice a barre, ad esempio in luoghi troppo luminosi o troppo bui.

Riconoscimento
Quando la fotocamera ha rilevato un codice a barre, l'app dovrebbe:
- Mettere in pausa la fotocamera e leggere il valore del codice a barre
- Mostrare immediatamente il valore se si tratta di dati strutturati
- Avviare la ricerca e mostrare l'avanzamento della ricerca se il valore del codice a barre deve essere cercato
In questa fase, un codice a barre viene rilevato dalla fotocamera e letto dall'API di scansione dei codici a barre. Il flusso video della fotocamera va in pausa per impedire la scansione di un altro codice a barre.
I codici a barre contenenti dati strutturati riconosciuti dall'API (come coordinate geografiche ed eventi del calendario) possono essere presentati immediatamente all'utente. Se i dati di un codice a barre non sono strutturati, le informazioni dettagliate vengono recuperate da un database. L'app mostra uno stato di caricamento durante il recupero di queste informazioni.
Da fare
Da fare
Effettuare correzioni
Il rilevamento di un codice a barre non garantisce che la tua app troverà dei risultati. Potrebbero verificarsi i seguenti problemi:
- Nessun risultato pertinente: un codice a barre che viene scansionato correttamente potrebbe non contenere informazioni pertinenti per la tua app o per il tuo caso d'uso, ad esempio quando si scansiona un codice a barre proveniente da una fonte non correlata.
- Connessione di rete persa: se il valore del codice a barre viene cercato in un database online, la richiesta di dati può non riuscire in assenza di una connessione a internet.
- Dimensioni ridotte del codice a barre: mentre i formati semplici possono essere letti a distanza, i formati complessi (come PDF417) richiedono un'immagine più ravvicinata e di qualità superiore per poter essere letti. Per indicare che l'utente deve avvicinarsi al codice a barre prima di poterlo scansionare, imposta una dimensione minima di scansione per i formati di codici a barre accettati dalla tua app e usa molteplici segnali di design (ad esempio nel frame del codice a barre e nel tooltip).

Da fare
Da fare
Comunicazione
I risultati della scansione di un codice a barre possono essere mostrati in diversi modi:
- Davanti alla fotocamera (in un bottom sheet modale o in una finestra di dialogo)
- All'uscita dalla funzionalità di scansione dei codici a barre, nella schermata in cui le informazioni del codice a barre possono essere utilizzate
Per adattare l'interfaccia utente al tuo caso d'uso dei codici a barre, si consigliano i seguenti pattern di navigazione e componenti:
| Esempio di caso d'uso | Rimanere nello scanner di codici a barre? | Posizione di visualizzazione dei risultati |
|---|---|---|
| Sfogliare i prodotti in un negozio | Sì | Bottom sheet modale |
| Aggiungere un contatto | Sì, finché l'utente non lo salva | Bottom sheet modale o finestra di dialogo a schermo intero |
| Completare un modulo | No, tornare al modulo | Compilare per l'utente i campi pertinenti del modulo |
Da fare
Da fare
Da fare
Temi
Tema Material di Shrine
La scansione di codici a barre è utilizzata nel flusso di acquisto dell'app Shrine.


Frame del codice a barre
Il frame del codice a barre di Shrine usa il suo colore On Primary per lo scrim. Il bordo del frame ha angoli netti che esprimono la forma geometrica del logo del brand.

2. Il frame del codice a barre di Shrine usa Shrine Pink 900 (#442C2E) come colore dello scrim con un bordo del frame netto.
Tooltip
Il tooltip di Shrine è messo in risalto tramite l'uso di colori, tipografia e posizionamento personalizzati.

2. Il tooltip di Shrine usa colori e tipografia personalizzati ed estende il proprio contenitore fino ai bordi dello schermo.