Comment utiliser le lecteur de codes-barres avec Fully ?

Utilisation d'un lecteur de codes-barres externe ou intégré

Les lecteurs de codes QR externes ou intégrés disposent généralement d'une application de contrôle comme Datawedge. Par défaut, le lecteur émule le clavier et peut saisir le code scanné dans les champs web. Toutefois, le champ web doit être activé et sélectionné. Le code doit être au format texte ; les valeurs binaires peuvent poser problème. Dans de nombreux cas, cette intégration est néanmoins suffisante.

Fully Kiosk propose différentes méthodes pour une meilleure intégration avec les applications de numérisation externes ou les lecteurs de codes QR matériels. Consultez Barcode Scanner Settings dans la Other Settings. Vous pouvez autoriser Fully Kiosk à :

• Listen to the broadcast intent (RECOMMANDÉ) : de nombreuses applications, comme Datawedge, peuvent envoyer une intention de diffusion lors de la lecture d'un code-barres. La procédure de Configuration peut varier légèrement selon la version de l'application de lecture externe, ce qui rend difficile une description précise. Consultez la documentation ou les paramètres de votre application pour trouver le nom Broadcast Action et le nom String Extra, puis saisissez ces noms dans les options correspondantes des paramètres Fully Kiosk afin d'écouter les diffusions.
  • Barcode Scan Broadcast Intent Action : action d'intention de diffusion de l'application de scan à écouter, vide si aucune. Sur les appareils utilisant l'application Datawedge, il peut s'agir d'une valeur définie par l'utilisateur ou d'une valeur comme com.datalogic.decodewedge.decode_action
  • Barcode Scan Broadcast String Extra : chaîne d'intention supplémentaire diffusée par le scanner pour rechercher le code scanné. Sur les appareils utilisant Datawedge, il peut s'agir de com.symbol.datawedge.data_string ou com.datalogic.decode.intentwedge.barcode_string

Si votre application de scanner le permet, laissez le champ vide.

• Listen to activity intent : certains lecteurs de codes-barres peuvent envoyer des intentions d'activité explicites lors de la lecture d'un code-barres. Utilisez de.ozerov.fully.action.barcode comme action et placez le code-barres dans le champ supplémentaire de chaîne d'intention code, ou spécifiez le nom du champ supplémentaire de chaîne dans l'option String Extra de Fully.
• Listen to keyboard input from scanner : cette fonction est utile avec de nombreux scanners matériels capables d'émuler les frappes au clavier lors de la lecture d'un code-barres (parfois appelée keyboard mode ou keystroke output). Consultez les paramètres de votre application de scanner. Cette option devrait permettre de détecter les entrées même sans champ web sélectionné ; cependant, son fonctionnement n'est pas fiable avec certaines applications et son utilisation est déconseillée.

Notez que les lecteurs de codes-barres peuvent être indisponibles si vous utilisez l'option Unlock Screen dans Fully Kiosk (activée par défaut) jusqu'à ce que vous déverrouilliez l'écran manuellement.

Consultez ci-dessous la procédure à suivre pour traiter le code-barres obtenu.

Utiliser l'appareil photo comme lecteur de codes-barres

Vous pouvez utiliser la caméra intégrée de l'appareil pour scanner les codes QR. Vous pouvez lancer le scanner de codes QR via l'interface JavaScript scanQrCode() ou le bouton de scan QR de la barre d'action.

L'API JS vous permet de spécifier le texte d'invite et l'URL cible, l'identifiant de la caméra, le délai d'attente, d'activer/désactiver le signal sonore et d'afficher/masquer le bouton Annuler dans l'interface utilisateur du lecteur de codes-barres grâce à la fonction scanQrCode(). N'oubliez pas d'activer l'option Enable QR Code Scanner dans Advanced Web Settings. Voici un exemple de code HTML pour déclencher la lecture du code-barres :

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

Traitement du code-barres résultant

Pour traiter le code-barres scanné depuis une application ou l'appareil photo, vous pouvez utiliser les options Barcode Scan Target URL, Insert Barcode Into Website et Submit Form after Inserting ». Consultez la section « Configuration » pour savoir comment utiliser ces options. Des événements API JS et MQTT seront également envoyés.

Masquer le clavier virtuel

Si votre site Web comporte un champ de saisie de code-barres, la vue Web affichera toujours le clavier virtuel (logiciel) par défaut.

Vous pouvez désactiver l'affichage du clavier virtuel en désactivant l'option Enable Text Input ou en activant l'option Always Hide Keyboard dans Advanced Web Settings. Cependant, cela rendra le clavier inutilisable sur tous les sites Web. Vous pouvez également utiliser une application comme Null Keyboard pour désactiver le clavier virtuel sur l'ensemble du système.

Vous pouvez désactiver le clavier pour certaines pages uniquement en utilisant l'interface JavaScript et l'option Inject JavaScript avec un code comme celui-ci :

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

Veuillez noter que la désactivation du clavier peut empêcher le fonctionnement du mode d'émulation de clavier (mode frappe) et de l'option Listen to Keyboard Input avec de nombreuses applications de numérisation. Nous vous recommandons d'utiliser le mode de diffusion pour transmettre le résultat de la numérisation, comme décrit précédemment.

Utilisation d'une application externe comme lecteur de codes-barres

Vous pouvez utiliser une autre application de lecture de codes-barres, comme ZXing Barcode Scanner, pour scanner les codes-barres et les récupérer sur le Web. L'application doit prendre en charge le schéma d'URL zxing:. Activez l'option Open URL Schemes in Other Apps dans Web Content Settings de Fully et utilisez ce code HTML pour créer un bouton de scan :

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

Une fois le code-barres scanné, l'application du scanner redirigera vers l'URL de retour spécifiée. Sélectionnez Fully Kiosk Browser pour que ce navigateur soit systématiquement utilisé pour gérer cette URL. Si vous utilisez un autre navigateur, vous devrez réinitialiser les paramètres par défaut de ce navigateur.