Wie kann ich den Barcode-Scanner mit Fully verwenden?

Verwendung eines externen oder integrierten Hardware-Barcodescanners

Externe oder integrierte QR-Code-Scanner verfügen in der Regel über eine Steuerungs-App wie Datawedge. Standardmäßig emuliert der Scanner die Tastatur und kann den gescannten Code in die Webfelder eingeben. Dazu muss das Webfeld jedoch aktiviert und im Fokus stehen. Der Code muss aus Text bestehen; binäre Werte führen zu Problemen. In vielen Fällen könnte dies jedoch eine ausreichende Integration darstellen.

Fully Kiosk unterstützt verschiedene Möglichkeiten für eine bessere Integration mit externen Scanner-Apps oder QR-Hardware-Scannern. Sehen Sie sich die Barcode Scanner Settings unter Other Settings an. Sie können Fully Kiosk folgende Funktionen zuweisen:

• Achten Sie auf den Broadcast-Intent (EMPFOHLEN) – viele Apps wie Datawedge können beim Scannen des Barcodes einen Broadcast-Intent senden. Es ist schwierig, genaue Schritte für die Configuration anzugeben, da sich die externe Scanner-App je nach Version geringfügig unterscheiden kann. Schauen Sie in der Dokumentation Ihrer Scanner-App oder in den App-Einstellungen nach dem Namen der Broadcast Action und dem Namen des String Extra und tragen Sie diese Namen in die entsprechenden Optionen unter Fully Kiosk-Einstellungen ein, um die Broadcasts zu empfangen.
  • Barcode Scan Broadcast Intent Action – Broadcast-Intent-Aktion, auf die die Scanner-App achten soll; wird bei Nichtvorhandensein geleert. Bei Geräten, die die Datawedge-App verwenden, kann dies eine benutzerdefinierte Aktion oder beispielsweise com.datalogic.decodewedge.decode_action sein.
  • Barcode Scan Broadcast String Extra – Zusätzliche Zeichenfolge für die Übertragungsabsicht, die vom Scanner gesendet wird, um den gescannten Code zu identifizieren. Bei Geräten, die Datawedge verwenden, kann dies beispielsweise com.symbol.datawedge.data_string oder com.datalogic.decode.intentwedge.barcode_string lauten.

Falls Sie in Ihrer Scanner-App die Intent-Kategorie angeben können, lassen Sie das Feld bitte leer.

• Beachten Sie den Aktivitäts-Intent – einige Barcode-Scanner können beim Scannen eines Barcodes explizite Aktivitäts-Intents senden. Verwenden Sie de.ozerov.fully.action.barcode als Aktion und fügen Sie den Barcode in das String-Extra code des Intents ein, oder geben Sie den String-Extra-Namen in der Option String Extra von Fully an.
• Tastatureingaben vom Scanner abhören – nützlich bei vielen Hardware-Scannern, die beim Scannen eines Barcodes Tastatureingaben emulieren können (manchmal auch als keyboard mode oder keystroke output bezeichnet). Sehen Sie in den Einstellungen Ihrer Scanner-App nach. Diese Option sollte die Eingabe auch ohne fokussiertes Webfeld erfassen; bei einigen Scanner-Apps funktioniert sie jedoch nicht zuverlässig und wird daher nicht empfohlen.

Bitte beachten Sie, dass die Barcode-Lesegeräte möglicherweise nicht verfügbar sind, wenn Sie in Fully Kiosk die Option Unlock Screen verwenden (standardmäßig aktiviert), bis Sie den Bildschirm manuell entsperren.

Nachstehend erfahren Sie, wie Sie mit dem erzeugten Barcode verfahren.

Die Kamera des Geräts als Barcode-Scanner verwenden

Sie können die integrierte Kamera des Geräts zum Scannen von QR-Codes verwenden. Sie können den QR-Scanner über die JavaScript-Schnittstelle scanQrCode() oder über die Schaltfläche QR-Scan in der Aktionsleiste starten.

Mit der JS-API können Sie mithilfe der Funktion scanQrCode() den Eingabeaufforderungstext und die Ziel-URL, die Kamera-ID sowie das Zeitlimit festlegen, den Signalton aktivieren bzw. deaktivieren und die Schaltfläche Abbrechen in der Benutzeroberfläche des Barcode-Lesegeräts ein- oder ausblenden. Vergessen Sie nicht, die Option Enable QR Code Scanner in den Advanced Web Settings zu aktivieren. Das HTML-Codebeispiel zum Auslösen des Barcode-Scannens:

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

Verarbeitung des erzeugten Barcodes

Zur Verarbeitung des gescannten Barcodes aus einer Barcode-App oder der Kamera Ihres Geräts können Sie die Optionen Barcode Scan Target URL, Insert Barcode Into Website**** und Submit Form after Inserting nutzen. Informationen zur Verwendung dieser Optionen finden Sie im Abschnitt Konfiguration. Zudem werden JS-API- und MQTT-Ereignisse gesendet.

Die Bildschirmtastatur ausblenden

Wenn Ihre Website ein spezielles Eingabefeld für Barcodes enthält, zeigt die Webansicht standardmäßig immer die virtuelle (Soft-)Tastatur an.

Sie können das Einblenden der Bildschirmtastatur deaktivieren, indem Sie in den Advanced Web Settings die Option Enable Text Input deaktivieren oder die Option Always Hide Keyboard aktivieren. Dadurch ist die Tastatur jedoch auf allen Websites nicht mehr nutzbar. Alternativ können Sie eine App wie Null Keyboard verwenden, um die Bildschirmtastatur systemweit zu deaktivieren.

Sie können die Tastatur nur für ausgewählte Seiten deaktivieren, indem Sie die Option Fully JavaScript Interface und Inject JavaScript mit einem Code wie dem folgenden verwenden:

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

Bitte beachten Sie, dass durch die Deaktivierung der Tastatur der Tastatur-Emulationsmodus (Tastenanschlagmodus) und die Option Tastatureingaben abhören bei vielen Scanner-Apps möglicherweise nicht mehr funktionieren. Wir empfehlen, das Scan-Ergebnis wie oben beschrieben im Broadcast-Modus zu übertragen.

Verwendung einer externen App als Barcode-Scanner

Sie können eine andere Barcode-App wie den ZXing Barcode Scanner verwenden, um Barcodes zu scannen und die Codes an das Web zurückzusenden. Die App muss das URL-Schema zxing: unterstützen. Aktivieren Sie die Option Open URL Schemes in Other Apps in den Web Content Settings von Fully und verwenden Sie diesen HTML-Code, um eine Scan-Schaltfläche zu erstellen:

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

Nachdem ein Barcode gescannt wurde, leitet die Scanner-App zur angegebenen Rückführungs-URL weiter. Wählen Sie Fully Kiosk Browser aus, damit diese URL bei einer entsprechenden Abfrage stets mit diesem Browser geöffnet wird. Sollte für diese URL eine andere Browser-App geöffnet werden, müssen Sie in den App-Einstellungen dieser Browser-App die Standardeinstellungen zurücksetzen.