李外 / Protocol

Commit ae89f7436223b6c0836cd5abfd0bc5846cdd3b0c

Authored by 刘琴
1 parent b8b2eb71

修改所有调用方法的返回事件为系统事件，增加所有指定键盘下发的返回事件sEvtKpExecState

Inline Side-by-side
Showing 1 changed file with 81 additions and 490 deletions
通讯协议-B200W-MQTT协议[内部].md
  View file @ae89f74
@@ -92,41 +92,41 @@ @@ -92,41 +92,41 @@
92 |<font color="red">识别设置 - 识别模式(内)|<font color="red">获取键盘识别模式(内)|[getKpIdentityMode](#getkpidentitymode)|[fEvtKpIdentityMode](#fevtkpidentitymode)| 92 |<font color="red">识别设置 - 识别模式(内)|<font color="red">获取键盘识别模式(内)|[getKpIdentityMode](#getkpidentitymode)|[fEvtKpIdentityMode](#fevtkpidentitymode)|
93 ||<font color="red">设置键盘识别模式(内)|[setKpIdentityMode](#setkpidentitymode)|[fEvtKpIdentityMode](#fevtkpidentitymode)| 93 ||<font color="red">设置键盘识别模式(内)|[setKpIdentityMode](#setkpidentitymode)|[fEvtKpIdentityMode](#fevtkpidentitymode)|
94 |交互设置 - 用户内置状态语|设置用户内置状态语|[setKpUserStbMsg](#setkpuserstbmsg)|[fEvtKpUserStbMsg](#fevtkpuserstbmsg)| 94 |交互设置 - 用户内置状态语|设置用户内置状态语|[setKpUserStbMsg](#setkpuserstbmsg)|[fEvtKpUserStbMsg](#fevtkpuserstbmsg)|
95 -|交互设置 - 用户实时提示信息|实时设置提示反馈信息|[rtSetKpUserPrompt](#rtsetkpuserprompt)|[fEvtSetKpUserPrompt](#fevtsetkpuserprompt)|  
96 -|在线状态获取|开启扫描在线键盘|[startGetKpOnline](#startgetkponline)|[fEvtStartGetKpOnline](#fevtstartgetkponline)<br>[sEvtBsKpOnlineMsg](#sevtbskponlinemsg)|  
97 -||停止扫描在线键盘|[stopGetKpOnline](#stopgetkponline)|[fEvtStopGetKpOnline](#fevtstopgetkponline)| 95 +|交互设置 - 用户实时提示信息|实时设置提示反馈信息|[rtSetKpUserPrompt](#rtsetkpuserprompt)|[sEvtStateCode](#sevtstatecode)<br>[sEvtKpExecState](#sevtkpexecstate)|
  96 +|在线状态获取|开启扫描在线键盘|[startGetKpOnline](#startgetkponline)|[sEvtStateCode](#sevtstatecode)<br>[sEvtBsKpOnlineMsg](#sevtbskponlinemsg)|
  97 +||停止扫描在线键盘|[stopGetKpOnline](#stopgetkponline)|[sEvtStateCode](#sevtstatecode)|
98 |维护功能 - 遥控功能|遥控键盘关机|[remoteKpPowerOff](#remotekppoweroff)|[fEvtRemoteKpPowerOff](#fevtremotekppoweroff)| 98 |维护功能 - 遥控功能|遥控键盘关机|[remoteKpPowerOff](#remotekppoweroff)|[fEvtRemoteKpPowerOff](#fevtremotekppoweroff)|
99 ||遥控键盘休眠|[remoteKpSleep](#remotekpsleep)|[fEvtRemoteKpSleep](#fevtremotekpsleep)| 99 ||遥控键盘休眠|[remoteKpSleep](#remotekpsleep)|[fEvtRemoteKpSleep](#fevtremotekpsleep)|
100 |维护功能 - 遥控功能|<font color="red">启动键盘无线升级(内)|[startKpFWUpdate](#startkpfwupdate)|[fEvtStartKpFWUpdate](#fevtstartkpfwupdate)<br>[fEvtKpUpdateProgress](#fevtkpupdateprogress)<br>[sEvtBsKpOnlineMsg](#sevtbskponlinemsg)| 100 |维护功能 - 遥控功能|<font color="red">启动键盘无线升级(内)|[startKpFWUpdate](#startkpfwupdate)|[fEvtStartKpFWUpdate](#fevtstartkpfwupdate)<br>[fEvtKpUpdateProgress](#fevtkpupdateprogress)<br>[sEvtBsKpOnlineMsg](#sevtbskponlinemsg)|
101 ### 绑定 101 ### 绑定
102 |功能归类|功能|API指令|指令事件| 102 |功能归类|功能|API指令|指令事件|
103 |---|---|---|---| 103 |---|---|---|---|
104 -|无线绑定|设置绑定信息到键盘|[rtSetKpBindingInfo](#rtsetkpbindinginfo)|[fEvtSetKpBindingInfo](#fevtsetkpbindinginfo)<br>[fEvtKpBindingInfo](#fevtkpbindinginfo)|  
105 -||清除键盘绑定信息|[clearKpBindingInfo](#clearkpbindinginfo)|[fEvtClearKpBindingInfo](#fevtclearkpbindinginfo)<br>[fEvtKpBindingInfo](#fevtkpbindinginfo)| 104 +|无线绑定|设置绑定信息到键盘|[rtSetKpBindingInfo](#rtsetkpbindinginfo)|[sEvtStateCode](#sevtstatecode)<br>[sEvtKpExecState](#sevtkpexecstate)|
  105 +||清除键盘绑定信息|[clearKpBindingInfo](#clearkpbindinginfo)|[sEvtStateCode](#sevtstatecode)<br>[sEvtKpExecState](#sevtkpexecstate)|
106 ### 签到 106 ### 签到
107 |功能归类|功能|API指令|指令事件| 107 |功能归类|功能|API指令|指令事件|
108 |---|---|---|---| 108 |---|---|---|---|
109 -|随时签到|启动随时签到|[rtStartKpSignIn](#rtstartkpsignin)|[fEvtStartKpSignIn](#fevtstartkpsignin)<br>[fEvtKpSignIn](#fevtkpsignin)|  
110 -||停止随时签到|[rtStopKpSignIn](#rtstopkpsignin)|[fEvtStopKpSignIn](#fevtstopkpsignin)|  
111 -||实时PIN签到授权|[rtSetKpLoginAllowed](#rtsetkploginallowed)|[fEvtSetKpLoginAllowed](#fevtsetkploginallowed)| 109 +|随时签到|启动随时签到|[rtStartKpSignIn](#rtstartkpsignin)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpSignIn](#fevtkpsignin)|
  110 +||停止随时签到|[rtStopKpSignIn](#rtstopkpsignin)|[sEvtStateCode](#sevtstatecode)|
  111 +||实时PIN签到授权|[rtSetKpLoginAllowed](#rtsetkploginallowed)|[sEvtStateCode](#sevtstatecode)<br>[sEvtKpExecState](#sevtkpexecstate)|
112 ### 按键反馈 112 ### 按键反馈
113 |功能归类|功能|API指令|指令事件| 113 |功能归类|功能|API指令|指令事件|
114 |---|---|---|---| 114 |---|---|---|---|
115 -|判断题|启动判断题答题|[startQATrueFalse](#startqatruefalse)|[fEvtStartQATrueFalse](#fevtstartqatruefalse)<br>[fEvtQATrueFalse](#fevtqatruefalse)|  
116 -||停止判断题答题|[stopQATrueFalse](#stopqatruefalse)|[fEvtStopQATrueFalse](#fevtstopqatruefalse)|  
117 -|选择题|启动选择题答题|[startQAChoice](#startqachoice)|[fEvtStartQAChoice](#fevtstartqachoice)<br>[fEvtQAChoice](#fevtqachoice)|  
118 -||停止选择题答题|[stopQAChoice](#stopqachoice)|[fEvtStopQAChoice](#fevtstopqachoice)|  
119 -|数字题|启动数字题答题|[startQANum](#startqanum)|[fEvtStartQANum](#fevtstartqanum)<br>[fEvtQANum](#fevtqanum)|  
120 -||停止数字题答题|[stopQANum](#stopqanum)|[fEvtStopQANum](#fevtstopqanum)|  
121 -|抢答题|启动抢答题答题|[startQAQuicker](#startqaquicker)|[fEvtStartQAQuicker](#fevtstartqaquicker)<br>[fEvtQAQuicker](#fevtqaquicker)|  
122 -||停止抢答题答题|[stopQAQuicker](#stopqaquicker)|[fEvtStopQAQuicker](#fevtstopqaquicker)| 115 +|判断题|启动判断题答题|[startQATrueFalse](#startqatruefalse)|[sEvtStateCode](#sevtstatecode)<br>[fEvtQATrueFalse](#fevtqatruefalse)|
  116 +||停止判断题答题|[stopQATrueFalse](#stopqatruefalse)|[sEvtStateCode](#sevtstatecode)|
  117 +|选择题|启动选择题答题|[startQAChoice](#startqachoice)|[sEvtStateCode](#sevtstatecode)<br>[fEvtQAChoice](#fevtqachoice)|
  118 +||停止选择题答题|[stopQAChoice](#stopqachoice)|[sEvtStateCode](#sevtstatecode)|
  119 +|数字题|启动数字题答题|[startQANum](#startqanum)|[sEvtStateCode](#sevtstatecode)<br>[fEvtQANum](#fevtqanum)|
  120 +||停止数字题答题|[stopQANum](#stopqanum)|[sEvtStateCode](#sevtstatecode)|
  121 +|抢答题|启动抢答题答题|[startQAQuicker](#startqaquicker)|[sEvtStateCode](#sevtstatecode)<br>[fEvtQAQuicker](#fevtqaquicker)|
  122 +||停止抢答题答题|[stopQAQuicker](#stopqaquicker)|[sEvtStateCode](#sevtstatecode)|
123 ### 在线测验 123 ### 在线测验
124 |功能归类|功能|API指令|指令事件| 124 |功能归类|功能|API指令|指令事件|
125 |---|---|---|---| 125 |---|---|---|---|
126 -|标准测验|启动标准测验|[startKpExam](#startkpexam)|[fEvtStartKpExam](#fevtstartkpexam)<br>[fEvtKpExam](#fevtkpexam)<br>[fEvtFinalSubmit](#fevtfinalsubmit)|  
127 -||停止标准测验|[stopKpExam](#stopkpexam)|[fEvtStopKpExam](#fevtstopkpexam)| 126 +|标准测验|启动标准测验|[startKpExam](#startkpexam)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpExam](#fevtkpexam)<br>[fEvtFinalSubmit](#fevtfinalsubmit)|
  127 +||停止标准测验|[stopKpExam](#stopkpexam)|[sEvtStateCode](#sevtstatecode)|
128 ||刷新作答数据|[rtGetKpExamData](#rtgetkpexamdata)|[fEvtKpExam](#fevtkpexam)| 128 ||刷新作答数据|[rtGetKpExamData](#rtgetkpexamdata)|[fEvtKpExam](#fevtkpexam)|
129 -||允许键盘提交后退回修改|[rtAllowEdited](#rtkpallowedited)|[fEvtRtAllowEdited](#fevtrtallowedited)<br>[fEvtAllowEdited](#fevtallowedited)| 129 +||允许键盘提交后退回修改|[rtAllowEdited](#rtkpallowedited)|[sEvtStateCode](#sevtstatecode)<br>[sEvtKpExecState](#sevtkpexecstate)|
130 130
131 ## 公共事件 131 ## 公共事件
132 ### sEvtBsConnectState 132 ### sEvtBsConnectState
@@ -241,9 +241,9 @@ @@ -241,9 +241,9 @@
241 } 241 }
242 } 242 }
243 ``` 243 ```
244 -### sEvtErrorCode 244 +### sEvtStateCode
245 - **主题**: /basestation/\${baseSN}/receive 245 - **主题**: /basestation/\${baseSN}/receive
246 -- **功能描述**：返回错误信息，调用方法后如果出错则返回此事件 246 +- **功能描述**：返回基站接收指令状态信息
247 - **参数说明** 247 - **参数说明**
248 248
249 |参数名|类型|限制|非空|说明| 249 |参数名|类型|限制|非空|说明|
@@ -251,11 +251,12 @@ @@ -251,11 +251,12 @@
251 |fun|string|-|是|事件名称| 251 |fun|string|-|是|事件名称|
252 |dataTag|string|-|否|数据包标识| 252 |dataTag|string|-|否|数据包标识|
253 |data|object|-|是|传送参数的对象| 253 |data|object|-|是|传送参数的对象|
254 -|+funName|string||是|出错的指令名称|  
255 -|+code|string||是|错误码，含义见下表| 254 +|+funName|string||是|指令名称|
  255 +|+code|string||是|状态码，含义见下表|
256 256
257 |错误码|说明| 257 |错误码|说明|
258 |---|---| 258 |---|---|
  259 +|0|指令收取成功|
259 |10001|不能正确解析的JSON数据| 260 |10001|不能正确解析的JSON数据|
260 |10002|解析JSON错误| 261 |10002|解析JSON错误|
261 |20001|基站未连接| 262 |20001|基站未连接|
@@ -263,9 +264,6 @@ @@ -263,9 +264,6 @@
263 |20003|基站SN格式不正确| 264 |20003|基站SN格式不正确|
264 |20004|参数错误| 265 |20004|参数错误|
265 |20005|基站在答题中| 266 |20005|基站在答题中|
266 -|30001|找不到对应的SN|  
267 -|30002|找不到对应的BaseID|  
268 -|30003|基站SN不是对应的BaseID|  
269 |40001|升级功能只能支持一个基站| 267 |40001|升级功能只能支持一个基站|
270 |50001|此功能必须指定基站| 268 |50001|此功能必须指定基站|
271 |60001|此功能必须指定键盘SN| 269 |60001|此功能必须指定键盘SN|
@@ -273,7 +271,7 @@ @@ -273,7 +271,7 @@
273 - **示例代码** 271 - **示例代码**
274 ```Json 272 ```Json
275 { 273 {
276 - "fun":"sEvtErrorCode", 274 + "fun":"sEvtStateCode",
277 "dataTag":"1", 275 "dataTag":"1",
278 "data":{ 276 "data":{
279 "funName":"startKpRollCall", 277 "funName":"startKpRollCall",
@@ -282,6 +280,38 @@ @@ -282,6 +280,38 @@
282 } 280 }
283 ``` 281 ```
284 282
  283 +### sEvtKpExecState
  284 +- **主题**: /basestation/\${baseSN}/receive
  285 +- **功能描述**：返回基站接收指令后对键盘设置的是否成功
  286 +- **参数说明**
  287 +
  288 +|参数名|类型|限制|非空|说明|
  289 +|---|---|---|---|---|
  290 +|fun|string|-|是|事件名称|
  291 +|dataTag|string|-|否|数据包标识|
  292 +|data|object|-|是|传送参数的对象|
  293 +|+funName|string||是|指令名称|
  294 +|+states|array||是|返回键盘的执行结果|
  295 +|++keySn|string||是|键盘sn|
  296 +|++state|int||是|0-成功<br>1-失败|
  297 +
  298 +- **示例代码**
  299 +```Json
  300 +{
  301 + "fun":"sEvtKpExecState",
  302 + "dataTag":"1",
  303 + "data":{
  304 + "funName":"clearKpBindingInfo",
  305 + "states":[
  306 + {
  307 + "keySn":"1234567890",
  308 + "state":0
  309 + }
  310 + ]
  311 + }
  312 +}
  313 +```
  314 +
285 ## 基站管理 315 ## 基站管理
286 ### 基站连接 316 ### 基站连接
287 #### 方法 317 #### 方法
@@ -1402,61 +1432,8 @@ @@ -1402,61 +1432,8 @@
1402 } 1432 }
1403 ``` 1433 ```
1404 1434
1405 -##### fEvtRtSetKpUserPrompt  
1406 -- **主题**：/basestation/\${baseSN}/receive  
1407 -- **功能描述**：返回实时设置提示语指令是否接收成功  
1408 -- **参数说明** 1435 +##### [sEvtKpExecState](#sevtkpsetstate)
1409 1436
1410 -|参数名|类型|限制|非空|说明|  
1411 -|---|---|---|---|---|  
1412 -|fun|string|-|是|指令名称|  
1413 -|dataTag|string|-|否|数据包标识,可为空字符串|  
1414 -|data|object|-|否|传送参数的对象|  
1415 -|+state|string||是|实时设置提示语指令是否接收成功<br> 0 - 成功<br> 1 - 失败|  
1416 -  
1417 -- **示例代码**  
1418 -```Json  
1419 -{  
1420 - "fun":"fEvtRtSetKpUserPrompt",  
1421 - "dataTag":"1",  
1422 - "data":{  
1423 - "state":"0"  
1424 - }  
1425 -}  
1426 -```  
1427 -  
1428 -##### fEvtSetKpUserPrompt  
1429 -- **主题**：/basestation/\${baseSN}/receive  
1430 -- **功能描述**：返回实时设置提示语是否成功  
1431 -- **参数说明**  
1432 -  
1433 -|参数名|类型|限制|非空|说明|  
1434 -|---|---|---|---|---|  
1435 -|fun|string|-|是|指令名称|  
1436 -|dataTag|string|-|否|数据包标识,可为空字符串|  
1437 -|data|array|-|是|传送参数的对象数组|  
1438 -|++keySn|string||是|设置提示语信息的键盘SN|  
1439 -|++state|string||是|设置的提示语是否成功<br>0 - 成功<br>1 - 失败|  
1440 -```json  
1441 -{  
1442 - "fun": "fEvtSetKpUserPrompt",  
1443 - "dataTag":"1",  
1444 - "data": [  
1445 - {  
1446 - "keySn": "1479824643",  
1447 - "state": "0"  
1448 - },  
1449 - {  
1450 - "keySn": "1479824645",  
1451 - "state": "0"  
1452 - },  
1453 - {  
1454 - "keySn": "1479824644",  
1455 - "state": "1"  
1456 - }  
1457 - ]  
1458 -}  
1459 -```  
1460 ### 在线状态 1437 ### 在线状态
1461 #### 方法 1438 #### 方法
1462 ##### startGetKpOnline 1439 ##### startGetKpOnline
@@ -1491,47 +1468,8 @@ @@ -1491,47 +1468,8 @@
1491 } 1468 }
1492 ``` 1469 ```
1493 #### 事件 1470 #### 事件
1494 -##### fEvtStartGetKpOnline  
1495 -- **主题**：/basestation/\${baseSN}/receive  
1496 -- **功能描述**：返回启动扫描在线键盘状态  
1497 -- **参数说明**  
1498 -  
1499 -|参数名|类型|限制|非空|说明|  
1500 -|---|---|---|---|---|  
1501 -|fun|string|-|是|指令名称|  
1502 -|dataTag|string|-|否|数据包标识,可为空字符串|  
1503 -|data|object|-|是|传送参数的对象|  
1504 -|+state|int||是|启动状态<br>0 - 成功<br>1 - 失败|  
1505 -```json  
1506 -{  
1507 - "fun": "fEvtStartGetKpOnline",  
1508 - "dataTag":"1",  
1509 - "data": {  
1510 - "state": 0  
1511 - }  
1512 -}  
1513 -```  
1514 -  
1515 -##### fEvtStopGetKpOnline  
1516 -- **主题**：/basestation/\${baseSN}/receive  
1517 -- **功能描述**：返回停止扫描在线键盘状态  
1518 -- **参数说明**  
1519 -  
1520 -|参数名|类型|限制|非空|说明|  
1521 -|---|---|---|---|---|  
1522 -|fun|string|-|是|指令名称|  
1523 -|dataTag|string|-|否|数据包标识,可为空字符串|  
1524 -|data|object|-|是|传送参数的对象|  
1525 -|+state|int||是|启动状态<br>0 - 成功<br>1 - 失败|  
1526 -```json  
1527 -{  
1528 - "fun": "fEvtStopGetKpOnline",  
1529 - "dataTag":"1",  
1530 - "data": {  
1531 - "state": 0  
1532 - }  
1533 -}  
1534 -``` 1471 +##### [sEvtStateCode](#sevtstatecode)
  1472 +发送指令后返回此事件
1535 1473
1536 ##### [sEvtBsKpOnlineMsg](#sevtbskponlinemsg) 1474 ##### [sEvtBsKpOnlineMsg](#sevtbskponlinemsg)
1537 键盘在线返回此事件 1475 键盘在线返回此事件
@@ -1759,74 +1697,12 @@ @@ -1759,74 +1697,12 @@
1759 } 1697 }
1760 ``` 1698 ```
1761 #### 事件 1699 #### 事件
1762 -##### fEvtSetKpBindingInfo  
1763 -- **主题**：/basestation/\${baseSN}/receive  
1764 -- **功能描述**：返回实时设置绑定信息的指令接收状态  
1765 -- **参数说明** 1700 +##### [sEvtStateCode](#sevtstatecode)
  1701 +发送指令后返回接收状态
1766 1702
1767 -|参数名|类型|限制|非空|说明|  
1768 -|---|---|---|---|---|  
1769 -|fun|string|-|是|指令名称|  
1770 -|dataTag|string|-|否|数据包标识,可为空字符串|  
1771 -|data|object|-|否|传送参数的对象|  
1772 -|+state|string||是|设置的绑定信息是否接收成功<br>0 - 成功<br>1 - 失败|  
1773 -```json  
1774 -{  
1775 - "fun": "fEvtSetKpBindingInfo",  
1776 - "dataTag":"1",  
1777 - "data": {  
1778 - "state": "0"  
1779 - }  
1780 -}  
1781 -```  
1782 -##### fEvtKpBindingInfo  
1783 -- **主题**：/basestation/\${baseSN}/receive  
1784 -- **功能描述**：返回键盘实时设置绑定信息的状态是否成功  
1785 -- **参数说明**  
1786 -  
1787 -|参数名|类型|限制|非空|说明|  
1788 -|---|---|---|---|---|  
1789 -|fun|string|-|是|指令名称|  
1790 -|dataTag|string|-|否|数据包标识,可为空字符串|  
1791 -|data|array|-|否|传送参数的对象数组|  
1792 -|++keySn|string||是|需要设置绑定信息的键盘SN|  
1793 -|++state|string||是|设置的绑定信息是否成功<br>0 - 成功<br>1 - 失败|  
1794 -```json  
1795 -{  
1796 - "fun": "fEvtKpBindingInfo",  
1797 - "dataTag":"1",  
1798 - "data": [  
1799 - {  
1800 - "keySn": "1479824643",  
1801 - "state": "0"  
1802 - },  
1803 - {  
1804 - "keySn": "1479824644",  
1805 - "state": "1"  
1806 - }  
1807 - ]  
1808 -}  
1809 -```  
1810 -##### fEvtClearKpBindingInfo  
1811 -- **主题**：/basestation/\${baseSN}/receive  
1812 -- **功能描述**：返回清空绑定信息的指令状态是否成功  
1813 -- **参数说明** 1703 +##### [sEvtKpExecState](#sevtkpexecstate)
  1704 +返回键盘执行指令的结果
1814 1705
1815 -|参数名|类型|限制|非空|说明|  
1816 -|---|---|---|---|---|  
1817 -|fun|string|-|是|指令名称|  
1818 -|dataTag|string|-|否|数据包标识,可为空字符串|  
1819 -|data|object|-|否|传送参数的对象|  
1820 -|+state|string||是|设置的绑定信息是否成功<br>0 - 成功<br>1 - 失败|  
1821 -```json  
1822 -{  
1823 - "fun": "fEvtSetKpBindingInfo",  
1824 - "dataTag":"1",  
1825 - "data": {  
1826 - "state": "0"  
1827 - }  
1828 -}  
1829 -```  
1830 ## 签到 1706 ## 签到
1831 ### 随时签到 1707 ### 随时签到
1832 #### 方法 1708 #### 方法
@@ -1888,26 +1764,12 @@ @@ -1888,26 +1764,12 @@
1888 } 1764 }
1889 ``` 1765 ```
1890 #### 事件 1766 #### 事件
1891 -##### fEvtStartKpSignIn  
1892 -- **主题**：/basestation/\${baseSN}/receive  
1893 -- **功能描述**：返回启动随时签到绑定状态  
1894 -- **参数说明** 1767 +##### [sEvtStateCode](#sevtstatecode)
  1768 +发送指令后返回接收状态
  1769 +
  1770 +##### [sEvtKpExecState](#sevtkpexecstate)
  1771 +返回键盘执行指令的结果
1895 1772
1896 -|参数名|类型|限制|非空|说明|  
1897 -|---|---|---|---|---|  
1898 -|fun|string|-|是|指令名称|  
1899 -|dataTag|string|-|否|数据包标识,可为空字符串|  
1900 -|data|object|-|是|传送参数的对象|  
1901 -|+state|int||是|启动状态<br>0 - 成功<br>1 - 失败|  
1902 -```json  
1903 -{  
1904 - "fun": "fEvtStartKpSignIn",  
1905 - "dataTag":"1",  
1906 - "data": {  
1907 - "state": 0  
1908 - }  
1909 -}  
1910 -```  
1911 ##### fEvtKpSignIn 1773 ##### fEvtKpSignIn
1912 - **主题**：/basestation/\${baseSN}/receive 1774 - **主题**：/basestation/\${baseSN}/receive
1913 - **功能描述**：返回键盘提交签到信息 1775 - **功能描述**：返回键盘提交签到信息
@@ -1938,49 +1800,6 @@ @@ -1938,49 +1800,6 @@
1938 ] 1800 ]
1939 } 1801 }
1940 ``` 1802 ```
1941 -##### fEvtStopKpSignIn  
1942 -- **主题**：/basestation/\${baseSN}/receive  
1943 -- **功能描述**：返回停止异步绑定状态  
1944 -- **参数说明**  
1945 -  
1946 -|参数名|类型|限制|非空|说明|  
1947 -|---|---|---|---|---|  
1948 -|fun|string|-|是|指令名称|  
1949 -|dataTag|string|-|否|数据包标识,可为空字符串|  
1950 -|data|object|-|是|传送参数的对象|  
1951 -|+state|int||是|启动状态<br>0 - 成功<br>1 - 失败|  
1952 -```json  
1953 -{  
1954 - "fun": "fEvtStopKpSignIn",  
1955 - "dataTag":"1",  
1956 - "data": {  
1957 - "state": 0  
1958 - }  
1959 -}  
1960 -```  
1961 -##### fEvtSetKpLoginAllowed  
1962 -- **主题**：/basestation/\${baseSN}/receive  
1963 -- **功能描述**：返回键盘授权状态  
1964 -- **参数说明**  
1965 -  
1966 -|参数名|类型|限制|非空|说明|  
1967 -|---|---|---|---|---|  
1968 -|fun|string|-|是|指令名称|  
1969 -|dataTag|string|-|否|数据包标识,可为空字符串|  
1970 -|data|object|-|是|传送参数的对象|  
1971 -|+keySn|string||是|键盘SN|  
1972 -|+state|string||是|1-授权成功<br>2-授权失败<br>3-解除已授权|  
1973 -```json  
1974 -{  
1975 - "fun": "fEvtSetKpLoginAllowed",  
1976 - "dataTag":"1",  
1977 - "data": {  
1978 - "keySn":"1479824643",  
1979 - "state":1  
1980 - }  
1981 -}  
1982 -```  
1983 -  
1984 ## 按键反馈 1803 ## 按键反馈
1985 ### 判断题 1804 ### 判断题
1986 #### 方法 1805 #### 方法
@@ -2033,26 +1852,9 @@ @@ -2033,26 +1852,9 @@
2033 } 1852 }
2034 ``` 1853 ```
2035 #### 事件 1854 #### 事件
2036 -##### fEvtStartQATrueFalse  
2037 -- **主题**：/basestation/\${baseSN}/receive  
2038 -- **功能描述**：返回启动判断题状态  
2039 -- **参数说明** 1855 +##### [sEvtStateCode](#sevtstatecode)
  1856 +发送指令后返回接收状态
2040 1857
2041 -|参数名|类型|限制|非空|说明|  
2042 -|---|---|---|---|---|  
2043 -|fun|string|-|是|指令名称|  
2044 -|dataTag|string|-|否|数据包标识,可为空字符串|  
2045 -|data|object|-|是|传送参数的对象|  
2046 -|+state|int||是|启动状态<br>0 - 成功<br>1 - 失败|  
2047 -```json  
2048 -{  
2049 - "fun": "fEvtStartQATrueFalse",  
2050 - "dataTag":"1",  
2051 - "data": {  
2052 - "state": 0  
2053 - }  
2054 -}  
2055 -```  
2056 ##### fEvtQATrueFalse 1858 ##### fEvtQATrueFalse
2057 - **主题**：/basestation/\${baseSN}/receive 1859 - **主题**：/basestation/\${baseSN}/receive
2058 - **功能描述**：返回键盘提交答题信息 1860 - **功能描述**：返回键盘提交答题信息
@@ -2078,26 +1880,6 @@ @@ -2078,26 +1880,6 @@
2078 ] 1880 ]
2079 } 1881 }
2080 ``` 1882 ```
2081 -##### fEvtStopQATrueFalse  
2082 -- **主题**：/basestation/\${baseSN}/receive  
2083 -- **功能描述**：返回停止判断题状态  
2084 -- **参数说明**  
2085 -  
2086 -|参数名|类型|限制|非空|说明|  
2087 -|---|---|---|---|---|  
2088 -|fun|string|-|是|指令名称|  
2089 -|dataTag|string|-|否|数据包标识,可为空字符串|  
2090 -|data|object|-|是|传送参数的对象|  
2091 -|+state|int||是|停止状态<br>0 - 成功<br>1 - 失败|  
2092 -```json  
2093 -{  
2094 - "fun": "fEvtStopQATrueFalse",  
2095 - "dataTag":"1",  
2096 - "data": {  
2097 - "state": 0  
2098 - }  
2099 -}  
2100 -```  
2101 ### 选择题 1883 ### 选择题
2102 #### 方法 1884 #### 方法
2103 ##### startQAChoice 1885 ##### startQAChoice
@@ -2157,26 +1939,9 @@ @@ -2157,26 +1939,9 @@
2157 } 1939 }
2158 ``` 1940 ```
2159 #### 事件 1941 #### 事件
2160 -##### fEvtStartQAChoice  
2161 -- **主题**：/basestation/\${baseSN}/receive  
2162 -- **功能描述**：返回启动选择题状态  
2163 -- **参数说明** 1942 +##### [sEvtStateCode](#sevtstatecode)
  1943 +发送指令后返回接收状态
2164 1944
2165 -|参数名|类型|限制|非空|说明|  
2166 -|---|---|---|---|---|  
2167 -|fun|string|-|是|指令名称|  
2168 -|dataTag|string|-|否|数据包标识,可为空字符串|  
2169 -|data|object|-|是|传送参数的对象|  
2170 -|+state|int||是|启动状态<br>0 - 成功<br>1 - 失败|  
2171 -```json  
2172 -{  
2173 - "fun": "fEvtStartQAChoice",  
2174 - "dataTag":"1",  
2175 - "data": {  
2176 - "state": 0  
2177 - }  
2178 -}  
2179 -```  
2180 ##### fEvtQAChoice 1945 ##### fEvtQAChoice
2181 - **主题**：/basestation/\${baseSN}/receive 1946 - **主题**：/basestation/\${baseSN}/receive
2182 - **功能描述**：返回键盘提交答题信息 1947 - **功能描述**：返回键盘提交答题信息
@@ -2201,26 +1966,6 @@ @@ -2201,26 +1966,6 @@
2201 }] 1966 }]
2202 } 1967 }
2203 ``` 1968 ```
2204 -##### fEvtstopQAChoice  
2205 -- **主题**：/basestation/\${baseSN}/receive  
2206 -- **功能描述**：返回停止选择题状态  
2207 -- **参数说明**  
2208 -  
2209 -|参数名|类型|限制|非空|说明|  
2210 -|---|---|---|---|---|  
2211 -|fun|string|-|是|指令名称|  
2212 -|dataTag|string|-|否|数据包标识,可为空字符串|  
2213 -|data|object|-|是|传送参数的对象|  
2214 -|+state|int||是|停止状态<br>0 - 成功<br>1 - 失败|  
2215 -```json  
2216 -{  
2217 - "fun": "fEvtstopQAChoice",  
2218 - "dataTag":"1",  
2219 - "data": {  
2220 - "state": 0  
2221 - }  
2222 -}  
2223 -```  
2224 ### 数字题 1969 ### 数字题
2225 #### 方法 1970 #### 方法
2226 ##### startQANum 1971 ##### startQANum
@@ -2278,26 +2023,9 @@ @@ -2278,26 +2023,9 @@
2278 } 2023 }
2279 ``` 2024 ```
2280 #### 事件 2025 #### 事件
2281 -##### fEvtStartQANum  
2282 -- **主题**：/basestation/\${baseSN}/receive  
2283 -- **功能描述**：返回启动数字题状态  
2284 -- **参数说明** 2026 +##### [sEvtStateCode](#sevtstatecode)
  2027 +发送指令后返回接收状态
2285 2028
2286 -|参数名|类型|限制|非空|说明|  
2287 -|---|---|---|---|---|  
2288 -|fun|string|-|是|指令名称|  
2289 -|dataTag|string|-|否|数据包标识,可为空字符串|  
2290 -|data|object|-|是|传送参数的对象|  
2291 -|+state|int||是|启动状态<br>0 - 成功<br>1 - 失败|  
2292 -```json  
2293 -{  
2294 - "fun": "fEvtStartQANum",  
2295 - "dataTag":"1",  
2296 - "data": {  
2297 - "state": 0  
2298 - }  
2299 -}  
2300 -```  
2301 ##### fEvtQANum 2029 ##### fEvtQANum
2302 - **主题**：/basestation/\${baseSN}/receive 2030 - **主题**：/basestation/\${baseSN}/receive
2303 - **功能描述**：返回键盘提交答题信息 2031 - **功能描述**：返回键盘提交答题信息
@@ -2322,26 +2050,6 @@ @@ -2322,26 +2050,6 @@
2322 } 2050 }
2323 } 2051 }
2324 ``` 2052 ```
2325 -##### fEvtstopQANum  
2326 -- **主题**：/basestation/\${baseSN}/receive  
2327 -- **功能描述**：返回停止数字题状态  
2328 -- **参数说明**  
2329 -  
2330 -|参数名|类型|限制|非空|说明|  
2331 -|---|---|---|---|---|  
2332 -|fun|string|-|是|指令名称|  
2333 -|dataTag|string|-|否|数据包标识,可为空字符串|  
2334 -|data|object|-|是|传送参数的对象|  
2335 -|+state|int||是|停止状态<br>0 - 成功<br>1 - 失败|  
2336 -```json  
2337 -{  
2338 - "fun": "fEvtstopQANum",  
2339 - "dataTag":"1",  
2340 - "data": {  
2341 - "state": 0  
2342 - }  
2343 -}  
2344 -```  
2345 ### 抢答题 2053 ### 抢答题
2346 #### 方法 2054 #### 方法
2347 ##### startQAQuicker 2055 ##### startQAQuicker
@@ -2391,26 +2099,9 @@ @@ -2391,26 +2099,9 @@
2391 } 2099 }
2392 ``` 2100 ```
2393 #### 事件 2101 #### 事件
2394 -##### fEvtStartQAQuicker  
2395 -- **主题**：/basestation/\${baseSN}/receive  
2396 -- **功能描述**：返回启动抢答题状态  
2397 -- **参数说明** 2102 +##### [sEvtStateCode](#sevtstatecode)
  2103 +发送指令后返回接收状态
2398 2104
2399 -|参数名|类型|限制|非空|说明|  
2400 -|---|---|---|---|---|  
2401 -|fun|string|-|是|指令名称|  
2402 -|dataTag|string|-|否|数据包标识,可为空字符串|  
2403 -|data|object|-|是|传送参数的对象|  
2404 -|+state|int||是|启动状态<br>0 - 成功<br>1 - 失败|  
2405 -```json  
2406 -{  
2407 - "fun": "fEvtStartQAQuicker",  
2408 - "dataTag":"1",  
2409 - "data": {  
2410 - "state": 0  
2411 - }  
2412 -}  
2413 -```  
2414 ##### fEvtQAQuicker 2105 ##### fEvtQAQuicker
2415 - **主题**：/basestation/\${baseSN}/receive 2106 - **主题**：/basestation/\${baseSN}/receive
2416 - **功能描述**：返回键盘提交答题信息 2107 - **功能描述**：返回键盘提交答题信息
@@ -2435,26 +2126,6 @@ @@ -2435,26 +2126,6 @@
2435 }] 2126 }]
2436 } 2127 }
2437 ``` 2128 ```
2438 -##### fEvtstopQAQuicker  
2439 -- **主题**：/basestation/\${baseSN}/receive  
2440 -- **功能描述**：返回停止抢答题状态  
2441 -- **参数说明**  
2442 -  
2443 -|参数名|类型|限制|非空|说明|  
2444 -|---|---|---|---|---|  
2445 -|fun|string|-|是|指令名称|  
2446 -|dataTag|string|-|否|数据包标识,可为空字符串|  
2447 -|data|object|-|是|传送参数的对象|  
2448 -|+state|int||是|停止状态<br>0 - 成功<br>1 - 失败|  
2449 -```json  
2450 -{  
2451 - "fun": "fEvtstopQAQuicker",  
2452 - "dataTag":"1",  
2453 - "data": {  
2454 - "state": 0  
2455 - }  
2456 -}  
2457 -```  
2458 ## 在线测验 2129 ## 在线测验
2459 ### 标准测验 2130 ### 标准测验
2460 #### 方法 2131 #### 方法
@@ -2618,26 +2289,9 @@ @@ -2618,26 +2289,9 @@
2618 } 2289 }
2619 ``` 2290 ```
2620 #### 事件 2291 #### 事件
2621 -##### fEvtStartKpExam  
2622 -- **主题**：/basestation/\${baseSN}/receive  
2623 -- **功能描述**：返回启动在线测验状态  
2624 -- **参数说明** 2292 +##### [sEvtStateCode](#sevtstatecode)
  2293 +发送指令后返回接收状态
2625 2294
2626 -|参数名|类型|限制|非空|说明|  
2627 -|---|---|---|---|---|  
2628 -|fun|string|-|是|指令名称|  
2629 -|dataTag|string|-|否|数据包标识,可为空字符串|  
2630 -|data|object|-|是|传送参数的对象|  
2631 -|+state|int||是|启动状态<br>0 - 成功<br>1 - 失败|  
2632 -```json  
2633 -{  
2634 - "fun": "fEvtStartKpExam",  
2635 - "dataTag":"1",  
2636 - "data": {  
2637 - "state": 0  
2638 - }  
2639 -}  
2640 -```  
2641 ##### fEvtKpExam 2295 ##### fEvtKpExam
2642 - **主题**：/basestation/\${baseSN}/receive 2296 - **主题**：/basestation/\${baseSN}/receive
2643 - **功能描述**：返回键盘提交答题信息 2297 - **功能描述**：返回键盘提交答题信息
@@ -2668,26 +2322,6 @@ @@ -2668,26 +2322,6 @@
2668 ] 2322 ]
2669 } 2323 }
2670 ``` 2324 ```
2671 -##### fEvtStopKpExam  
2672 -- **主题**：/basestation/\${baseSN}/receive  
2673 -- **功能描述**：返回停止在线测验状态  
2674 -- **参数说明**  
2675 -  
2676 -|参数名|类型|限制|非空|说明|  
2677 -|---|---|---|---|---|  
2678 -|fun|string|-|是|指令名称|  
2679 -|dataTag|string|-|否|数据包标识,可为空字符串|  
2680 -|data|object|-|是|传送参数的对象|  
2681 -|+state|int||是|停止状态<br>0 - 成功<br>1 - 失败|  
2682 -```json  
2683 -{  
2684 - "fun": "fEvtStopKpExam",  
2685 - "dataTag":"1",  
2686 - "data": {  
2687 - "state": 0  
2688 - }  
2689 -}  
2690 -```  
2691 ##### fEvtFinalSubmit 2325 ##### fEvtFinalSubmit
2692 - **主题**：/basestation/\${baseSN}/receive 2326 - **主题**：/basestation/\${baseSN}/receive
2693 - **功能描述**：返回键盘手动交卷标识 2327 - **功能描述**：返回键盘手动交卷标识
@@ -2710,48 +2344,5 @@ @@ -2710,48 +2344,5 @@
2710 }] 2344 }]
2711 } 2345 }
2712 ``` 2346 ```
2713 -  
2714 -##### fEvtRtAllowEdited  
2715 -- **主题**：/basestation/\${baseSN}/receive  
2716 -- **功能描述**：返回允许键盘修改答案指令接收状态  
2717 -- **参数说明**  
2718 -  
2719 -|参数名|类型|限制|非空|说明|  
2720 -|---|---|---|---|---|  
2721 -|fun|string|-|是|指令名称|  
2722 -|dataTag|string|-|否|数据包标识,可为空字符串|  
2723 -|data|object|-|是|传送参数的对象|  
2724 -|+state|int||是|0-成功<br>1-失败|  
2725 -```json  
2726 -{  
2727 - "fun": "fEvtRtAllowEdited",  
2728 - "dataTag":"1",  
2729 - "data": {  
2730 - "keySn": "1234567890",  
2731 - "state":0  
2732 - }  
2733 -}  
2734 -```  
2735 -  
2736 -##### fEvtAllowEdited  
2737 -- **主题**：/basestation/\${baseSN}/receive  
2738 -- **功能描述**：返回允许键盘修改答案状态  
2739 -- **参数说明**  
2740 -  
2741 -|参数名|类型|限制|非空|说明|  
2742 -|---|---|---|---|---|  
2743 -|fun|string|-|是|指令名称|  
2744 -|dataTag|string|-|否|数据包标识,可为空字符串|  
2745 -|data|object|-|是|传送参数的对象|  
2746 -|+keySn|string||是|键盘SN|  
2747 -|+state|int||是|0-成功<br>1-失败|  
2748 -```json  
2749 -{  
2750 - "fun": "fEvtAllowEdited",  
2751 - "dataTag":"1",  
2752 - "data": {  
2753 - "keySn": "1234567890",  
2754 - "state":0  
2755 - }  
2756 -}  
2757 -```  
2758 \ No newline at end of file 2347 \ No newline at end of file
  2348 +##### [sEvtKpExecState](#sevtkpexecstate)
  2349 +返回键盘执行指令的结果
2759 \ No newline at end of file 2350 \ No newline at end of file