Come posso utilizzare lo scanner di codici a barre con Fully?

Utilizzo di uno scanner di codici a barre hardware esterno o integrato

Gli scanner di codici QR esterni o integrati solitamente dispongono di un'app di controllo come Datawedge. Per impostazione predefinita, lo scanner emula la tastiera e può inserire il codice scansionato nei campi web. Tuttavia, il campo web deve essere abilitato e selezionato affinché ciò avvenga. Il codice deve essere testuale; i valori binari causeranno problemi. In molti casi, tuttavia, questa integrazione può essere sufficiente.

Fully Kiosk supporta diversi modi per una migliore integrazione con app di scansione esterne o scanner QR hardware. Controlla Barcode Scanner Settings in Other Settings. Puoi lasciare che Fully Kiosk:

• Listen to the broadcast intent (CONSIGLIATO) – molte app come Datawedge possono inviare un intent broadcast quando viene scansionato il codice a barre. È difficile fornire istruzioni precise per la Configuration poiché l'app dello scanner esterno può variare leggermente a seconda della versione. Consulta la documentazione dell'app dello scanner o le impostazioni dell'app per trovare il nome Broadcast Action e il nome String Extra e inserisci questi nomi nelle relative opzioni in Impostazioni Fully Kiosk per poter ascoltare i broadcast.
  • Barcode Scan Broadcast Intent Action: azione di trasmissione dell'intento dall'app dello scanner da ascoltare, vuoto se non presente. Nei dispositivi che utilizzano l'app Datawedge, può essere un'azione definita dall'utente o qualcosa come com.datalogic.decodewedge.decode_action
  • Barcode Scan Broadcast String Extra: stringa di intent broadcast extra dallo scanner per cercare il codice scansionato. Nei dispositivi che utilizzano Datawedge, questo può essere qualcosa come com.symbol.datawedge.data_string o com.datalogic.decode.intentwedge.barcode_string

Se è possibile specificare la categoria di intenti nell'app dello scanner, lasciala vuota.

• Listen to activity intent: alcuni scanner di codici a barre possono inviare intenti di attività espliciti quando viene scansionato un codice a barre. Usa de.ozerov.fully.action.barcode come azione e inserisci il codice a barre nell'Intent String Extra code oppure specifica il nome dell'Extra String nell'opzione String Extra di Fully.
• Listen to keyboard input from scanner: utile con molti scanner hardware in grado di emulare la pressione dei tasti durante la scansione di un codice a barre (a volte chiamata keyboard mode o keystroke output). Controlla le impostazioni dell'app dello scanner. Questa opzione dovrebbe catturare l'input anche senza un campo web attivo, tuttavia non funziona in modo affidabile con alcune app di scanner e non è consigliata.

Tieni presente che i lettori di codici a barre potrebbero non essere disponibili se utilizzi l'opzione Unlock Screen in Fully Kiosk (abilitata per impostazione predefinita) finché non sblocchi lo schermo manualmente.

Di seguito sono riportate le istruzioni per gestire il codice a barre risultante.

Utilizzo della fotocamera del dispositivo come scanner di codici a barre

È possibile utilizzare la fotocamera integrata del dispositivo per la scansione dei codici QR. È possibile avviare lo scanner di codici QR tramite l'interfaccia JavaScript scanQrCode() o il pulsante di scansione QR nella barra delle azioni.

Tramite l'API JS è possibile specificare il testo del prompt e l'URL di destinazione, l'ID della fotocamera, il timeout, abilitare/disabilitare il segnale acustico e mostrare/nascondere il pulsante Annulla nell'interfaccia utente del lettore di codici a barre utilizzando la funzione scanQrCode(). Non dimenticare di abilitare l'opzione " Enable QR Code Scanner nelle Advanced Web Settings. Ecco un esempio di codice HTML per attivare la scansione del codice a barre:

<a href="javascript:fully.scanQrCode('Nice prompt text', 'https://domain.com/target/url/$code', -1, 60, true, true);">SCAN</a>

Gestione del codice a barre risultante

Per gestire il codice a barre scansionato da un'app per codici a barre o dalla fotocamera del dispositivo, è possibile utilizzare le opzioni Barcode Scan Target URL, " Insert Barcode Into Website e Submit Form after Inserting. Consultare la sezione "Configurazione" per informazioni su come utilizzare queste opzioni. Verranno inoltre inviati eventi tramite API JS e MQTT.

Nascondere la tastiera virtuale

Se il tuo sito web dispone di un campo dedicato all'inserimento di codici a barre, la Webview mostrerà sempre la tastiera virtuale (soft) per impostazione predefinita.

È possibile disabilitare la visualizzazione della tastiera virtuale disattivando l'opzione Enable Text Input o attivando l'opzione Always Hide Keyboard nelle Advanced Web Settings. Tuttavia, in questo modo la tastiera risulterà inutilizzabile su tutti i siti Web. In alternativa, è possibile utilizzare un'app come Null Keyboard per disattivare la tastiera virtuale a livello di sistema.

È possibile disabilitare la tastiera solo per determinate pagine utilizzando l'interfaccia JavaScript e l'opzione Inject JavaScript con un codice simile a questo:

if (location.href=="https://url_of_barcode_scan_page")
  fully.setBooleanSetting("softKeyboard", false);
else
  fully.setBooleanSetting("softKeyboard", true);

Tieni presente che la disattivazione della tastiera potrebbe impedire il funzionamento della modalità di emulazione tastiera (modalità di pressione dei tasti) e dell'opzione Listen to Keyboard Input con molte app per scanner. Si consiglia di utilizzare la modalità broadcast per trasmettere il risultato della scansione come descritto sopra.

Utilizzo di un'app esterna come scanner di codici a barre

È possibile utilizzare un'app diversa per la scansione di codici a barre, come ZXing Barcode Scanner, per ottenere i codici da inviare via web. L'app deve supportare lo schema URL zxing:. Abilita l'opzione " Open URL Schemes in Other Apps nelle Web Content Settings di Fully e utilizza questo codice HTML per creare un pulsante di scansione:

<a href="zxing://scan/?ret=http://mydomain.com/path/to/page.html?item={CODE}">Scan Barcode</a>

Dopo la scansione del codice a barre, l'app dello scanner accederà all'URL specificato. Quando richiesto, seleziona Fully Kiosk Browser per impostare Fully Kiosk Browser come browser predefinito per gestire questo URL. Se per accedere a questo URL viene aperto un altro browser, è necessario reimpostare le preferenze predefinite nelle impostazioni di tale browser.