快速下发类键盘执行结果拆回具体的方法中，这样更直观一些，定义测验的examNo=0时，基站启动新的测验，>0时根据examNo决定是否继续答题

刘琴
1 parent ae89f743
Showing 1 changed file with 131 additions and 48 deletions
通讯协议-B200W-MQTT协议[内部].md
@@ -92,7 +92,7 @@
 |<font color="red">识别设置 - 识别模式(内)|<font color="red">获取键盘识别模式(内)|[getKpIdentityMode](#getkpidentitymode)|[fEvtKpIdentityMode](#fevtkpidentitymode)|
 ||<font color="red">设置键盘识别模式(内)|[setKpIdentityMode](#setkpidentitymode)|[fEvtKpIdentityMode](#fevtkpidentitymode)|
 |交互设置 - 用户内置状态语|设置用户内置状态语|[setKpUserStbMsg](#setkpuserstbmsg)|[fEvtKpUserStbMsg](#fevtkpuserstbmsg)|
-|交互设置 - 用户实时提示信息|实时设置提示反馈信息|[rtSetKpUserPrompt](#rtsetkpuserprompt)|[sEvtStateCode](#sevtstatecode)<br>[sEvtKpExecState](#sevtkpexecstate)|
+|交互设置 - 用户实时提示信息|实时设置提示反馈信息|[rtSetKpUserPrompt](#rtsetkpuserprompt)|[sEvtStateCode](#sevtstatecode)<br>[fEvtSetKpUserPrompt](#fevtsetkpuserprompt)|
 |在线状态获取|开启扫描在线键盘|[startGetKpOnline](#startgetkponline)|[sEvtStateCode](#sevtstatecode)<br>[sEvtBsKpOnlineMsg](#sevtbskponlinemsg)|
 ||停止扫描在线键盘|[stopGetKpOnline](#stopgetkponline)|[sEvtStateCode](#sevtstatecode)|
 |维护功能 - 遥控功能|遥控键盘关机|[remoteKpPowerOff](#remotekppoweroff)|[fEvtRemoteKpPowerOff](#fevtremotekppoweroff)|
@@ -101,14 +101,14 @@
 ### 绑定
 |功能归类|功能|API指令|指令事件|
 |---|---|---|---|
-|无线绑定|设置绑定信息到键盘|[rtSetKpBindingInfo](#rtsetkpbindinginfo)|[sEvtStateCode](#sevtstatecode)<br>[sEvtKpExecState](#sevtkpexecstate)|
-||清除键盘绑定信息|[clearKpBindingInfo](#clearkpbindinginfo)|[sEvtStateCode](#sevtstatecode)<br>[sEvtKpExecState](#sevtkpexecstate)|
+|无线绑定|设置绑定信息到键盘|[rtSetKpBindingInfo](#rtsetkpbindinginfo)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpBindingInfo](#fevtkpbindinginfo)|
+||清除键盘绑定信息|[clearKpBindingInfo](#clearkpbindinginfo)|[sEvtStateCode](#sevtstatecode)<br>[fEvtClearKpBindingInfo](#fevtclearkpbindinginfo)|
 ### 签到
 |功能归类|功能|API指令|指令事件|
 |---|---|---|---|
 |随时签到|启动随时签到|[rtStartKpSignIn](#rtstartkpsignin)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpSignIn](#fevtkpsignin)|
 ||停止随时签到|[rtStopKpSignIn](#rtstopkpsignin)|[sEvtStateCode](#sevtstatecode)|
-||实时PIN签到授权|[rtSetKpLoginAllowed](#rtsetkploginallowed)|[sEvtStateCode](#sevtstatecode)<br>[sEvtKpExecState](#sevtkpexecstate)|
+||实时PIN签到授权|[rtSetKpLoginAllowed](#rtsetkploginallowed)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpLoginAllowed](#fevtkploginallowed)|
 ### 按键反馈
 |功能归类|功能|API指令|指令事件|
 |---|---|---|---|
@@ -126,7 +126,7 @@
 |标准测验|启动标准测验|[startKpExam](#startkpexam)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpExam](#fevtkpexam)<br>[fEvtFinalSubmit](#fevtfinalsubmit)|
 ||停止标准测验|[stopKpExam](#stopkpexam)|[sEvtStateCode](#sevtstatecode)|
 ||刷新作答数据|[rtGetKpExamData](#rtgetkpexamdata)|[fEvtKpExam](#fevtkpexam)|
-||允许键盘提交后退回修改|[rtAllowEdited](#rtkpallowedited)|[sEvtStateCode](#sevtstatecode)<br>[sEvtKpExecState](#sevtkpexecstate)|
+||允许键盘提交后退回修改|[rtAllowEdited](#rtkpallowedited)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpAllowEdited](#fevtkpallowedited)|
 ## 公共事件
 ### sEvtBsConnectState
@@ -279,39 +279,6 @@
     }
 }
 ```
-
-### sEvtKpExecState
-- **主题**: /basestation/\${baseSN}/receive
-- **功能描述**：返回基站接收指令后对键盘设置的是否成功
-- **参数说明**
-
-|参数名|类型|限制|非空|说明|
-|---|---|---|---|---|
-|fun|string|-|是|事件名称|
-|dataTag|string|-|否|数据包标识|
-|data|object|-|是|传送参数的对象|
-|+funName|string||是|指令名称|
-|+states|array||是|返回键盘的执行结果|
-|++keySn|string||是|键盘sn|
-|++state|int||是|0-成功<br>1-失败|
-
-- **示例代码**
-```Json
-{
-    "fun":"sEvtKpExecState",
-    "dataTag":"1",
-    "data":{ 
-        "funName":"clearKpBindingInfo",
-        "states":[
-          {
-            "keySn":"1234567890",
-            "state":0
-          }
-        ]
-    }
-}
-```
-
 ## 基站管理
 ### 基站连接
 #### 方法
@@ -1409,6 +1376,9 @@
 }
 ```
 #### 事件
+##### [sEvtStateCode](#sevtstatecode)
+发送指令后返回接收状态
+
 ##### fEvtKpUserStbMsg
 - **主题**：/basestation/\${baseSN}/receive
 - **功能描述**：返回设置状态语的状态
@@ -1431,9 +1401,38 @@
   }
 }
 ```
+##### fEvtSetKpUserPrompt
+- **主题**：/basestation/\${baseSN}/receive
+- **功能描述**：返回实时设置提示语是否成功
+- **参数说明**
-##### [sEvtKpExecState](#sevtkpsetstate)
-
+|参数名|类型|限制|非空|说明|
+|---|---|---|---|---|
+|fun|string|-|是|指令名称|
+|dataTag|string|-|否|数据包标识,可为空字符串|
+|data|array|-|是|传送参数的对象数组|
+|++keySn|string||是|设置提示语信息的键盘SN|
+|++state|string||是|设置的提示语是否成功<br>0 - 成功<br>1 - 失败|
+```json
+{
+  "fun": "fEvtSetKpUserPrompt",
+  "dataTag":"1",
+  "data": [
+    {
+      "keySn": "1479824643",
+      "state": "0"
+    },
+    {
+      "keySn": "1479824645",
+      "state": "0"
+    },
+    {
+      "keySn": "1479824644",
+      "state": "1"
+    }
+  ]
+}
+```
 ### 在线状态
 #### 方法
 ##### startGetKpOnline
@@ -1700,9 +1699,54 @@
 ##### [sEvtStateCode](#sevtstatecode)
 发送指令后返回接收状态
-##### [sEvtKpExecState](#sevtkpexecstate)
-返回键盘执行指令的结果
+##### fEvtKpBindingInfo
+- **主题**：/basestation/\${baseSN}/receive
+- **功能描述**：返回键盘实时设置绑定信息的状态是否成功
+- **参数说明**
+
+|参数名|类型|限制|非空|说明|
+|---|---|---|---|---|
+|fun|string|-|是|指令名称|
+|dataTag|string|-|否|数据包标识,可为空字符串|
+|data|array|-|否|传送参数的对象数组|
+|++keySn|string||是|需要设置绑定信息的键盘SN|
+|++state|string||是|设置的绑定信息是否成功<br>0 - 成功<br>1 - 失败|
+```json
+{
+  "fun": "fEvtKpBindingInfo",
+  "dataTag":"1",
+  "data": [
+    {
+      "keySn": "1479824643",
+      "state": "0"
+    },
+    {
+      "keySn": "1479824644",
+      "state": "1"
+    }
+  ]
+}
+```
+##### fEvtClearKpBindingInfo
+- **主题**：/basestation/\${baseSN}/receive
+- **功能描述**：返回清空绑定信息的指令状态是否成功
+- **参数说明**
+|参数名|类型|限制|非空|说明|
+|---|---|---|---|---|
+|fun|string|-|是|指令名称|
+|dataTag|string|-|否|数据包标识,可为空字符串|
+|data|object|-|否|传送参数的对象|
+|+state|string||是|设置的绑定信息是否成功<br>0 - 成功<br>1 - 失败|
+```json
+{
+  "fun": "fEvtSetKpBindingInfo",
+  "dataTag":"1",
+  "data": {
+    "state": "0"
+  }
+}
+```
 ## 签到
 ### 随时签到
 #### 方法
@@ -1767,9 +1811,6 @@
 ##### [sEvtStateCode](#sevtstatecode)
 发送指令后返回接收状态
-##### [sEvtKpExecState](#sevtkpexecstate)
-返回键盘执行指令的结果
-
 ##### fEvtKpSignIn
 - **主题**：/basestation/\${baseSN}/receive
 - **功能描述**：返回键盘提交签到信息
@@ -1800,6 +1841,28 @@
   ]
 }
 ```
+##### fEvtKpLoginAllowed
+- **主题**：/basestation/\${baseSN}/receive
+- **功能描述**：返回键盘授权状态
+- **参数说明**
+
+|参数名|类型|限制|非空|说明|
+|---|---|---|---|---|
+|fun|string|-|是|指令名称|
+|dataTag|string|-|否|数据包标识,可为空字符串|
+|data|object|-|是|传送参数的对象|
+|+keySn|string||是|键盘SN|
+|+state|string||是|0-执行成功<br> 1-执行失败|
+```json
+{
+  "fun": "fEvtKpLoginAllowed",
+  "dataTag":"1",
+  "data": {
+      "keySn":"1479824643",
+      "state":1
+    }
+}
+```
 ## 按键反馈
 ### 判断题
 #### 方法
@@ -2140,7 +2203,7 @@
 |dataTag|string|-|否|数据包标识,可为空字符串|
 |data|object|-|是|传送参数的对象|
 |+keySns|array||是|指定的键盘SN数组，可空表示全部在线键盘|
-|+examNo|int||是|1-9999|
+|+examNo|int||是|0-9999<br>=0，新的测验<br>>0时,与上次启动卷号一致继续测验，不一致进入新的测验|
 |+mode|int||是|显示模式<br>0-不显示开头<br>1-显示“Q”开头<br>2-显示“题”开头|
 |+questions|array||是|题目详情|
 |++symbol | string||是 | 题号前缀,可为空 |
@@ -2344,5 +2407,25 @@
     }]
 }
 ```
-##### [sEvtKpExecState](#sevtkpexecstate)
-返回键盘执行指令的结果
 \ No newline at end of file
+##### fEvtKpAllowEdited
+- **主题**：/basestation/\${baseSN}/receive
+- **功能描述**：返回允许键盘修改答案状态
+- **参数说明**
+
+|参数名|类型|限制|非空|说明|
+|---|---|---|---|---|
+|fun|string|-|是|指令名称|
+|dataTag|string|-|否|数据包标识,可为空字符串|
+|data|object|-|是|传送参数的对象|
+|+keySn|string||是|键盘SN|
+|+state|int||是|0-成功<br>1-失败|
+```json
+{
+  "fun": "fEvtKpAllowEdited",
+  "dataTag":"1",
+  "data": {
+      "keySn": "1234567890",
+      "state":0
+    }
+}
+```
 \ No newline at end of file