¿Cómo puedo utilizar el lector de códigos de barras con Fully?

Uso de un lector de códigos de barras externo o integrado

Los lectores de códigos QR externos o integrados suelen contar con una aplicación de control como Datawedge. Por defecto, el lector suele emular el teclado y puede introducir el código escaneado en los campos web. No obstante, para ello es necesario que el campo web esté habilitado y tenga el foco. El código debe ser de tipo textual; los valores binarios provocarán problemas. Sin embargo, en muchos casos esta integración podría resultar suficiente.

Fully Kiosk admite diferentes métodos para lograr una mejor integración con aplicaciones de escáner externas o escáneres de códigos QR físicos. Consulte la sección Barcode Scanner Settings (Configuración del escáner de códigos de barras) en Other Settings (Otras configuraciones). Puede hacer que Fully Kiosk:

• Preste atención a la intención de difusión (RECOMENDADO): muchas aplicaciones, como Datawedge, pueden enviar una intención de difusión al escanear el código de barras. Resulta difícil indicar los pasos exactos para la eConfiguration, ya que la aplicación del escáner externo puede variar ligeramente en función de su versión. Consulte la documentación de su aplicación de escáner o busque en la configuración de la aplicación el nombre de la Broadcast Action y el de la String Extra, e introduzca dichos nombres en las opciones correspondientes de la configuración de Fully Kiosk para poder recibir las transmisiones.
  • Barcode Scan Broadcast Intent Action: acción de intención de difusión desde la aplicación de escáner para estar a la escucha; se deja en blanco si no hay ninguna. En los dispositivos que utilizan la aplicación Datawedge, puede tratarse de algo definido por el usuario o de algo similar a com.datalogic.decodewedge.decode_action
  • Barcode Scan Broadcast String Extra: parámetro adicional de la cadena de intención de difusión que el escáner utiliza para buscar el código escaneado. En los dispositivos que utilizan Datawedge, puede ser algo así como com.symbol.datawedge.data_string o com.datalogic.decode.intentwedge.barcode_string

Si puede especificar la categoría de intención en su aplicación de escáner, déjela en blanco.

• Preste atención a la intención de actividad: algunos escáneres de códigos de barras pueden enviar intenciones de actividad explícitas cuando se escanea un código de barras. Utilice de.ozerov.fully.action.barcode como acción e introduzca el código de barras en el extra de cadena de la intención code, o bien especifique el nombre del extra de cadena en la opción String Extra de Fully.
• Escuche la entrada del teclado procedente del escáner: resulta útil con muchos escáneres físicos que pueden emular pulsaciones de teclas al escanear un código de barras (lo que a veces se denomina keyboard mode o keystroke output). Consulte la configuración de su aplicación de escáner. Esta opción debería captar la entrada incluso sin que haya ningún campo web seleccionado; sin embargo, no funciona de forma fiable con algunas aplicaciones de escáner y no se recomienda su uso.

Tenga en cuenta que es posible que los lectores de códigos de barras no estén disponibles si utiliza la opción Unlock Screen en el modo Fully Kiosk (activada por defecto) hasta que desbloquee la pantalla manualmente.

Consulte a continuación cómo gestionar el código de barras resultante.

Utilización de la cámara del dispositivo como lector de códigos de barras

Puede utilizar la cámara integrada del dispositivo para escanear códigos QR. Puede iniciar el escáner de códigos QR mediante la interfaz de JavaScript scanQrCode() o el botón de escaneo de códigos QR de la barra de acciones.

Con la API de JS, puede especificar el texto del mensaje y la URL de destino, el ID de la cámara, el tiempo de espera, activar o desactivar el pitido y mostrar u ocultar el botón de cancelación en la interfaz de usuario del lector de códigos de barras mediante la función scanQrCode(). No olvide activar la opción Enable QR Code Scanner en Advanced Web Settings. El código HTML de ejemplo para activar el escaneo de códigos de barras:

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

Gestión del código de barras resultante

Para gestionar el código de barras escaneado desde una aplicación de códigos de barras o la cámara del dispositivo, puede utilizar las opciones Barcode Scan Target URL, Insert Barcode Into Website**** y Submit Form after Inserting. Consulte la sección de configuración para saber cómo utilizar estas opciones. Asimismo, se enviarán eventos de la API de JS y de MQTT.

Ocultar el teclado virtual

Si su sitio web cuenta con un campo específico para introducir códigos de barras, Webview mostrará siempre el teclado virtual (soft) de forma predeterminada.

Puede desactivar la aparición del teclado virtual desmarcando la opción Enable Text Input (Habilitar introducción de texto) o activando la opción Always Hide Keyboard (Ocultar siempre el teclado) en Advanced Web Settings (Configuración web avanzada). Sin embargo, esto hará que el teclado no se pueda utilizar en ningún sitio web. O bien, puede utilizar una aplicación como Null Keyboard para desactivar el teclado virtual en todo el sistema.

Puede desactivar el teclado únicamente en las páginas seleccionadas utilizando la interfaz Fully JavaScript y la opción Inject JavaScript con un código como este:

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

Tenga en cuenta que, si desactiva el teclado, es posible que el modo de emulación del teclado (modo de pulsación de teclas) y la opción Escuchar la entrada del teclado dejen de funcionar con muchas aplicaciones de escáner. Le recomendamos que utilice el modo de difusión para transmitir el resultado del escaneo, tal y como se ha descrito anteriormente.

Utilización de una aplicación externa como lector de códigos de barras

Puede utilizar otra aplicación de códigos de barras, como ZXing Barcode Scanner, para escanear códigos de barras y enviar los códigos a la web. La aplicación debe ser compatible con el esquema de URL zxing:. Active la opción Open URL Schemes in Other Apps (Abrir esquemas de URL en otras aplicaciones) en la configuración de contenido web (Web Content Settings) de Fully y utilice este código HTML para crear un botón de escaneo:

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

Una vez escaneado el código de barras, la aplicación de escáner le redirigirá a la URL de retorno especificada. Seleccione Fully Kiosk Browser para que sea siempre el navegador que gestione esta URL cuando se le solicite. Si se abre otra aplicación de navegador para dicha URL, deberá borrar los ajustes predeterminados en la configuración de esa aplicación de navegador.