diff --git a/通讯协议-B200W-MQTT协议[外].html b/通讯协议-B200W-MQTT协议[外].html new file mode 100644 index 0000000..f5560a0 --- /dev/null +++ b/通讯协议-B200W-MQTT协议[外].html @@ -0,0 +1,7377 @@ + + 通讯协议-B200W-MQTT协议[外] + + + + + + + + + + + + + +
+ + + +
+

SunVote B200W MQTT通讯协议

+

MQTT服务器准备

+

MQTT服务器要求：

+

厂家使用EMQX 进行测试

+

能够正常收发MQTT数据。

+

服务器的性能参数由业务决定。

+

域名：

+

公网域名或ip或者基站所处局域网ip。

+

MQTT服务器配置结果检查

+

使用MQTT.FX客户端，配置域名，端口，用户名和密码信息，然后连接，如果提示连接成功，则表示MQTT服务器可用。基站clientid 是基站编号。

+

+

功能说明

+

主题说明

+

${baseSN}为指定的基站的SN编码，不能为空，接收基站反馈数据需要订阅对应基站SN的接收主题。

+

发布的主题

+

应用程序发布的主题，基站订阅

+/client/${baseSN}/send

+/client/multiBase/send

+

订阅的主题

+

应用程序订阅的主题，基站发布

+/basestation/\${baseSN}/receive

+/basestation/multiBase/receive

+

指令说明

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
指令功能标识说明约束
get待机状态下获取参数属性状态及数据待机状态
set待机状态下设置参数属性状态及数据待机状态
start运行一个单进程业务实例（函数）待机状态
stop停止一个单进程业务实例（函数）待机状态
rtXXX在线状态下可实时执行方法及函数
+

事件说明

+ + + + + + + + + + + + + + + + + + + + +
事件标识说明约束
sEvtXXX系统事件自动返回
fEvtXXX指令事件调用对应指令后返回
+

数据格式约定

+ +
  {
+    "fun":"xxx", 
+    "dataTag":"xxx", 
+    "data":{    
+       //内容
+    }
+  }
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
参数说明约束
fun指令或事件名称
dataTag数据标签，用于对应收发数据长度不超过4，可为0-9a-zA-Z的组合
data数据内容对象或者数组，可为空
+

注意：基站接收指令数据单次不超过2K长度，在指定键盘发送指令时，如果指令长度超出限制，建议将指令进行拆分，分次发送，如果是所有键盘执行的指令，可将keySns设为空数组不使用指定键盘的模式

+

功能速查一览表

+

基站管理

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
功能归类功能API指令指令/系统事件
基站连接 - 获取在线基站主动获取在线基站信息
不确定基站SN时		getBsOnlineStatefEvtBsOnlineState
基站连接 - 主动获取状态主动获取基站连接状态getBsConnectStatesEvtBsConnectState
基站连接 - 自动获取状态基站连接变化系统通知-sEvtBsConnectState
基站授时对基站授时用于校准时间timeSyncsEvtStateCode
键盘上线通知单个键盘上线系统通知-sEvtBsKpOnlineMsg
识别设置 - 基站型号读取基站型号getBsModelfEvtBsModel
识别设置 - 固件版本获取基站固件版本getBsFWVersionfEvtBsFWVersion
组网设置 - 配对码获取基站配对码getBsPairCodefEvtBsPairCode
组网设置 - 刷卡配对状态获取刷卡配对状态getBsNfcLoginfEvtBsNfcLogin
设置刷卡配对状态setBsNfcLoginfEvtBsNfcLogin
组网设置 - 工作信道获取基站工作信道getBsChannelfEvtBsChannel
设置基站工作信道setBsChannelfEvtBsChannel
登录设置 - 登录名称获取基站登录名称getBsSSIDfEvtBsSSID
设置基站登录名称setBsSSIDfEvtBsSSID
键盘统一设置 - 键盘语言获取键盘语言getBsKpLanguagefEvtBsKpLanguage
设置键盘语言setBsKpLanguagefEvtBsKpLanguage
配对模式 - 快速配对启动基站快速配对startBsFastPairsEvtStateCode
sEvtBsKpOnlineMsg
停止基站快速配对stopBsFastPairsEvtStateCode
白名单模式 - 白名单管理获取白名单getBsWhitelistfEvtBsWhitelist
设置白名单setBsWhitelistsEvtStateCode
fEvtSetBsWhitelist
清空白名单clearBsWhitelistsEvtStateCode
fEvtBsWhitelist
增加白名单addBsWhitelistsEvtStateCode
fEvtAddBsWhitelist
fEvtBsWhitelist
删除白名单delBsWhitelistsEvtStateCode
fEvtDelBsWhitelist
fEvtBsWhitelist
网络设置 - TCP/IP参数获取TCP/IP参数getBsTcpipParamsfEvtBsTcpipParams
设置TCP/IP参数setBsTcpipParamsfEvtBsTcpipParams
网络设置 - MQTT参数获取MQTT参数getBsMqttParamsfEvtBsMqttParams
设置MQTT参数setBsMqttParamsfEvtBsMqttParams
+

键盘管理

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
功能归类功能API指令指令事件
交互设置 - 用户实时提示信息实时设置提示反馈信息rtSetKpUserPromptsEvtStateCode
fEvtSetKpUserPrompt
在线状态获取开启扫描在线键盘startGetKpOnlinesEvtStateCode
fEvtKpOnlineMsg
停止扫描在线键盘stopGetKpOnlinesEvtStateCode
维护功能 - 遥控功能遥控键盘休眠remoteKpSleepsEvtStateCode
+

绑定

+ + + + + + + + + + + + + + + + + + + + + + + +
功能归类功能API指令指令事件
无线绑定设置绑定信息到键盘rtSetKpBindingInfosEvtStateCode
fEvtKpBindingInfo
清除键盘绑定信息clearKpBindingInfosEvtStateCode
fEvtClearKpBindingInfo
+

签到

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
功能归类功能API指令指令事件
同步签到启动同步签到startKpSignInsEvtStateCode
fEvtKpSignIn
停止同步签到stopKpSignInsEvtStateCode
随时签到启动随时签到rtStartKpSignInsEvtStateCode
fEvtKpSignIn
停止随时签到rtStopKpSignInsEvtStateCode
实时PIN签到授权rtSetKpLoginAllowedsEvtStateCode
fEvtKpLoginAllowed
+

按键反馈

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
功能归类功能API指令指令事件
判断题启动判断题答题startQATrueFalsesEvtStateCode
fEvtQATrueFalse
停止判断题答题stopQATrueFalsesEvtStateCode
选择题启动选择题答题startQAChoicesEvtStateCode
fEvtQAChoice
停止选择题答题stopQAChoicesEvtStateCode
数字题启动数字题答题startQANumsEvtStateCode
fEvtQANum
停止数字题答题stopQANumsEvtStateCode
抢答题启动抢答题答题startQAQuickersEvtStateCode
fEvtQAQuicker
停止抢答题答题stopQAQuickersEvtStateCode
+

在线测验

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
功能归类功能API指令指令事件
标准测验启动标准测验startKpExamsEvtStateCode
fEvtKpExam
fEvtFinalSubmit
停止标准测验stopKpExamsEvtStateCode
允许键盘提交后退回修改rtAllowEditedsEvtStateCode
fEvtFinalSubmit
+

公共事件

+

sEvtBsConnectState

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是事件类型
dataTagstring-否数据包标识，不需要时可传空字符串
dataobject-是传送参数的对象
+baseModelint否基站的型号码
+modelNamestring否基站的型号名称
+stateint是基站的连接状态
1-已连接
2-连接断开
+versionstring否基站固件版本
+ +
//连接成功
+{
+    "fun":"sEvtBsConnectState",
+    "dataTag":"1",
+    "data":{  
+        "state":1,      
+        "baseModel":218,
+        "modelName":"B200",
+        "version":"1.0.3"
+    }
+}
+//连接断开
+{
+    "fun":"sEvtBsConnectState",
+    "dataTag":"1",
+    "data":{        
+        "state":2
+    }
+}
+

sEvtBsChannelConflict

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是事件名称
dataTagstring-否数据包标识，不需要时可传空字符串
dataobject-是传送参数的对象
+valueint是有冲突的信道
+ +
{
+    "fun":"sEvtBsChannelConflict",
+    "dataTag":"1",
+    "data":{        
+        "value":5   //信道5有多个基站使用
+    }
+}
+

sEvtBsNfcResults

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是事件名称
dataTagstring-否数据包标识，不需要时可传空字符串
dataobject-是传送参数的对象
+keySnstring是刷卡的键盘SN
+valueint是刷卡的状态
1-成功
2-失败
+ +
{
+    "fun":"sEvtBsNfcResults",
+    "dataTag":"1",  //不需要时可传空字符串
+    "data":{ 
+        "keySn":"1234567890",       
+        "value":1   
+    }
+}
+

sEvtBsKpOnlineMsg

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是事件名称
dataTagstring-否数据包标识
dataobject-是传送参数的对象
+keySnstring是键盘SN
+versionstring是键盘固件版本
+modelint是键盘型号
+ +
{
+    "fun":"sEvtBsKpOnlineMsg",
+    "dataTag":"1",
+    "data":{ 
+        "keySn":"1234567890",
+        "version":"1.0.0",
+        "model":67
+    }
+}
+

sEvtStateCode

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是事件名称
dataTagstring-否数据包标识
dataobject-是传送参数的对象
+funNamestring是指令名称
+codestring是状态码，含义见下表
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
状态码说明
0指令收取成功
10001不能正确解析的JSON数据
10002解析JSON错误
20001基站未连接
20002功能不支持
20003基站SN格式不正确
20004参数错误
20005基站在答题中
40001升级功能只能支持一个基站
50001此功能必须指定基站
60001此功能必须指定键盘SN
+ +
{
+    "fun":"sEvtStateCode",
+    "dataTag":"1",
+    "data":{ 
+        "funName":"startKpRollCall",
+        "code":"20005"
+    }
+}
+

基站管理

+

基站连接

+

方法

+
getBsOnlineState
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是固定指令名称
dataTagstring-否数据包标识
+ +
{
+  "fun":"getBsOnlineState",
+  "dataTag":"1"
+}
+
getBsConnectState
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是固定指令名称
dataTagstring-否数据包标识
+ +
{
+  "fun":"getBsConnectState",
+  "dataTag":"1"
+}
+

事件

+
sEvtBsConnectState
+

参见基站连接变化系统通知

+
fEvtBsOnlineState
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是事件类型
dataTagstring-否数据包标识，不需要时可传空字符串
dataobject-是传送参数的对象
+baseModelint否基站的型号码
+modelNamestring否基站的型号名称
+versionstring否基站固件版本
+baseSNstring否基站SN
+ +
//连接成功
+{
+    "fun":"fEvtBsOnlineState",
+    "dataTag":"1",
+    "data":{       
+        "baseModel":218,
+        "modelName":"B200",
+        "version":"1.0.3",
+        "baseSN":"2024041401"
+    }
+}
+

基站授时

+

方法

+
timeSync
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是固定指令名称
dataTagstring-否数据包标识
dataobject-是传送参数的对象
+timeStamplong否当前时间的时间戳
+ +
{
+  "fun":"timeSync",
+  "dataTag":"1",
+  "data":{
+      "timeStamp":1718247133290
+  }
+}
+

事件

+
sEvtStateCode
+

返回指令的接收状态

+

识别设置

+

方法

+
getBsModel
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
+ +
{
+  "fun":"getBsModel",
+  "dataTag":"1"
+}
+
getBsFWVersion
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
+ +
{
+  "fun":"getBsFWVersion",
+  "dataTag":"1"
+}
+

事件

+
fEvtBsSN
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是事件名称
dataTagstring-否数据包标识
dataobject-是传送参数的对象
+valuestring-是基站的出厂编码
+ +
{
+    "fun":"fEvtBsSN",
+    "dataTag":"1",
+    "data":{
+        "value":"2024041201"
+    }
+}
+
fEvtBsModel
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是事件名称
dataTagstring-否数据包标识
dataobject-是传送参数的对象
+valuestring-是基站的型号名称
+ +
{
+    "fun":"fEvtBsModel",
+    "dataTag":"1",
+    "data":{
+        "value":"B200"
+    }
+}
+
fEvtBsFWVersion
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是事件名称
dataTagstring-否数据包标识
dataobject-是传送参数的对象
+valuestring是基站的固件版本号
+ +
{
+    "fun":"fEvtBsFWVersion",
+    "dataTag":"1",
+    "data":{
+        "value":"1.0.3"
+    }
+}
+

组网设置

+

方法

+
getBsPairCode
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
+ +
{
+  "fun":"getBsPairCode",
+  "dataTag":"1"
+}
+
getBsNfcLogin
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
+ +
{
+  "fun":"getBsNfcLogin",
+  "dataTag":"1"
+}
+
setBsNfcLogin
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传送参数的对象
+valuestring-是设置的基站刷卡配对状态
0-关闭刷卡配对
1-开启刷卡配对
+ +
{
+  "fun":"setBsNfcLogin",
+  "dataTag":"1",
+  "data":{
+    "value":"1"
+  }
+}
+
getBsChannel
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
+ +
{
+  "fun":"getBsChannel",
+  "dataTag":"1"
+}
+
setBsChannel
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传送参数的对象
+valuestring-是设置的基站信道，可设范围：1-80
+ +
{
+  "fun":"setBsChannel",
+  "dataTag":"1",
+  "data":{
+    "value":"23"
+  }
+}
+

事件

+
fEvtBsPairCode
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是事件名称
dataTagstring-否数据包标识，可传空字符串
dataobject-是传送参数的对象
+valuestring是基站的配对码
+ +
{
+    "fun":"fEvtBsPairCode",
+    "dataTag":"1",
+    "data":{        
+        "value":"123456"
+    }
+}
+
fEvtBsChannel
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是事件名称
dataTagstring-否数据包标识，可传空字符串
dataobject-是传送参数的对象
+valuestring是基站信道
+ +
{
+    "fun":"fEvtBsChannel",
+    "dataTag":"1",
+    "data":{        
+        "value":"5"
+    }
+}
+
fEvtBsNfcLogin
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是事件名称
dataTagstring-否数据包标识，可传空字符串
dataobject-是传送参数的对象
+valuestring是0-关闭 1-开启
+ +
{
+    "fun":"fEvtBsNfcLogin",
+    "dataTag":"1",
+    "data":{        
+        "value":"1"
+    }
+}
+

登录设置

+

方法

+
getBsSSID
+

获取基站登录名称

+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是固定指令名称
dataTagstring-否数据包标识
+ +
{
+  "fun":"getBsSSID",
+  "dataTag":"1"
+}
+
setBsSSID
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传送参数的对象
+valuestring是设置的基站SSID，最长12字符
+ +
{
+  "fun":"setBsSSID",
+  "dataTag":"1",
+  "data":{
+    "value":"1901班"
+  }
+}
+

事件

+
fEvtBsSSID
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是事件名称
dataTagstring-否数据包标识，可传空字符串
dataobject-是传送参数的对象
+valuestring是基站名称
+ +
{
+    "fun":"fEvtBsSSID",
+    "dataTag":"1",
+    "data":{        
+        "value":"1901班"
+    }
+}
+

键盘统一设置

+

方法

+
getBsKpLanguage
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
+ +
{
+  "fun":"getBsKpLanguage",
+  "dataTag":"1"
+}
+
setBsKpLanguage
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传送参数的对象
+valuestring是设置键盘显示的语言
1-简体中文
2-英文
+ +
{
+  "fun":"setBsKpLanguage",
+  "dataTag":"1",
+  "data":{
+    "value":"1"
+  }
+}
+

事件

+
fEvtBsKpLanguage
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传送参数的对象
+valuestring是设置键盘显示的语言
1-简体中文
2-英文
+ +
{
+  "fun":"fEvtBsKpLanguage",
+  "dataTag":"1",
+  "data":{
+    "value":"1"
+  }
+}
+

配对模式

+

方法

+
startBsFastPair
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
+ +
{
+  "fun":"startBsFastPair",
+  "dataTag":"1"
+}
+
stopBsFastPair
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
+ +
{
+  "fun":"stopBsFastPair",
+  "dataTag":"1"
+}
+

事件

+
sEvtStateCode
+

发送指令后返回此事件

+
sEvtBsKpOnlineMsg
+

键盘配对成功后在线返回此事件

+

白名单模式

+

方法

+
getBsWhitelist
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
+ +
{
+  "fun":"getBsWhitelist",
+  "dataTag":"1"
+}
+
setBsWhitelist
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传送参数的对象
+keySnsarray-是待写入的键盘SN数组，最多不超过200
键盘SN为10位数字
+ +
{
+  "fun":"setBsWhitelist",
+  "dataTag":"1",
+  "data":{
+    "keySns":["2024021001","2024021002","2024021003","2024021004"]
+  }
+}
+
clearBsWhitelist
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
+ +
{
+  "fun":"clearBsWhitelist",
+  "dataTag":"1"
+}
+
addBsWhitelist
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传送参数的对象
+keySnsarray-是待添加的键盘SN列表
键盘SN为10位数字
+ +
{
+  "fun":"addBsWhitelist",
+  "dataTag":"1",
+  "data":{
+    "keySns":["2024021001"]
+  }
+}
+
delBsWhitelist
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传送参数的对象
+keySnsarray-是待删除的键盘SN列表
键盘SN为10位数字
+ +
{
+  "fun":"delBsWhitelist",
+  "dataTag":"1",
+  "data":{
+    "keySns":["2024021001"]
+  }
+}
+

事件

+
sEvtStateCode
+

发送指令后返回此事件

+
fEvtBsWhitelist
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传送参数的对象
+keySnsarray是基站当前的白名单列表
+ +
{
+  "fun":"fEvtBsWhitelist",
+  "dataTag":"1",
+  "data":{
+    "keySns":["2024021001","2024021002","2024021003","2024021004"]
+  }
+}
+
fEvtSetBsWhitelist
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataarray-是传送参数的对象数组
++keySnsarray是键盘SN数组
++stateint是键盘SN的写入状态
0-写入成功
1-写入失败
+ +
{
+  "fun":"fEvtSetBsWhitelist",
+  "dataTag":"1",
+  "data":[{
+    "keySns":["2024021001","2024021002"],
+    "state":0
+  },{
+    "keySns":["1211"],
+    "state":1
+  }]
+}
+
fEvtAddBsWhitelist
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataarray-是传送参数的对象数组
++keySnsarray是键盘SN数组
++stateint是键盘的增加状态
0-增加成功
1-增加失败
+ +
{
+  "fun":"fEvtAddBsWhitelist",
+  "dataTag":"1",
+  "data":[{
+    "keySns":["2024021001","2024021002"],
+    "state":0
+  },{
+    "keySns":["1211"],
+    "state":1
+  }]
+}
+
fEvtDelBsWhitelist
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataarray-是传送参数的对象数组
++keySnsarray是键盘SN数组
++stateint是键盘的删除状态
0-删除成功
1-删除失败
+ +
{
+  "fun":"fEvtDelBsWhitelist",
+  "dataTag":"1",
+  "data":[{
+    "keySns":["2024021002"],
+    "state":0
+  },{
+    "keySns":["2024021001"],
+    "state":1
+  }]
+}
+

网络参数设置

+

方法

+
getBsTcpipParams
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
+ +
{
+  "fun":"getBsTcpipParams",
+  "dataTag":"1"
+}
+
setBsTcpipParams
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传送参数的对象
+ipstring否IP地址
+maskstring否子网掩码
+gatewaystring否网关地址
+ipAllocationint否基站IP获取方式
0 - 手动指定
1 - DHCP获取
+ +
{
+  "fun":"setBsTcpipParams",
+  "dataTag":"1",
+  "data":{
+    "ip":"192.168.0.10",
+    "mask":"255.255.255.0",
+    "gateway":"192.168.0.1",
+    "ipAllocation":1
+  }
+}
+
getBsMqttParams
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
+ +
{
+  "fun":"getBsMqttParams",
+  "dataTag":"1"
+}
+
setBsMqttParams
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传送参数的对象
+serverstring是服务器IP地址
+portint是端口，默认1883
+userNamestring否连接服务器的用户名，可不设置
+passwordstring否连接服务器的密码，可不设置
+intervalint>=10否基站连接服务器失败后重连的间隔时长，单位秒
+ +
{
+  "fun":"setBsMqttParams",
+  "dataTag":"1",
+  "data":{
+    "server":"192.168.10.10",
+    "port":1883,
+    "userName":"",
+    "password":"",
+    "interval":30
+  }
+}
+

事件

+
fEvtBsTcpipParams
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传送参数的对象
+macstring是MAC地址
+ipstring是IP地址
+maskstring是子网掩码
+gatewaystring是网关地址
+ipAllocationint否基站IP获取方式
0 - 手动指定
1 - DHCP获取
+ +
{
+  "fun":"fEvtBsTcpipParams",
+  "dataTag":"1",
+  "data":{
+    "mac":"FF:FF:FF:FF:FF:FF",
+    "ip":"192.168.0.10",
+    "mask":"255.255.255.0",
+    "gateway":"192.168.0.1",
+    "ipAllocation":1
+  }
+}
+
fEvtBsMqttParams
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传送参数的对象
+serverstring是服务器地址，IP
+portint是端口，默认1883
+userNamestring否连接服务器的用户名，可不设置
+passwordstring否连接服务器的密码，可不设置
+intervalint>=10否基站连接服务器失败后重连的间隔时长，单位秒
+ +
{
+  "fun":"fEvtBsMqttParams",
+  "dataTag":"1",
+  "data":{
+    "server":"192.168.10.10",
+    "port":1883,
+    "userName":"",
+    "password":"",
+    "interval":30
+  }
+}
+

键盘管理

+

交互设置

+

方法

+
rtSetKpUserPrompt
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataarray-否传送参数的对象数组
++keySnsarray是指定的键盘SN数组，空数组表示全部在线键盘
注意：不允许空数组和指定SN数组混合使用
包含空数组默认为全部在线键盘，其他指定键盘无效
++infostring否设置的反馈信息
不同键盘可设置不同反馈信息
+ +
//分别提示
+{
+  "fun": "rtSetKpUserPrompt",
+  "dataTag":"1",
+  "data": [
+    {
+      "keySns": ["1479824643","1479824645"],
+      "info": "答对了"
+    },
+    {
+      "keySns": ["1479824644"],
+      "info": "答错了"
+    }
+  ]
+}
+//统一提示
+{
+  "fun": "rtSetKpUserPrompt",
+  "dataTag":"1",
+  "data": [
+    {
+      "keySns": [],
+      "info": "答题结束"
+    }
+  ]
+}
+

事件

+
sEvtStateCode
+

发送指令后返回接收状态

+
fEvtSetKpUserPrompt
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataarray-是传送参数的对象数组
++keySnstring是设置提示语信息的键盘SN
++statestring是设置的提示语是否成功
0 - 成功
1 - 失败
+ +
{
+  "fun": "fEvtSetKpUserPrompt",
+  "dataTag":"1",
+  "data": [
+    {
+      "keySn": "1479824643",
+      "state": "0"
+    },
+    {
+      "keySn": "1479824645",
+      "state": "0"
+    },
+    {
+      "keySn": "1479824644",
+      "state": "1"
+    }
+  ]
+}
+

在线状态

+

方法

+
startGetKpOnline
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
+ +
{
+  "fun": "startGetKpOnline",
+  "dataTag":"1"
+}
+
stopGetKpOnline
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
+ +
{
+  "fun": "stopGetKpOnline",
+  "dataTag":"1"
+}
+

事件

+
sEvtStateCode
+

发送指令后返回此事件

+
fEvtKpOnlineMsg
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是事件名称
dataTagstring-否数据包标识
dataobject-是传送参数的对象
+keySnstring是键盘SN
+versionstring是键盘固件版本
+modelint是键盘型号
+voltagedouble是键盘电量
+ +
{
+    "fun":"fEvtKpOnlineMsg",
+    "dataTag":"1",
+    "data":{ 
+        "keySn":"1234567890",
+        "version":"1.0.0",
+        "model":67,
+        "voltage":2.8
+    }
+}
+

维护功能

+

方法

+
remoteKpSleep
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传送参数的对象数组
+keySnsarray否需要执行指令的键盘SN数组，空数组表示所有键盘
+ +
{
+  "fun":"remoteKpSleep",
+  "dataTag":"1",
+  "data":{
+    "keySns":["1479824644"]
+  }
+}
+

事件

+
sEvtStateCode
+

返回指令的接收状态

+

绑定

+

无线绑定

+

方法

+
rtSetKpBindingInfo
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataarray-是传送参数的对象数组，不可为空
++keySnstring是需要设置绑定信息的键盘SN
++infostring是设置的绑定信息，一般为学生姓名
最长48个字符，显示在键盘左上角
+ +
{
+  "fun": "rtSetKpBindingInfo",
+  "dataTag":"1",
+  "data": [
+    {
+      "keySn": "1479824643",
+      "info": "张三"
+    },
+    {
+      "keySn": "1479824644",
+      "info": "李四"
+    }
+  ]
+}
+
clearKpBindingInfo
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传送参数的对象数组
+keySnsarray否需要清除绑定信息键盘SN数组，
空数组表示清空所有键盘
+ +
{
+  "fun": "clearKpBindingInfo",
+  "dataTag":"1",
+  "data": {
+    "keySns":["1479824643","1479824644","1479824645"]
+  }
+}
+

事件

+
sEvtStateCode
+

发送指令后返回接收状态

+
fEvtKpBindingInfo
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataarray-否传送参数的对象数组
++keySnstring是需要设置绑定信息的键盘SN
++statestring是设置的绑定信息是否成功
0 - 成功
1 - 失败
+ +
{
+  "fun": "fEvtKpBindingInfo",
+  "dataTag":"1",
+  "data": [
+    {
+      "keySn": "1479824643",
+      "state": "0"
+    },
+    {
+      "keySn": "1479824644",
+      "state": "1"
+    }
+  ]
+}
+
fEvtClearKpBindingInfo
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-否传送参数的对象
+statestring是设置的绑定信息是否成功
0 - 成功
1 - 失败
+ +
{
+  "fun": "fEvtClearKpBindingInfo",
+  "dataTag":"1",
+  "data": {
+    "state": "0"
+  }
+}
+

签到

+

同步签到

+

方法

+
startKpSignIn
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传递参数的对象
+modeint-是签到模式
1-按键签到，可指定按键
2-PIN码签到，可指定PIN码长度
+allowModifyint-是修改模式
0-不可修改
1-可以修改(默认值)
+pinLenint-是可输入pin码的最大长度 1≤N≤14
+keyValueint-是指定按键键值
0: 未指定(OK键签到)
1-9: 按键1-9
10: 按键0
11: 上键
12: 下键
13: OK键
14: ESC键
15: Menu键
+tipTitlestring-否提示标题,长度最多不超过16个字节
+ +
//按键签到
+{
+  "fun":"startKpSignIn",
+  "dataTag":"1",
+  "data":{
+    "mode":1,
+    "allowModify":1,
+    "keyValue":5,
+    "tip":"请按5键签到"
+  }
+}
+
+//pin签到
+{
+  "fun":"startKpSignIn",
+  "dataTag":"1",
+  "data":{
+    "mode":2,
+    "allowModify":1,
+    "pinLen":6,
+    "tip":"请输入PIN码签到"
+  }
+}
+
stopKpSignIn
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
+ +
{
+  "fun":"stopKpSignIn",
+  "dataTag":"1"
+}
+

事件

+
sEvtStateCode
+

发送指令后返回接收状态

+
fEvtKpSignIn
+

返回键盘提交的签到数据

+

随时签到

+

方法

+
rtStartKpSignIn
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传递参数的对象
+modeint-是签到模式
2-PIN码签到，输入pin码后由应用程序决定是否授权
+ +
{
+  "fun": "rtStartKpSignIn",
+  "dataTag":"1",
+  "data":{
+    "mode":2
+  }
+}
+
rtStopKpSignIn
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
+ +
{
+  "fun": "rtStopKpSignIn",
+  "dataTag":"1"
+}
+
rtSetKpLoginAllowed
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传递参数的对象
+keySnstring-是键盘SN
+stateint-是1-授权成功
2-授权失败
3-解除已授权
+ +
{
+  "fun": "rtSetKpLoginAllowed",
+  "dataTag":"1",
+  "data":{
+    "keySn":"1479824643",
+    "state":1
+  }
+}
+

事件

+
sEvtStateCode
+

发送指令后返回接收状态

+
fEvtKpSignIn
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataarray-是传送参数的对象数组
++keySnstring是键盘SN
++keyValuestring是键盘提交的按键值
++keyTimedouble是答题时间，从启动开始计算，单位秒
+ +
{
+  "fun": "fEvtKpSignIn",
+  "dataTag":"1",
+  "data": [{
+      "keySn": "1234567890",
+      "keyValue":"1004",
+      "keyTime":30.2
+    },
+    {
+      "keySn": "1234567891",
+      "keyValue":"1003",
+      "keyTime":32.5
+    }
+  ]
+}
+
fEvtKpLoginAllowed
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传送参数的对象
+keySnstring是键盘SN
+statestring是0-执行成功
1-执行失败
+ +
{
+  "fun": "fEvtKpLoginAllowed",
+  "dataTag":"1",
+  "data": {
+      "keySn":"1479824643",
+      "state":"0"
+    }
+}
+

按键反馈

+

判断题

+

方法

+
startQATrueFalse
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传送参数的对象
+keySnsarray是指定的键盘SN数组，空数组表示全部在线键盘
+modeint是1 - True/False 对/错
2 - Yes/No 是/否
3 - √/×
+allowModifyint是0 - 不允许修改
1 - 允许修改
+tipstring否提示的标题，长度不超过16字符
+ +
{
+  "fun": "startQATrueFalse",
+  "dataTag":"1",
+  "data":{
+    "keySns":[],
+    "mode":1,
+    "allowModify":1,
+    "tip":"请判断对错"
+  }
+}
+
stopQATrueFalse
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
+ +
{
+  "fun": "stopQATrueFalse",
+  "dataTag":"1"
+}
+

事件

+
sEvtStateCode
+

发送指令后返回接收状态

+
fEvtQATrueFalse
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataarray-是传送参数的对象数组
++keySnstring是键盘SN
++keyValuestring是键盘提交的按键值
1-对
2-错
++keyTimedouble是答题时间，从启动开始计算，单位秒
+ +
{
+  "fun": "fEvtQATrueFalse",
+  "dataTag":"1",
+  "data": [{
+      "keySn": "1234567890",
+      "keyValue":"1",
+      "keyTime":30.2
+    }
+  ]
+}
+

选择题

+

方法

+
startQAChoice
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传送参数的对象
+keySnsarray是指定的键盘SN数组，空数组表示全部在线键盘
+modeint是显示模式
1:显示字母(默认值)
2:显示数字
+lessModeint是迫选模式
0:可缺选(默认值)
1:不可缺选
2:允许重复输入
3:允许重复输入且不可缺选
+optionsint是选项数量，1≤M≤10(默认值4)
+optionalNint是可选项个数，1≤N≤M(默认值1)
+allowModifyint是修改模式
0 - 不允许修改
1 - 允许修改
+tipstring否提示的标题，长度不超过16字符
+ +
{
+  "fun": "startQAChoice",
+  "dataTag":"1",
+  "data":{
+    "keySns":[],
+    "mode": 1,
+    "lessMode": 0,
+    "options": 4,
+    "optionalN": 1,
+    "allowModify":1,
+    "tip":"请选择"
+  }
+}
+
stopQAChoice
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
+ +
{
+  "fun": "stopQAChoice",
+  "dataTag":"1"
+}
+

事件

+
sEvtStateCode
+

发送指令后返回接收状态

+
fEvtQAChoice
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataarray-是传送参数的对象数组
++keySnstring是键盘SN
++keyValuestring是键盘提交的按键值
++keyTimedouble是答题时间，从启动开始计算，单位秒
+ +
{
+  "fun": "fEvtQAChoice",
+  "dataTag":"1",
+  "data": [{
+      "keySn": "1234567890",
+      "keyValue":"A",
+      "keyTime":3.2
+    }]
+}
+

数字题

+

方法

+
startQANum
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传送参数的对象
+keySnsarray是指定的键盘SN数组，空数组表示全部在线键盘
+modeint是模式
0:无规则 （S6最多16位，T2最多14位）
1:带小数位上下限（T2不支持）
+digitsint是小数位数，范围0-2，mode=1时有效
+numMinint是可输入下限,mode=1有效，范围0-100
+numMaxint是可输入上限,mode=1有效，范围0-100
+allowModifyint是修改模式
0 - 不允许修改
1 - 允许修改
+tipstring否提示的标题，长度不超过16字符
+ +
{
+  "fun": "startQANum",
+  "dataTag":"1",
+  "data":{
+    "keySns":[],
+    "mode": 1,
+    "digits": 1,
+    "numMin": 0,
+    "numMax": 100,
+    "allowModify":1,
+    "tip":"请输入数字"
+  }
+}
+
stopQANum
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
+ +
{
+  "fun": "stopQANum",
+  "dataTag":"1"
+}
+

事件

+
sEvtStateCode
+

发送指令后返回接收状态

+
fEvtQANum
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataarray-是传送参数的对象数组
++keySnstring是键盘SN
++keyValuestring是键盘提交的按键值
++keyTimedouble是答题时间，从启动开始计算，单位秒
+ +
{
+  "fun": "fEvtQANum",
+  "dataTag":"1",
+  "data":[{
+      "keySn": "1234567890",
+      "keyValue":"10",
+      "keyTime":3.2
+    }]
+}
+

抢答题

+

方法

+
startQAQuicker
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传送参数的对象
+keySnsarray是指定的键盘SN数组，空数组表示全部在线键盘
+modeint是模式
0:普通抢答
+allowModifyint是修改模式
0 - 不允许修改
1 - 允许修改
+tipstring否提示的标题，长度不超过16字符
+ +
{
+  "fun": "startQAQuicker",
+  "dataTag":"1",
+  "data":{
+    "keySns":[],
+    "mode": 0,
+    "allowModify":1,
+    "tip":"请按键抢答"
+  }
+}
+
stopQAQuicker
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
+ +
{
+  "fun": "stopQAQuicker",
+  "dataTag":"1"
+}
+

事件

+
sEvtStateCode
+

发送指令后返回接收状态

+
fEvtQAQuicker
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataarray-是传送参数的对象数组
++keySnstring是键盘SN
++keyValuestring是键盘提交的按键值
++keyTimedouble是答题时间，从启动开始计算，单位秒
+ +
{
+  "fun": "fEvtQAQuicker",
+  "dataTag":"1",
+  "data": [{
+      "keySn": "1234567890",
+      "keyValue":"1",
+      "keyTime":3.2
+    }]
+}
+

在线测验

+

标准测验

+

方法

+
startKpExam
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传送参数的对象
+examNoint是0-9999
=0，新的测验
>0时,与上次启动卷号一致继续测验，不一致进入新的测验
+modeint是显示模式
0-不显示开头
1-显示“Q”开头
2-显示“题”开头
+questionsarray是题目详情
++symbolstring是题号前缀,可为空
++quesTypeint是题目类型
1:单选
2:多选（排序）
3:数字
4:判断
++optionint是选项数目
quesType = 1 有效。
quesType = 2 有效。
此项缺省时 默认4;
范围：1-10。
++startNoint是起始题号
++countint是题目数量
+ +

常用样例：一级题型 + 显示“Q”开头, 单一题型，全单选题共10题

+
{
+  "fun":"startKpExam",
+  "dataTag":"1",
+  "data":{
+    "mode": 1,
+    "examNo": 1,
+    "questions": [{          
+        "quesType": 1,  //单选题
+        "startNo": 1,  //题号从1开始
+        "count":10  //连续10题
+      }]
+  }
+}
+

指令样例：一级题型 + 不显示开头，总题数6题

+
{
+  "fun":"startKpExam",
+  "dataTag":"1",
+  "data":{
+    "mode": 0,
+    "examNo": 1,
+    //第1、2题单选题，第3、4题多选题，第5题数字，第6题判断，共6题
+    "questions": [{ 
+        "quesType": 1,  //单选题
+        "startNo": 1,  //题号从1开始
+        "count":2  //连续2题
+      },{
+        "quesType": 2,  //多选题
+        "startNo": 3,  //题号从3开始
+        "count":2,  //连续2题
+        "option":5   
+      },{
+        "quesType": 1,  //数字题
+        "startNo": 5,  //题号从5开始
+        "count":1  //连续1题
+      },{
+        "quesType": 4,  //判断题
+        "startNo": 6,  //题号从6开始
+        "count":1  //连续1题
+      }]
+  }
+}
+

指令样例：二级题型 + 不显示开头，总题数6题

+
{
+  "fun":"startKpExam",
+  "dataTag":"1",
+  "data":{
+    "mode": 0,
+    "examNo": 1,
+    //第1-1、1-2题单选题，第2-1、2-2题多选题，第3-1题数字，第4-1题判断，共6题
+    "questions": [{        
+        "symbol": "1-",  
+        "quesType": 1,  //单选题
+        "startNo": 1,  //题号从1-1开始
+        "count":2  //连续2题
+      },{
+        "symbol": "2-", 
+        "quesType": 2,  //多选题
+        "startNo": 1,  //题号从2-1开始
+        "count":2,  //连续2题
+        "option":5 
+      },{
+        "symbol": "3-",
+        "quesType": 3,  //数字题
+        "startNo": 1,  //题号从3-1开始
+        "count":1  //连续1题
+      },{
+        "symbol": "4-",
+        "quesType": 4,  //判断题
+        "startNo": 1,  //题号从4-1开始
+        "count":1  //连续1题
+      }]
+  }
+}
+

指令样例：三级题型 + 不显示开头，总题数6题

+
{
+  "fun":"startKpExam",
+  "dataTag":"1",
+  "data":{
+    "mode": 0,
+    "examNo": 1,
+    //第1-1-1、1-1-2题单选题，第1-2-1、1-2-2题多选题，第2-1-1题数字，第3-1-1题判断，共6题
+    "questions": [{        
+        "symbol": "1-1-",  
+        "quesType": 1,  //单选题
+        "startNo": 1,  //题号从1-1-1开始
+        "count":2  //连续2题
+      },{
+        "symbol": "1-2-", 
+        "quesType": 2,  //多选题
+        "startNo": 1,  //题号从1-2-1开始
+        "count":2,  //连续2题
+        "option":5 
+      },{
+        "symbol": "2-1-",
+        "quesType": 3,  //数字题
+        "startNo": 1,  //题号从2-1-1开始
+        "count":1  //连续1题
+      },{
+        "symbol": "3-1-",
+        "quesType": 4,  //判断题
+        "startNo": 1,  //题号从3-1-1开始
+        "count":1  //连续1题
+      }]
+  }
+}
+

指令样例：一级题型 + 显示“Q”开头, 共6题

+
{
+  "fun":"startKpExam",
+  "dataTag":"1",
+  "data":{
+    "mode": 1,
+    "examNo": 1,
+    "questions": [{  
+        "quesType": 1,  //单选题
+        "startNo": 1,  //题号从1开始
+        "count":2  //连续2题
+      },{
+        "quesType": 2,  //多选题
+        "startNo": 3,  //题号从3开始
+        "count":2,  //连续2题
+        "option":5   
+      },{
+        "quesType": 1,  //数字题
+        "startNo": 5,  //题号从5开始
+        "count":1  //连续1题
+      },{
+        "quesType": 4,  //判断题
+        "startNo": 6,  //题号从6开始
+        "count":1  //连续1题
+      }]
+  }
+}
+

指令样例：一级题型 + 显示“题”开头, 共6题

+
{
+  "fun": "startKpExam",
+  "dataTag":"1",
+  "data":{
+    "mode": 2,
+    "examNo": 1,
+    "questions": [{ 
+        "quesType": 1,  //单选题
+        "startNo": 1,  //题号从1开始
+        "count":2  //连续2题
+      },{
+        "quesType": 2,  //多选题
+        "startNo": 3,  //题号从3开始
+        "count":2,  //连续2题
+        "option":5   
+      },{
+        "quesType": 1,  //数字题
+        "startNo": 5,  //题号从5开始
+        "count":1  //连续1题
+      },{
+        "quesType": 4,  //判断题
+        "startNo": 6,  //题号从6开始
+        "count":1  //连续1题
+      }]
+  }
+}
+
stopKpExam
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
+ +
{
+  "fun": "stopKpExam",
+  "dataTag":"1"
+}
+
rtKpAllowEdited
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制是否必填说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataobject-是传送参数的对象
+keySnsarray是指定的键盘SN数组，空数组表示全部在线键盘
+ +
{
+  "fun": "rtKpAllowEdited",
+  "dataTag":"1",
+  "data":{
+    "keySns":["1234567890","1234567891"]
+  }
+}
+

事件

+
sEvtStateCode
+

发送指令后返回接收状态

+
fEvtKpExam
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataarray-是传送参数的对象数组
++keySnstring是键盘SN
++keyValuestring是键盘提交的按键值,1:A;2:B表示第1题提交A，第二题提交B
++keyTimedouble是答题时间，从启动开始计算，单位秒
+ +
{
+  "fun": "fEvtKpExam",
+  "dataTag":"1",
+  "data": [{
+      "keySn": "1234567890",
+      "keyValue":"1:A;2:B",
+      "keyTime":3.2
+    },
+    {
+      "keySn": "1234567891",
+      "keyValue":"1:B;2:B",
+      "keyTime":3.5
+    }
+  ]
+}
+
fEvtFinalSubmit
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型限制非空说明
funstring-是指令名称
dataTagstring-否数据包标识,可为空字符串
dataarray-是传送参数的对象数组
++keySnstring是键盘SN
++keyValuestring是0 - 未提交(提交完成后，允许键盘修改答案时上报)
1 - 已交卷
++keyTimedouble是提交时间，从启动开始计算，单位秒
+ +
{
+  "fun": "fEvtFinalSubmit",
+  "dataTag":"1",
+  "data": [{
+      "keySn": "1234567890",
+      "keyValue":"1",
+      "keyTime":3.2
+    }]
+}
+
+
+ +
+ + + + + + + + \ No newline at end of file