cd27a101f88cd44fc4c2ccd501681602_edited.

Softwareentwicklungs-Kits von Generalscan

Bluetooth-Scanner

3500f07bc4e37f8a4f2016ad04121ea5_edited.

Einführung zu Softwareentwicklung-Kits

7b2b2435486c9a9d0c35ec97fde9d1d8.jpg

GENERALSCAN bietet ein SDK an, das speziell für Entwickler von Fremdsoftware gedacht ist und die gesamte Palette von GENERALSCAN Bluetooth-Scannern auf Android-Smartphone-Plattformen unterstützt.

Das GENERALSCAN SDK kapselt den Zugriff auf die Low-Level-Funktionen, sodass sich die Programmierer nicht mehr mit Bluetooth-Protokollen oder anderer komplexen Protokollen auseinandersetzen müssen.

Dadurch lassen sich GENERALSCAN Bluetooth-Scanner einfach und nahtlos in Ihre Anwendung einbinden.

Das GENERALSCAN SDK bietet eine High-Level-API zum Zugriff auf verschiedene Scannerfunktionen, bspw. Bluetooth-SPP-Kommunikation, Kopplung, Datenübertragung, Namensänderung von Bluetooth-Geräten, Konfiguration der Barcodeparameter, Auslesen der Hardware-ID, DES-Verschlüsselung, Einstellung der Standby-Ruhezeit.

 

Der Quellcode des GENERALSCAN SDK befindet sich auf GitHub und kann von Interessierten kostenlos heruntergeladen werden unter:

f4c0546975a21a7b7da87076eb6cea62.png

SDK nach Android Studio Projekt importieren

1. Kopieren Sie die SDK-AAR-Datei in app / libs

2. Fügen Sie Ihrem Android-Projekt die Gradle-Konfiguration für die flatDir-Einstellung hinzu. In Ihrer r oot build.gradle Datei:

allprojects {

Repositories

{

jcenter ()

flatDir {dirs 'libs'} // flatDir-Einstellung hinzufügen}

}}

3. Öffnen Sie die Datei build.grdle auf App-Ebene und fügen Sie die .aar-Datei und die Kotlin-Laufzeit hinzu

Abhängigkeiten

{

Implementierung 'org.jetbrains.kotlin: kotlin-stdlib: 1.3.10'

Implementierung ( Name : 'generalscan-sdk-1.0', ext : 'aar')

}}

4. Fügen Sie die folgenden Berechtigungen zu manifest.xml hinzu

<! - Berechtigung für Bluetooth ->

< Verwendungsberechtigung android: name = "android.permission.BLUETOOTH" />

< Verwendungsberechtigung android: name = "android.permission.BLUETOOTH_ADMIN" />

< Verwendungsberechtigung android: name = "android.permission.ACCESS_FINE_LOCATION" />

< Verwendungsberechtigung android: name = "android.permission.ACCESS_COARSE_LOCATION" />

< Verwendungsberechtigung android: name = "android.permission.VIBRATE" /> <! - Berechtigungen für USB-Host (Scan Buddy) ->

< Verwendungsfunktion android: name = "android.hardware.usb.host" android: required = "true" />

<! - Warnungsdialog im Dienst anzeigen ->

< Verwendungsberechtigung android: name = "android.permission.SYSTEM_ALERT_WINDOW" />

5. Fügen Sie die folgenden Service-Deklarationen in manifest.xml ein

< service android: name = "com.generalscan.scannersdk.core.session.bluetooth.

service.BluetoothConnectService "

android: enabled = "true"

android: exported = "true" />

< service android: name = "com.generalscan.scannersdk.core.session.usbhost.

service.UsbHostService "

android: enabled = "true"

android: exported = "true" />

< service android: name = "com.generalscan.scannersdk.core.session.usbhost.

service.FloatingScanButtonService "

android: enabled = "true"

android: exported = "true" />

5bb7197eeaeaa709fe20b2928ba95096.png

Interaktion mit Bluetooth-Scanner

  1. Schalten Sie Bluetooth ein

  2. Starten Sie die Bluetooth-Sitzung, nachdem die Aktivität erstellt wurde

BluetoothConnectSession mBluetoothConnectSession = neue BluetoothConnectSession (this);

// Sitzungslistener einrichten

mBluetoothConnectSession.setSessionListener (

neuer SessionListener ()

{

// Wenn die Sitzung fertig ist

@Override

public void onSessionReady (IConnectSession iConnectSession) {

// TODO: um das Gerät hier oder später anzuschließen}

// Beim Zeitlimit für die Initialisierung des Sitzungsdienstes

@Override

public void onSessionStartTimeOut (IConnectSession iConnectSession) {

// TODO: Fehlermeldung anzeigen}

}}

);

mBluetoothConnectSession.startSession ();

4bd09a715de7bb44e47a128813c91f8d.png

Empfänger zum Barcodelesen einstellen

Richten Sie den Listener so ein, dass Daten empfangen werden

mBluetoothConnectSession.setConnectListener (

neuer CommunicateListener ()

{

// Bluetooth-Gerät getrennt

@Override

public void onDisconnected ()

{showMessage ("Gerät wurde getrennt");

}}

// Bluetooth-Geräteverbindung fehlgeschlagen

@Override

public void onConnectFailure (String errorMessage) {

showMessage (errorMessage);

}}

// Bluetooth-Geräteverbindung erfolgreich

@Override

public void onConnected () {

showMessage (R.string.scanner_connect_success);

}}

// Scannerdaten empfangen

@Override

public void onDataReceived (String data) {

mTxtReceiveData.append (Daten); }}

// Bluetooth-Befehlsrückruf

@Override

public void onCommandCallback (Stringname , Stringdaten) {

mTxtReceiveData.append ("$ name: $ data");

}}

// Batteriedaten empfangen

@Override

public void onBatteryDataReceived (String-Spannung, String-Prozentsatz) {mTxtReceiveData.append (Spannung + ":" + Prozentsatz); }}

// Zeitlimit für Scannerbefehle

@Override

public void onCommandNoResponse (String errorMessage) {}

// Datenempfangsfehler

@Override

public void onRawDataReceiveError (String errorMessage, String source) {}

// Rohdaten empfangen

@Override

public void onRawDataReceived (Byte-Daten) {

}}

}}

);

bcec830fdbaf2f5bab7447d294315045.png

Bluetooth-Pairing, Verbindung, Gespräche beenden

Bluetooth-Gerät koppeln

Bluetooth-Gerät verbinden

BluetoothAdapter mBluetoothAdapter mBluetoothAdapter = BluetoothAdapter.getDefaultAdapter ()

BluetoothDevice device = BluetoothAdapter.getRemoteDevice (mSelectedDeviceAddress); mBluetoothConnectSession.setBluetoothDeviceToConnect (Gerät); mBluetoothConnectSession.connect ();

Beenden Sie die Bluetooth-Sitzung, nachdem die Aktivität zerstört wurde

// Aktuelle Bluetooth-Sitzung senden

mBluetoothConnectSession . endSession ();

1c2f6a9e1831a438a761c8a8e06a7415_edited.

Download im Google PlayStore

7b2b2435486c9a9d0c35ec97fde9d1d8.jpg