Allgemeine Konfiguration¶
⚠️ Achtung: Dieses Dokument beschreibt, wie man die API des SDKs verwendet, um Scan-Geräte zu bedienen, und bietet Beispielcode in C. Beachten Sie, dass die API synchron arbeitet und den Hauptthread blockieren kann.
⚠️ Achtung: Vor der Verwendung der API muss das Gerät verbunden werden. Die genauen Schritte finden Sie unter Gerät verbinden.
1. Konfiguration¶
Konfigurieren Sie die allgemeine Konfiguration des Scan-Geräts. Die Verwendung ist wie folgt:
const char* result = inateck_scanner_ble_set_setting_info(device_id, cmd, device_type);
Das Ergebnis wird im JSON-Format zurückgegeben. Wenn der Aufruf erfolgreich ist, wird result zurückgegeben:
{
"status": 0,
"error": "",
"info": [
{
"name": "volume",
"flag": 1001,
"value": 0,
},
{
"name": "vibration",
"flag": 1002,
"value": 0,
},
]
}
Wenn der Aufruf fehlschlägt, wird result zurückgegeben:
{
"status": 1,
"error": "Fehlermeldung",
}
Eingabeparameter:
device_idist die Geräte-ID.cmdist ein Array von Konfigurationsbefehlen, das die Kennungen und Werte der Konfigurationselemente enthält. Der Wertebereich ist in der Konfigurationsliste angegeben. Jedes Konfigurationselement ist einJSON-Objekt und enthält die folgenden Felder:flagist die Kennung eines Konfigurationselements und ein ganzzahliger Wert. Zum Beispiel ist derflagfürvolume1001.valueist der Wert des Konfigurationselements. Zum Beispiel ist dervaluefürvolume0, was bedeutet, dass der Ton ausgeschaltet ist.
device_typeist der Gerätetyp, der Wertebereich ist in der Gerätetypenliste angegeben.
Zum Beispiel, um das Volumen des BCST-21 Geräts auf 0 und die Vibration auf 0 zu setzen, wäre cmd [{"flag":1001,"value":0},{"flag":1002,"value":0}] und device_type 12.
Rückgabeparameter:
infoist eine Liste der Konfigurationsinformationen, die den Namen, die Kennung und den Wert der Konfigurationselemente enthält.nameist der Name des Konfigurationselements.flagist die Kennung des Konfigurationselements.valueist der Wert des Konfigurationselements.
2. Konfiguration abrufen¶
Abrufen der allgemeinen Konfiguration des Scan-Geräts. Die Verwendung ist wie folgt:
const char* result = inateck_scanner_ble_get_setting_info(device_id, device_type);
Das Ergebnis wird im JSON-Format zurückgegeben. Wenn der Aufruf erfolgreich ist, wird result zurückgegeben:
{
"status": 0,
"error": "",
"info": [
{
"name": "volume",
"flag": 1001,
"value": 0,
},
{
"name": "vibration",
"flag": 1002,
"value": 0,
},
]
}
Wenn der Aufruf fehlschlägt, wird result zurückgegeben:
{
"status": 1,
"error": "Fehlermeldung",
}
Eingabeparameter:
device_idist die Geräte-ID.device_typeist der Gerätetyp, der Wertebereich ist in der Gerätetypenliste angegeben.
Rückgabeparameter:
infoist eine Liste der Konfigurationsinformationen, die den Namen, die Kennung und den Wert der Konfigurationselemente enthält.nameist der Name des Konfigurationselements.flagist die Kennung des Konfigurationselements.valueist der Wert des Konfigurationselements.
3. Beispielcode¶
#include <stdio.h>
#include <string.h>
#include <stdbool.h>
#include <unistd.h>
#include "inateck_scanner_ble.h"
int main() {
const char* device_id = "Geräte-ID";
const char* cmd = "[{\"flag\":1001,\"value\":0},{\"flag\":1002,\"value\":0}]";
// BCST-21
const char* device_type = 12;
const char* result = inateck_scanner_ble_set_setting_info(device_id, cmd, device_type);
printf("Ergebnis: %s\n", result);
result = inateck_scanner_ble_get_setting_info(device_id, device_type);
printf("Ergebnis: %s\n", result);
return 0;
}