李外 / Protocol

Commit a8c8ea025be4cfe314d68bba396997411a104d0f

Authored by 刘琴
1 parent deff7695

适配海亮C200K功能 

1. 增加测验题中自判题题型
2. 多科测验的科目数量为从9增加至11
3. 增加测验自定义题型标题下发和清除
4. 增加自定义tag，可自定义最长128位的数据包标签
Inline Side-by-side
Showing 1 changed file with 334 additions and 165 deletions
通讯协议-B200W-MQTT协议[内部].md
  View file @a8c8ea0
... ... @@ -14,6 +14,7 @@
14 14 }
15 15 </style>
16 16  
  17 +[TOC]
17 18 <br>
18 19 <br>
19 20 <br>
... ... @@ -26,7 +27,7 @@ SunVote B200W &lt;br&gt;MQTT通讯协议
26 27 <br>
27 28 <br>
28 29 <div style="text-align: center;font-size: 30px;">
29   -Ver 1.0.1
  30 +Ver 1.0.2
30 31 </div>
31 32 <br>
32 33 <br>
... ... @@ -42,7 +43,7 @@ Ver 1.0.1
42 43 <br>
43 44  
44 45 <div style="text-align: center;font-size: 30px;">
45   -二〇二四年十月
  46 +二〇二四年十二月
46 47 </div>
47 48  
48 49 <br>
... ... @@ -61,33 +62,32 @@ Ver 1.0.1
61 62 | 文档版本 | 日期 | 作者 | 版本说明 |
62 63 |---|---|---|---|
63 64 |1.0.1| 2024年10月22日|刘琴|1. 初始版|
  65 +|1.0.2| 2024年12月27日|刘琴|1. 增加测验题中自判题题型<br>2. 多科测验的科目数量为从9增加至11<br>3. 增加测验自定义题型标题下发和清除<br>4. 增加自定义tag，可自定义最长128位的数据包标签<br><font color=red>注：(基站版本需高于0.0.10)</font>|
64 66  
65 67 <br>
66 68 <br>
67 69  
68   -[TOC]
69   -
70 70 # SunVote B200W MQTT通讯协议
71 71  
72 72 # 功能说明
73 73  
74 74 ## 主题说明
75   -\${baseSN}为指定的基站的SN编码，不能为空，接收基站反馈数据需要订阅对应基站SN的接收主题。
  75 +{baseSN}为指定的基站的SN编码，不能为空，接收基站反馈数据需要订阅对应基站SN的接收主题。
76 76 ### 发布的主题
77 77 应用程序发布的主题，基站订阅
78   -/client/\${baseSN}/send
  78 +/client/{baseSN}/send
79 79 /client/multiBase/send
80 80  
81 81 <span class="yellowFill">内部应用发布的主题，基站订阅
82   -/manage/\${baseSN}/send</span>
  82 +/manage/{baseSN}/send</span>
83 83  
84 84 ### 订阅的主题
85 85 应用程序订阅的主题，基站发布
86   -/basestation/\\${baseSN}/receive
  86 +/basestation/\{baseSN}/receive
87 87 /basestation/multiBase/receive
88 88  
89 89 <span class="yellowFill">内部应用订阅的主题，基站发布
90   -/manage/\${baseSN}/receive</span>
  90 +/manage/{baseSN}/receive</span>
91 91  
92 92 ## 指令说明
93 93 |指令功能标识 |说明 |约束|
... ... @@ -112,6 +112,7 @@ Ver 1.0.1
112 112 {
113 113 "fun":"xxx",
114 114 "dataTag":"xxx",
  115 + "tag":"", //此字段非必需
115 116 "data":{
116 117 //内容
117 118 }
... ... @@ -121,7 +122,8 @@ Ver 1.0.1
121 122 |参数 |说明 |约束|
122 123 |---|---|---|
123 124 |fun| 指令或事件名称||
124   -|dataTag| 数据标签，用于对应收发数据|长度不超过4，可为0-9a-zA-Z的组合|
  125 +|dataTag| 数据标签，用于对应收发数据|长度不超过4个字符，可为字母数字的组合，区分大小写|
  126 +|tag| 自定义标签|长度不超过128个字符，可以为字母数字下划线"_"的组合,区分大小写,非必填，可不传本字段|
125 127 |data| 数据内容|对象或者数组，可为空|
126 128  
127 129 <font color="red">注意：基站接收指令数据单次不超过2K长度，在指定键盘发送指令时，如果指令长度超出限制，建议将指令进行拆分，分次发送，如果是所有键盘执行的指令，可将keySns设为空数组不使用指定键盘的模式</font>
... ... @@ -255,10 +257,12 @@ Ver 1.0.1
255 257 ||停止标准测验|[stopKpVote](#stopkpvote)|[sEvtStateCode](#sevtstatecode)|
256 258 |自主录分|启动自主录分|[startKpScoreInput](#startkpscoreinput)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpScore](#fevtkpscore)<br>[fEvtFinalSubmit](#fevtfinalsubmit)|
257 259 ||停止自主录分|[stopKpVote](#stopkpvote)|[sEvtStateCode](#sevtstatecode)|
  260 +|自定义测验题型标题|自定义测验题型标题内容|[setKpExamQuesTitle](#setKpexamquestitle)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpExamQuesTitle](#fevtkpexamquestitle)|
  261 +||清除自定义测验题型标题内容|[clearKpExamQuesTitle](#clearkpexamquestitle)|[sEvtStateCode](#sevtstatecode)<br>[fEvtClearKpExamQuesTitle](#fevtclearkpexamquestitle)|
258 262  
259 263 ## 公共方法
260 264 ### stopKpVote
261   -- **主题**: /client/\${baseSN}/send
  265 +- **主题**: /client/{baseSN}/send
262 266 - **功能描述**：通用停止键盘答题方法，可以停止如同步签到、按键反馈、在线测验中调用startXXX方法启动的业务
263 267 - **参数说明**
264 268  
... ... @@ -277,7 +281,7 @@ Ver 1.0.1
277 281  
278 282 ## 公共事件
279 283 ### sEvtBsConnectState
280   -- **主题**: /basestation/\${baseSN}/receive
  284 +- **主题**: /basestation/{baseSN}/receive
281 285 - **功能描述**：基站连接成功时返回基站型号和基站SN,基站从已连接状态断开返回连接断开
282 286 - **参数说明**
283 287  
... ... @@ -314,7 +318,7 @@ Ver 1.0.1
314 318 }
315 319 ```
316 320 ### sEvtBsChannelConflict
317   -- **主题**: /basestation/\${baseSN}/receive
  321 +- **主题**: /basestation/{baseSN}/receive
318 322 - **功能描述**：基站信道冲突时主动上报，应用程序可根据实际业务修改基站信道
319 323 - **参数说明**
320 324  
... ... @@ -336,7 +340,7 @@ Ver 1.0.1
336 340 }
337 341 ```
338 342 ### sEvtBsNfcResults
339   -- **主题**: /basestation/\${baseSN}/receive
  343 +- **主题**: /basestation/{baseSN}/receive
340 344 - **功能描述**：键盘刷卡时主动上报，如果超出基站容量会上报失败
341 345 - **参数说明**
342 346  
... ... @@ -363,7 +367,7 @@ Ver 1.0.1
363 367 ```
364 368  
365 369 ### sEvtBsKpOnlineMsg
366   -- **主题**: /basestation/\${baseSN}/receive
  370 +- **主题**: /basestation/{baseSN}/receive
367 371 - **功能描述**：键盘上线通知，主动上报,键盘升级成功后也会上报
368 372 - **参数说明**
369 373  
... ... @@ -389,7 +393,7 @@ Ver 1.0.1
389 393 }
390 394 ```
391 395 ### sEvtKpRtFeedback
392   -- **主题**: /basestation/\${baseSN}/receive
  396 +- **主题**: /basestation/{baseSN}/receive
393 397 - **功能描述**：开启键盘实时反馈后，键盘按键时上报
394 398 - **参数说明**
395 399  
... ... @@ -417,7 +421,7 @@ Ver 1.0.1
417 421 }
418 422 ```
419 423 ### sEvtKpHandUp
420   -- **主题**: /basestation/\${baseSN}/receive
  424 +- **主题**: /basestation/{baseSN}/receive
421 425 - **功能描述**：开启键盘举手功能后，键盘按举手键时上报
422 426 - **参数说明**
423 427  
... ... @@ -439,7 +443,7 @@ Ver 1.0.1
439 443 }
440 444 ```
441 445 ### sEvtStateCode
442   -- **主题**: /basestation/\${baseSN}/receive
  446 +- **主题**: /basestation/{baseSN}/receive
443 447 - **功能描述**：返回基站接收指令状态信息
444 448 - **参数说明**
445 449  
... ... @@ -505,7 +509,7 @@ Ver 1.0.1
505 509 ```
506 510  
507 511 ##### getBsConnectState
508   -- **主题**：/client/\${baseSN}/send
  512 +- **主题**：/client/{baseSN}/send
509 513 - **功能描述**：主动获取基站连接状态
510 514 - **参数说明**
511 515  
... ... @@ -553,10 +557,11 @@ Ver 1.0.1
553 557 }
554 558 }
555 559 ```
  560 +
556 561 ### 基站授时
557 562 #### 方法
558 563 ##### timeSync
559   -- **主题**：/client/\${baseSN}/send
  564 +- **主题**：/client/{baseSN}/send
560 565 - **功能描述**：发送当前时间戳给基站进行校时
561 566 - **参数说明**
562 567  
... ... @@ -584,7 +589,7 @@ Ver 1.0.1
584 589 ### 识别设置
585 590 #### 方法
586 591 ##### setBsSN
587   -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  592 +- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
588 593 - **功能描述**：设置基站的SN，<font color="red">需预先订阅新SN的主题,以获取事件返回</font>
589 594 - **参数说明**
590 595  
... ... @@ -608,7 +613,7 @@ Ver 1.0.1
608 613 }
609 614 ```
610 615 ##### getBsModel
611   -- **主题**：/client/\${baseSN}/send
  616 +- **主题**：/client/{baseSN}/send
612 617 - **功能描述**：获取基站型号
613 618 - **参数说明**
614 619  
... ... @@ -625,7 +630,7 @@ Ver 1.0.1
625 630 }
626 631 ```
627 632 ##### getBsFWVersion
628   -- **主题**：/client/\${baseSN}/send
  633 +- **主题**：/client/{baseSN}/send
629 634 - **功能描述**：获取基站固件版本
630 635 - **参数说明**
631 636  
... ... @@ -642,7 +647,7 @@ Ver 1.0.1
642 647 }
643 648 ```
644 649 ##### getBsBIC
645   -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  650 +- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
646 651 - **功能描述**：获取基站品牌识别码
647 652 - **参数说明**
648 653  
... ... @@ -659,7 +664,7 @@ Ver 1.0.1
659 664 }
660 665 ```
661 666 ##### setBsBIC
662   -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  667 +- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
663 668 - **功能描述**：设置基站品牌识别码
664 669 - **参数说明**
665 670  
... ... @@ -684,7 +689,7 @@ Ver 1.0.1
684 689 ```
685 690 #### 事件
686 691 ##### fEvtBsSN
687   -- **主题**: /basestation/\${baseSN}/receive
  692 +- **主题**: /basestation/{baseSN}/receive
688 693 - **功能描述**：返回基站的出厂编码
689 694 - **参数说明**
690 695  
... ... @@ -706,7 +711,7 @@ Ver 1.0.1
706 711 }
707 712 ```
708 713 ##### fEvtBsModel
709   -- **主题**: /basestation/\${baseSN}/receive
  714 +- **主题**: /basestation/{baseSN}/receive
710 715 - **功能描述**：返回基站的型号
711 716 - **参数说明**
712 717  
... ... @@ -728,7 +733,7 @@ Ver 1.0.1
728 733 }
729 734 ```
730 735 ##### fEvtBsFWVersion
731   -- **主题**: /basestation/\${baseSN}/receive
  736 +- **主题**: /basestation/{baseSN}/receive
732 737 - **功能描述**：返回基站的固件版本
733 738 - **参数说明**
734 739  
... ... @@ -750,7 +755,7 @@ Ver 1.0.1
750 755 }
751 756 ```
752 757 ##### fEvtBsBIC
753   -- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
  758 +- **主题**: <sapn class="yellowFill">/manage/{baseSN}/receive</span>
754 759 - **功能描述**：返回基站的品牌码
755 760 - **参数说明**
756 761  
... ... @@ -774,7 +779,7 @@ Ver 1.0.1
774 779 ### 组网设置
775 780 #### 方法
776 781 ##### getBsNetworkMode
777   -- **主题**：/client/\${baseSN}/send
  782 +- **主题**：/client/{baseSN}/send
778 783 - **功能描述**：获取基站组网模式
779 784 - **参数说明**
780 785  
... ... @@ -791,7 +796,7 @@ Ver 1.0.1
791 796 }
792 797 ```
793 798 ##### setBsNetworkMode
794   -- **主题**：/client/\${baseSN}/send
  799 +- **主题**：/client/{baseSN}/send
795 800 - **功能描述**：设置基站组网模式
796 801 - **参数说明**
797 802  
... ... @@ -813,7 +818,7 @@ Ver 1.0.1
813 818 }
814 819 ```
815 820 ##### getBsPairCode
816   -- **主题**：/client/\${baseSN}/send
  821 +- **主题**：/client/{baseSN}/send
817 822 - **功能描述**：获取基站配对码
818 823 - **参数说明**
819 824  
... ... @@ -830,7 +835,7 @@ Ver 1.0.1
830 835 }
831 836 ```
832 837 ##### setBsPairCode
833   -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  838 +- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
834 839 - **功能描述**：设置基站配对码
835 840 - **参数说明**
836 841  
... ... @@ -854,7 +859,7 @@ Ver 1.0.1
854 859 }
855 860 ```
856 861 ##### getBsNfcLogin
857   -- **主题**：/client/\${baseSN}/send
  862 +- **主题**：/client/{baseSN}/send
858 863 - **功能描述**：获取刷卡配对状态
859 864 - **参数说明**
860 865  
... ... @@ -871,7 +876,7 @@ Ver 1.0.1
871 876 }
872 877 ```
873 878 ##### setBsNfcLogin
874   -- **主题**：/client/\${baseSN}/send
  879 +- **主题**：/client/{baseSN}/send
875 880 - **功能描述**：设置基站刷卡配对状态
876 881 - **参数说明**
877 882  
... ... @@ -893,7 +898,7 @@ Ver 1.0.1
893 898 }
894 899 ```
895 900 ##### getBsChannel
896   -- **主题**：/client/\${baseSN}/send
  901 +- **主题**：/client/{baseSN}/send
897 902 - **功能描述**：获取基站信道
898 903 - **参数说明**
899 904  
... ... @@ -910,7 +915,7 @@ Ver 1.0.1
910 915 }
911 916 ```
912 917 ##### setBsChannel
913   -- **主题**：/client/\${baseSN}/send
  918 +- **主题**：/client/{baseSN}/send
914 919 - **功能描述**：设置基站信道
915 920 - **参数说明**
916 921  
... ... @@ -933,7 +938,7 @@ Ver 1.0.1
933 938 ```
934 939  
935 940 ##### getBsRFIChannel
936   -- **主题**：/client/\${baseSN}/send
  941 +- **主题**：/client/{baseSN}/send
937 942 - **功能描述**：获取已被其他基站占用的信道
938 943 - **参数说明**
939 944  
... ... @@ -952,7 +957,7 @@ Ver 1.0.1
952 957  
953 958 #### 事件
954 959 ##### fEvtBsNetworkMode
955   -- **主题**: /basestation/\${baseSN}/receive
  960 +- **主题**: /basestation/{baseSN}/receive
956 961 - **功能描述**：返回基站组网模式
957 962 - **参数说明**
958 963  
... ... @@ -974,7 +979,7 @@ Ver 1.0.1
974 979 }
975 980 ```
976 981 ##### fEvtBsPairCode
977   -- **主题**: /basestation/\${baseSN}/receive
  982 +- **主题**: /basestation/{baseSN}/receive
978 983 - **功能描述**：返回基站配对码
979 984 - **参数说明**
980 985  
... ... @@ -997,7 +1002,7 @@ Ver 1.0.1
997 1002 ```
998 1003  
999 1004 ##### fEvtBsChannel
1000   -- **主题**: /basestation/\${baseSN}/receive
  1005 +- **主题**: /basestation/{baseSN}/receive
1001 1006 - **功能描述**：返回基站信道
1002 1007 - **参数说明**
1003 1008  
... ... @@ -1020,7 +1025,7 @@ Ver 1.0.1
1020 1025 ```
1021 1026  
1022 1027 ##### fEvtBsRFIChannel
1023   -- **主题**: /basestation/\${baseSN}/receive
  1028 +- **主题**: /basestation/{baseSN}/receive
1024 1029 - **功能描述**：返回其他基站已占用的信道，频点冲突时，可以根据返回结果修改基站信道避开干扰
1025 1030 - **参数说明**
1026 1031  
... ... @@ -1052,7 +1057,7 @@ Ver 1.0.1
1052 1057 ```
1053 1058  
1054 1059 ##### fEvtBsNfcLogin
1055   -- **主题**: /basestation/\${baseSN}/receive
  1060 +- **主题**: /basestation/{baseSN}/receive
1056 1061 - **功能描述**：返回基站是否允许NFC刷卡
1057 1062 - **参数说明**
1058 1063  
... ... @@ -1077,7 +1082,7 @@ Ver 1.0.1
1077 1082 #### 方法
1078 1083 ##### getBsSSID
1079 1084 获取基站登录名称
1080   -- **主题**：/client/\${baseSN}/send
  1085 +- **主题**：/client/{baseSN}/send
1081 1086 - **功能描述**：获取基站登录名称
1082 1087 - **参数说明**
1083 1088  
... ... @@ -1094,7 +1099,7 @@ Ver 1.0.1
1094 1099 }
1095 1100 ```
1096 1101 ##### setBsSSID
1097   -- **主题**：/client/\${baseSN}/send
  1102 +- **主题**：/client/{baseSN}/send
1098 1103 - **功能描述**：设置基站登录名称
1099 1104 - **参数说明**
1100 1105  
... ... @@ -1116,7 +1121,7 @@ Ver 1.0.1
1116 1121 }
1117 1122 ```
1118 1123 ##### getBsLoginPwd
1119   -- **主题**：/client/\${baseSN}/send
  1124 +- **主题**：/client/{baseSN}/send
1120 1125 - **功能描述**：获取基站登录密码
1121 1126 - **参数说明**
1122 1127  
... ... @@ -1133,7 +1138,7 @@ Ver 1.0.1
1133 1138 }
1134 1139 ```
1135 1140 ##### setBsLoginPwd
1136   -- **主题**：/client/\${baseSN}/send
  1141 +- **主题**：/client/{baseSN}/send
1137 1142 - **功能描述**：设置基站登录密码
1138 1143 - **参数说明**
1139 1144  
... ... @@ -1156,7 +1161,7 @@ Ver 1.0.1
1156 1161 ```
1157 1162 ##### getBsLoginState
1158 1163 获取基站登录名称
1159   -- **主题**：/client/\${baseSN}/send
  1164 +- **主题**：/client/{baseSN}/send
1160 1165 - **功能描述**：获取基站登录状态
1161 1166 - **参数说明**
1162 1167  
... ... @@ -1173,7 +1178,7 @@ Ver 1.0.1
1173 1178 }
1174 1179 ```
1175 1180 ##### setBsLoginState
1176   -- **主题**：/client/\${baseSN}/send
  1181 +- **主题**：/client/{baseSN}/send
1177 1182 - **功能描述**：设置基站登录状态
1178 1183 - **参数说明**
1179 1184  
... ... @@ -1197,7 +1202,7 @@ Ver 1.0.1
1197 1202  
1198 1203 #### 事件
1199 1204 ##### fEvtBsSSID
1200   -- **主题**: /basestation/\${baseSN}/receive
  1205 +- **主题**: /basestation/{baseSN}/receive
1201 1206 - **功能描述**：返回基站名称
1202 1207 - **参数说明**
1203 1208  
... ... @@ -1219,7 +1224,7 @@ Ver 1.0.1
1219 1224 }
1220 1225 ```
1221 1226 ##### fEvtBsLoginPwd
1222   -- **主题**: /basestation/\${baseSN}/receive
  1227 +- **主题**: /basestation/{baseSN}/receive
1223 1228 - **功能描述**：返回基站登录密码
1224 1229 - **参数说明**
1225 1230  
... ... @@ -1250,7 +1255,7 @@ Ver 1.0.1
1250 1255 }
1251 1256 ```
1252 1257 ##### fEvtBsLoginState
1253   -- **主题**: /basestation/\${baseSN}/receive
  1258 +- **主题**: /basestation/{baseSN}/receive
1254 1259 - **功能描述**：返回基站登录状态
1255 1260 - **参数说明**
1256 1261  
... ... @@ -1274,7 +1279,7 @@ Ver 1.0.1
1274 1279 ### 键盘统一设置
1275 1280 #### 方法
1276 1281 ##### getBsKpLanguage
1277   -- **主题**：/client/\${baseSN}/send
  1282 +- **主题**：/client/{baseSN}/send
1278 1283 - **功能描述**：获取键盘语言
1279 1284 - **参数说明**
1280 1285  
... ... @@ -1291,7 +1296,7 @@ Ver 1.0.1
1291 1296 }
1292 1297 ```
1293 1298 ##### setBsKpLanguage
1294   -- **主题**：/client/\${baseSN}/send
  1299 +- **主题**：/client/{baseSN}/send
1295 1300 - **功能描述**：设置键盘语言
1296 1301 - **参数说明**
1297 1302  
... ... @@ -1313,7 +1318,7 @@ Ver 1.0.1
1313 1318 }
1314 1319 ```
1315 1320 ##### getBsKpStbMsgMode
1316   -- **主题**：/client/\${baseSN}/send
  1321 +- **主题**：/client/{baseSN}/send
1317 1322 - **功能描述**：获取状态语设置状态
1318 1323 - **参数说明**
1319 1324  
... ... @@ -1330,7 +1335,7 @@ Ver 1.0.1
1330 1335 }
1331 1336 ```
1332 1337 ##### setBsKpStbMsgMode
1333   -- **主题**：/client/\${baseSN}/send
  1338 +- **主题**：/client/{baseSN}/send
1334 1339 - **功能描述**：设置状态语工作状态
1335 1340 - **参数说明**
1336 1341  
... ... @@ -1352,7 +1357,7 @@ Ver 1.0.1
1352 1357 }
1353 1358 ```
1354 1359 ##### getBsKpLoginMenu
1355   -- **主题**：/client/\${baseSN}/send
  1360 +- **主题**：/client/{baseSN}/send
1356 1361 - **功能描述**：获取键盘登录菜单显示状态
1357 1362 - **参数说明**
1358 1363  
... ... @@ -1370,7 +1375,7 @@ Ver 1.0.1
1370 1375 ```
1371 1376  
1372 1377 ##### setBsKpLoginMenu
1373   -- **主题**：/client/\${baseSN}/send
  1378 +- **主题**：/client/{baseSN}/send
1374 1379 - **功能描述**：设置键盘登录菜单显示状态
1375 1380 - **参数说明**
1376 1381  
... ... @@ -1392,7 +1397,7 @@ Ver 1.0.1
1392 1397 }
1393 1398 ```
1394 1399 ##### getBsKpSleepLevel
1395   -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  1400 +- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
1396 1401 - **功能描述**：获取键盘休眠时间等级
1397 1402 - **参数说明**
1398 1403  
... ... @@ -1410,7 +1415,7 @@ Ver 1.0.1
1410 1415 ```
1411 1416  
1412 1417 ##### setBsKpSleepLevel
1413   -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  1418 +- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
1414 1419 - **功能描述**：设置键盘休眠时间等级
1415 1420 - **参数说明**
1416 1421  
... ... @@ -1433,7 +1438,7 @@ Ver 1.0.1
1433 1438 ```
1434 1439  
1435 1440 ##### setBsKpPauseSleep
1436   -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  1441 +- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
1437 1442 - **功能描述**：设置键盘暂停休眠是否开启<br><font color="red">注意：请谨慎使用本功能，务必在相关测试或功能完成后关闭，否则可能会导致键盘异常耗电<br>设置单次生效，基站拔插后复位成关闭状态</font>
1438 1443 - **参数说明**
1439 1444  
... ... @@ -1456,7 +1461,7 @@ Ver 1.0.1
1456 1461 ```
1457 1462  
1458 1463 ##### getBsKpPauseSleep
1459   -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  1464 +- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
1460 1465 - **功能描述**：获取键盘暂停休眠是否开启
1461 1466 - **参数说明**
1462 1467  
... ... @@ -1475,7 +1480,7 @@ Ver 1.0.1
1475 1480  
1476 1481 #### 事件
1477 1482 ##### fEvtBsKpLanguage
1478   -- **主题**: /basestation/\${baseSN}/receive
  1483 +- **主题**: /basestation/{baseSN}/receive
1479 1484 - **功能描述**：返回键盘语言
1480 1485 - **参数说明**
1481 1486  
... ... @@ -1497,7 +1502,7 @@ Ver 1.0.1
1497 1502 }
1498 1503 ```
1499 1504 ##### fEvtBsKpStbMsgMode
1500   -- **主题**: /basestation/\${baseSN}/receive
  1505 +- **主题**: /basestation/{baseSN}/receive
1501 1506 - **功能描述**：返回状态语工作状态
1502 1507 - **参数说明**
1503 1508  
... ... @@ -1519,7 +1524,7 @@ Ver 1.0.1
1519 1524 }
1520 1525 ```
1521 1526 ##### fEvtBsKpLoginMenu
1522   -- **主题**: /basestation/\${baseSN}/receive
  1527 +- **主题**: /basestation/{baseSN}/receive
1523 1528 - **功能描述**：返回键盘登录菜单显示状态
1524 1529 - **参数说明**
1525 1530  
... ... @@ -1541,7 +1546,7 @@ Ver 1.0.1
1541 1546 }
1542 1547 ```
1543 1548 ##### fEvtBsKpSleepLevel
1544   -- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
  1549 +- **主题**: <sapn class="yellowFill">/manage/{baseSN}/receive</span>
1545 1550 - **功能描述**：返回键盘休眠时间等级
1546 1551 - **参数说明**
1547 1552  
... ... @@ -1564,7 +1569,7 @@ Ver 1.0.1
1564 1569 ```
1565 1570  
1566 1571 ##### fEvtBsKpPauseSleep
1567   -- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
  1572 +- **主题**: <sapn class="yellowFill">/manage/{baseSN}/receive</span>
1568 1573 - **功能描述**：返回暂停键盘休眠开启状态
1569 1574 - **参数说明**
1570 1575  
... ... @@ -1589,7 +1594,7 @@ Ver 1.0.1
1589 1594 ### 配对模式
1590 1595 #### 方法
1591 1596 ##### startBsFastPair
1592   -- **主题**：/client/\${baseSN}/send
  1597 +- **主题**：/client/{baseSN}/send
1593 1598 - **功能描述**：启动快速配对,键盘配对成功返回键盘信息 [sEvtBsKpOnlineMsg](#sevtbskponlinemsg)
1594 1599 - **参数说明**
1595 1600  
... ... @@ -1606,7 +1611,7 @@ Ver 1.0.1
1606 1611 }
1607 1612 ```
1608 1613 ##### stopBsFastPair
1609   -- **主题**：/client/\${baseSN}/send
  1614 +- **主题**：/client/{baseSN}/send
1610 1615 - **功能描述**：停止快速配对
1611 1616 - **参数说明**
1612 1617  
... ... @@ -1632,7 +1637,7 @@ Ver 1.0.1
1632 1637 ### 白名单模式
1633 1638 #### 方法
1634 1639 ##### getBsWhitelist
1635   -- **主题**：/client/\${baseSN}/send
  1640 +- **主题**：/client/{baseSN}/send
1636 1641 - **功能描述**：获取基站白名单列表
1637 1642 - **参数说明**
1638 1643  
... ... @@ -1649,7 +1654,7 @@ Ver 1.0.1
1649 1654 }
1650 1655 ```
1651 1656 ##### setBsWhitelist
1652   -- **主题**：/client/\${baseSN}/send
  1657 +- **主题**：/client/{baseSN}/send
1653 1658 - **功能描述**：设置基站白名单列表，将基站白名单替换为写入的键盘SN列表
1654 1659 - **参数说明**
1655 1660  
... ... @@ -1671,7 +1676,7 @@ Ver 1.0.1
1671 1676 }
1672 1677 ```
1673 1678 ##### clearBsWhitelist
1674   -- **主题**：/client/\${baseSN}/send
  1679 +- **主题**：/client/{baseSN}/send
1675 1680 - **功能描述**：清空基站白名单列表
1676 1681 - **参数说明**
1677 1682  
... ... @@ -1688,7 +1693,7 @@ Ver 1.0.1
1688 1693 }
1689 1694 ```
1690 1695 ##### addBsWhitelist
1691   -- **主题**：/client/\${baseSN}/send
  1696 +- **主题**：/client/{baseSN}/send
1692 1697 - **功能描述**：添加键盘至基站白名单列表
1693 1698 - **参数说明**
1694 1699  
... ... @@ -1710,7 +1715,7 @@ Ver 1.0.1
1710 1715 }
1711 1716 ```
1712 1717 ##### delBsWhitelist
1713   -- **主题**：/client/\${baseSN}/send
  1718 +- **主题**：/client/{baseSN}/send
1714 1719 - **功能描述**：从基站白名单列表中删除键盘
1715 1720 - **参数说明**
1716 1721  
... ... @@ -1736,7 +1741,7 @@ Ver 1.0.1
1736 1741 发送指令后返回此事件
1737 1742  
1738 1743 ##### fEvtBsWhitelist
1739   -- **主题**：/basestation/\${baseSN}/receive
  1744 +- **主题**：/basestation/{baseSN}/receive
1740 1745 - **功能描述**：返回基站白名单列表
1741 1746 - **参数说明**
1742 1747  
... ... @@ -1759,7 +1764,7 @@ Ver 1.0.1
1759 1764 ```
1760 1765  
1761 1766 ##### fEvtSetBsWhitelist
1762   -- **主题**：/basestation/\${baseSN}/receive
  1767 +- **主题**：/basestation/{baseSN}/receive
1763 1768 - **功能描述**：返回设置白名单状态
1764 1769 - **参数说明**
1765 1770  
... ... @@ -1787,7 +1792,7 @@ Ver 1.0.1
1787 1792 ```
1788 1793  
1789 1794 ##### fEvtAddBsWhitelist
1790   -- **主题**：/basestation/\${baseSN}/receive
  1795 +- **主题**：/basestation/{baseSN}/receive
1791 1796 - **功能描述**：返回增加键盘状态
1792 1797 - **参数说明**
1793 1798  
... ... @@ -1815,7 +1820,7 @@ Ver 1.0.1
1815 1820 ```
1816 1821  
1817 1822 ##### fEvtDelBsWhitelist
1818   -- **主题**：/basestation/\${baseSN}/receive
  1823 +- **主题**：/basestation/{baseSN}/receive
1819 1824 - **功能描述**：返回删除键盘状态
1820 1825 - **参数说明**
1821 1826  
... ... @@ -1845,7 +1850,7 @@ Ver 1.0.1
1845 1850 ### 网络参数设置
1846 1851 #### 方法
1847 1852 ##### getBsTcpipParams
1848   -- **主题**：/client/\${baseSN}/send
  1853 +- **主题**：/client/{baseSN}/send
1849 1854 - **功能描述**：获取基站TCP/IP参数
1850 1855 - **参数说明**
1851 1856  
... ... @@ -1862,7 +1867,7 @@ Ver 1.0.1
1862 1867 }
1863 1868 ```
1864 1869 ##### setBsTcpipParams
1865   -- **主题**：/client/\${baseSN}/send
  1870 +- **主题**：/client/{baseSN}/send
1866 1871 - **功能描述**：设置基站TCP/IP参数
1867 1872 - **参数说明**
1868 1873  
... ... @@ -1890,7 +1895,7 @@ Ver 1.0.1
1890 1895 }
1891 1896 ```
1892 1897 ##### getBsMqttParams
1893   -- **主题**：/client/\${baseSN}/send
  1898 +- **主题**：/client/{baseSN}/send
1894 1899 - **功能描述**：获取基站MQTT参数
1895 1900 - **参数说明**
1896 1901  
... ... @@ -1907,7 +1912,7 @@ Ver 1.0.1
1907 1912 }
1908 1913 ```
1909 1914 ##### setBsMqttParams
1910   -- **主题**：/client/\${baseSN}/send
  1915 +- **主题**：/client/{baseSN}/send
1911 1916 - **功能描述**：设置基站MQTT参数
1912 1917 - **参数说明**
1913 1918  
... ... @@ -1938,7 +1943,7 @@ Ver 1.0.1
1938 1943 ```
1939 1944 #### 事件
1940 1945 ##### fEvtBsTcpipParams
1941   -- **主题**: /basestation/\${baseSN}/receive
  1946 +- **主题**: /basestation/{baseSN}/receive
1942 1947 - **功能描述**：返回基站TCP/IP参数
1943 1948 - **参数说明**
1944 1949  
... ... @@ -1968,7 +1973,7 @@ Ver 1.0.1
1968 1973 }
1969 1974 ```
1970 1975 ##### fEvtBsMqttParams
1971   -- **主题**: /basestation/\${baseSN}/receive
  1976 +- **主题**: /basestation/{baseSN}/receive
1972 1977 - **功能描述**：返回基站MQTT参数
1973 1978 - **参数说明**
1974 1979  
... ... @@ -2000,7 +2005,7 @@ Ver 1.0.1
2000 2005 ### 基站加密
2001 2006 #### 方法
2002 2007 ##### getBsSoftwareKey
2003   -- **主题**：/client/\${baseSN}/send
  2008 +- **主题**：/client/{baseSN}/send
2004 2009 - **功能描述**：获取基站软件狗密钥
2005 2010 - **参数说明**
2006 2011  
... ... @@ -2017,7 +2022,7 @@ Ver 1.0.1
2017 2022 }
2018 2023 ```
2019 2024 ##### setBsSoftwareKey
2020   -- **主题**：/client/\${baseSN}/send
  2025 +- **主题**：/client/{baseSN}/send
2021 2026 - **功能描述**：设置基站软件狗密钥
2022 2027 - **参数说明**
2023 2028  
... ... @@ -2040,7 +2045,7 @@ Ver 1.0.1
2040 2045 ```
2041 2046 #### 事件
2042 2047 ##### fEvtBsSoftwareKey
2043   -- **主题**：/basestation/\${baseSN}/receive
  2048 +- **主题**：/basestation/{baseSN}/receive
2044 2049 - **功能描述**：返回基站的软件狗密钥
2045 2050 - **参数说明**
2046 2051  
... ... @@ -2064,7 +2069,7 @@ Ver 1.0.1
2064 2069 ### 基站维护
2065 2070 #### 方法
2066 2071 ##### getBsLogInfo
2067   -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  2072 +- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
2068 2073 - **功能描述**：获取基站日志,用于出现故障需要排查问题时获取基站内部日志记录
2069 2074 - **参数说明**
2070 2075  
... ... @@ -2082,7 +2087,7 @@ Ver 1.0.1
2082 2087 ```
2083 2088  
2084 2089 ##### clearBsLogInfo
2085   -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  2090 +- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
2086 2091 - **功能描述**：清空基站内部日志记录
2087 2092 - **参数说明**
2088 2093  
... ... @@ -2100,7 +2105,7 @@ Ver 1.0.1
2100 2105 ```
2101 2106  
2102 2107 ##### resetBsSystem
2103   -- **主题**：/client/\${baseSN}/send
  2108 +- **主题**：/client/{baseSN}/send
2104 2109 - **功能描述**：软复位基站<sapn class="yellowFill">（公共主题可用，但不体现在外部版本协议中</span>）
2105 2110 - **参数说明**
2106 2111  
... ... @@ -2118,7 +2123,7 @@ Ver 1.0.1
2118 2123 ```
2119 2124  
2120 2125 ##### resetBsPower
2121   -- **主题**：/client/\${baseSN}/send
  2126 +- **主题**：/client/{baseSN}/send
2122 2127 - **功能描述**：断电复位基站<sapn class="yellowFill">（公共主题可用，但不体现在外部版本协议中）</span>
2123 2128 - **参数说明**
2124 2129  
... ... @@ -2136,7 +2141,7 @@ Ver 1.0.1
2136 2141 ```
2137 2142  
2138 2143 ##### startBsSelfCheck
2139   -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  2144 +- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
2140 2145 - **功能描述**：开始基站自检,基站自检状态中不接收其他指令，空闲状态中才进入自检
2141 2146 - **参数说明**
2142 2147  
... ... @@ -2156,13 +2161,13 @@ Ver 1.0.1
2156 2161 #### 事件
2157 2162 ##### [sEvtStateCode](#sevtstatecode)
2158 2163 返回指令的接收状态
2159   -注意：内部指令的接收状态需从**主题: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>** 返回
  2164 +注意：内部指令的接收状态需从**主题: <sapn class="yellowFill">/manage/{baseSN}/receive</span>** 返回
2160 2165  
2161 2166 ##### [sEvtBsConnectState](#sevtbsconnectstate)
2162 2167 复位基站后，基站重新连接成功后上报
2163 2168  
2164 2169 ##### fEvtBsLogInfo
2165   -- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
  2170 +- **主题**: <sapn class="yellowFill">/manage/{baseSN}/receive</span>
2166 2171 - **功能描述**：返回基站存储的日志内容
2167 2172 - **参数说明**
2168 2173  
... ... @@ -2187,7 +2192,7 @@ Ver 1.0.1
2187 2192 ```
2188 2193  
2189 2194 ##### fEvtBsSelfCheck
2190   -- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
  2195 +- **主题**: <sapn class="yellowFill">/manage/{baseSN}/receive</span>
2191 2196 - **功能描述**：返回基站自检的结果
2192 2197 - **参数说明**
2193 2198  
... ... @@ -2228,7 +2233,7 @@ Ver 1.0.1
2228 2233 ### 基站升级
2229 2234 #### 方法
2230 2235 ##### startBsUpdate
2231   -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  2236 +- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
2232 2237 - **功能描述**:基站固件升级
2233 2238 - **参数说明**
2234 2239  
... ... @@ -2237,7 +2242,7 @@ Ver 1.0.1
2237 2242 |fun|string|-|是|指令名称|
2238 2243 |dataTag|string|-|否|数据包标识,可为空字符串|
2239 2244 |data|object|-|是|传送参数的对象|
2240   -|+partition|int||是|存储区域<br> 1-备份区<font class="yellowFill"> 使用备份区固件的方法：打开基站盖子，按住SW1按钮，然后上电，这时基站固件就会更新成备份区的固件</font><br>2-更新区，实时升级基站固件|
  2245 +|+partition|int||是|存储区域<br> 1-备份区<font class="yellowFill"> 使用备份区固件的方法：打开基站盖子，按住SW1按钮，上电后松开按钮，这时基站固件就会更新成备份区的固件</font><br>2-更新区，实时升级基站固件|
2241 2246 |+url|string||是|待升级的固件地址，可访问的网络url|
2242 2247 |+version|string||是|待升级的基站固件版本|
2243 2248 |+crc|uint||是|固件CRC校验码，10进制数字|
... ... @@ -2258,7 +2263,7 @@ Ver 1.0.1
2258 2263 }
2259 2264 ```
2260 2265 ##### downloadFontLib
2261   -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  2266 +- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
2262 2267 - **功能描述**:下载更新基站字库文件
2263 2268 - **参数说明**
2264 2269  
... ... @@ -2291,10 +2296,10 @@ Ver 1.0.1
2291 2296 #### 事件
2292 2297 ##### [sEvtStateCode](#sevtstatecode)
2293 2298 返回升级指令的接收状态
2294   -注意：升级指令的接收状态需从**主题: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>** 返回
  2299 +注意：升级指令的接收状态需从**主题: <sapn class="yellowFill">/manage/{baseSN}/receive</span>** 返回
2295 2300  
2296 2301 ##### fEvtBsUpateState
2297   -- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
  2302 +- **主题**: <sapn class="yellowFill">/manage/{baseSN}/receive</span>
2298 2303 - **功能描述**：返回基站启动升级状态
2299 2304 - **参数说明**
2300 2305  
... ... @@ -2319,7 +2324,7 @@ Ver 1.0.1
2319 2324 ```
2320 2325  
2321 2326 ##### fEvtBsUpdateProgress
2322   -- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
  2327 +- **主题**: <sapn class="yellowFill">/manage/{baseSN}/receive</span>
2323 2328 - **功能描述**：返回基站升级进度
2324 2329 - **参数说明**
2325 2330  
... ... @@ -2342,7 +2347,7 @@ Ver 1.0.1
2342 2347 ```
2343 2348  
2344 2349 ##### fEvtBsFontLibState
2345   -- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
  2350 +- **主题**: <sapn class="yellowFill">/manage/{baseSN}/receive</span>
2346 2351 - **功能描述**：返回基站下载字库状态
2347 2352 - **参数说明**
2348 2353  
... ... @@ -2367,7 +2372,7 @@ Ver 1.0.1
2367 2372 ```
2368 2373  
2369 2374 ##### fEvtBsFontLibProgress
2370   -- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
  2375 +- **主题**: <sapn class="yellowFill">/manage/{baseSN}/receive</span>
2371 2376 - **功能描述**：返回基站下载字库进度
2372 2377 - **参数说明**
2373 2378  
... ... @@ -2393,7 +2398,7 @@ Ver 1.0.1
2393 2398 ### 识别设置
2394 2399 #### 方法
2395 2400 ##### setKpSN
2396   -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  2401 +- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
2397 2402 - **功能描述**:设置指定键盘的出厂编码
2398 2403 - **参数说明**
2399 2404  
... ... @@ -2420,7 +2425,7 @@ Ver 1.0.1
2420 2425 ```
2421 2426  
2422 2427 ##### setKpID
2423   -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  2428 +- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
2424 2429 - **功能描述**：设置键盘编号
2425 2430 - **参数说明**
2426 2431  
... ... @@ -2444,7 +2449,7 @@ Ver 1.0.1
2444 2449 ```
2445 2450  
2446 2451 ##### startGetKpInfo
2447   -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  2452 +- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
2448 2453 - **功能描述**：开始获取键盘信息
2449 2454 - **参数说明**
2450 2455  
... ... @@ -2463,7 +2468,7 @@ Ver 1.0.1
2463 2468 ```
2464 2469  
2465 2470 ##### stopGetKpInfo
2466   -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  2471 +- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
2467 2472 - **功能描述**：停止获取键盘信息
2468 2473 - **参数说明**
2469 2474  
... ... @@ -2486,7 +2491,7 @@ Ver 1.0.1
2486 2491 发送指令后返回接收状态
2487 2492  
2488 2493 ##### fEvtSetKpSN
2489   -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/receive</span>
  2494 +- **主题**：<sapn class="yellowFill">/manage/{baseSN}/receive</span>
2490 2495 - **功能描述**：返回写键盘SN状态
2491 2496 - **参数说明**
2492 2497  
... ... @@ -2510,7 +2515,7 @@ Ver 1.0.1
2510 2515 }
2511 2516 ```
2512 2517 ##### fEvtSetKpID
2513   -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/receive</span>
  2518 +- **主题**：<sapn class="yellowFill">/manage/{baseSN}/receive</span>
2514 2519 - **功能描述**：返回键盘编号
2515 2520 - **参数说明**
2516 2521  
... ... @@ -2534,7 +2539,7 @@ Ver 1.0.1
2534 2539 }
2535 2540 ```
2536 2541 ##### fEvtKpInfo
2537   -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/receive</span>
  2542 +- **主题**：<sapn class="yellowFill">/manage/{baseSN}/receive</span>
2538 2543 - **功能描述**：返回键盘信息
2539 2544 - **参数说明**
2540 2545  
... ... @@ -2565,7 +2570,7 @@ Ver 1.0.1
2565 2570 ### 交互设置
2566 2571 #### 方法
2567 2572 ##### setKpUserStbMsg
2568   -- **主题**：/client/\${baseSN}/send
  2573 +- **主题**：/client/{baseSN}/send
2569 2574 - **功能描述**：设置用户内置状态语
2570 2575 - **参数说明**
2571 2576  
... ... @@ -2593,7 +2598,7 @@ Ver 1.0.1
2593 2598 }
2594 2599 ```
2595 2600 ##### rtSetKpUserPrompt
2596   -- **主题**：/client/\${baseSN}/send
  2601 +- **主题**：/client/{baseSN}/send
2597 2602 - **功能描述**：实时设置提示反馈信息
2598 2603 - **参数说明**
2599 2604  
... ... @@ -2606,6 +2611,7 @@ Ver 1.0.1
2606 2611 |++info|string||否|设置的反馈信息<br>不同键盘可设置不同反馈信息|
2607 2612  
2608 2613 - **示例代码**
  2614 +
2609 2615 ```json
2610 2616 //分别提示
2611 2617 {
... ... @@ -2639,7 +2645,7 @@ Ver 1.0.1
2639 2645 发送指令后返回接收状态
2640 2646  
2641 2647 ##### fEvtKpUserStbMsg
2642   -- **主题**：/basestation/\${baseSN}/receive
  2648 +- **主题**：/basestation/{baseSN}/receive
2643 2649 - **功能描述**：返回设置状态语的状态
2644 2650 - **参数说明**
2645 2651  
... ... @@ -2661,7 +2667,7 @@ Ver 1.0.1
2661 2667 }
2662 2668 ```
2663 2669 ##### fEvtSetKpUserPrompt
2664   -- **主题**：/basestation/\${baseSN}/receive
  2670 +- **主题**：/basestation/{baseSN}/receive
2665 2671 - **功能描述**：返回实时设置提示语是否成功
2666 2672 - **参数说明**
2667 2673  
... ... @@ -2698,7 +2704,7 @@ Ver 1.0.1
2698 2704 ### 在线状态
2699 2705 #### 方法
2700 2706 ##### startGetKpOnline
2701   -- **主题**：/client/\${baseSN}/send
  2707 +- **主题**：/client/{baseSN}/send
2702 2708 - **功能描述**：开始获取键盘在线信息,键盘在线返回键盘信息
2703 2709 - **参数说明**
2704 2710  
... ... @@ -2708,6 +2714,7 @@ Ver 1.0.1
2708 2714 |dataTag|string|-|否|数据包标识,可为空字符串|
2709 2715  
2710 2716 - **示例代码**
  2717 +
2711 2718 ```json
2712 2719 {
2713 2720 "fun":"startGetKpOnline",
... ... @@ -2716,7 +2723,7 @@ Ver 1.0.1
2716 2723 ```
2717 2724  
2718 2725 ##### stopGetKpOnline
2719   -- **主题**：/client/\${baseSN}/send
  2726 +- **主题**：/client/{baseSN}/send
2720 2727 - **功能描述**：停止获取键盘在线信息
2721 2728 - **参数说明**
2722 2729  
... ... @@ -2726,6 +2733,7 @@ Ver 1.0.1
2726 2733 |dataTag|string|-|否|数据包标识,可为空字符串|
2727 2734  
2728 2735 - **示例代码**
  2736 +
2729 2737 ```json
2730 2738 {
2731 2739 "fun":"stopGetKpOnline",
... ... @@ -2737,7 +2745,7 @@ Ver 1.0.1
2737 2745 发送指令后返回此事件
2738 2746  
2739 2747 ##### fEvtKpOnlineMsg
2740   -- **主题**: /basestation/\${baseSN}/receive
  2748 +- **主题**: /basestation/{baseSN}/receive
2741 2749 - **功能描述**：主动获取在线键盘时，在线键盘状态报告
2742 2750 - **参数说明**
2743 2751  
... ... @@ -2768,7 +2776,7 @@ Ver 1.0.1
2768 2776 ### 维护功能
2769 2777 #### 方法
2770 2778 ##### remoteKpSleep
2771   -- **主题**：/client/\${baseSN}/send
  2779 +- **主题**：/client/{baseSN}/send
2772 2780 - **功能描述**：遥控键盘休眠
2773 2781 - **参数说明**
2774 2782  
... ... @@ -2790,7 +2798,7 @@ Ver 1.0.1
2790 2798 }
2791 2799 ```
2792 2800 ##### startKpFWUpdate
2793   -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  2801 +- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
2794 2802 - **功能描述**:键盘升级
2795 2803 - **参数说明**
2796 2804  
... ... @@ -2820,7 +2828,7 @@ Ver 1.0.1
2820 2828 }
2821 2829 ```
2822 2830 ##### stopKpFWUpdate
2823   -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  2831 +- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
2824 2832 - **功能描述**:停止键盘升级
2825 2833 - **参数说明**
2826 2834  
... ... @@ -2843,10 +2851,10 @@ Ver 1.0.1
2843 2851 #### 事件
2844 2852 ##### [sEvtStateCode](#sevtstatecode)
2845 2853 返回升级指令的接收状态
2846   -注意：升级指令的接收状态需从**主题: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>** 返回
  2854 +注意：升级指令的接收状态需从**主题: <sapn class="yellowFill">/manage/{baseSN}/receive</span>** 返回
2847 2855  
2848 2856 ##### fEvtKpFWUpdateState
2849   -- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
  2857 +- **主题**: <sapn class="yellowFill">/manage/{baseSN}/receive</span>
2850 2858 - **功能描述**：返回键盘升级状态
2851 2859 - **参数说明**
2852 2860  
... ... @@ -2870,7 +2878,7 @@ Ver 1.0.1
2870 2878 }
2871 2879 ```
2872 2880 ##### fEvtKpUpdateProgress
2873   -- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
  2881 +- **主题**: <sapn class="yellowFill">/manage/{baseSN}/receive</span>
2874 2882 - **功能描述**：返回键盘升级进度
2875 2883 - **参数说明**
2876 2884  
... ... @@ -2895,7 +2903,7 @@ Ver 1.0.1
2895 2903 ### 无线绑定
2896 2904 #### 方法
2897 2905 ##### rtSetKpBindingInfo
2898   -- **主题**：/client/\${baseSN}/send
  2906 +- **主题**：/client/{baseSN}/send
2899 2907 - **功能描述**：实时设置绑定信息到键盘
2900 2908 - **参数说明**
2901 2909  
... ... @@ -2908,6 +2916,7 @@ Ver 1.0.1
2908 2916 |++info|string||是|设置的绑定信息，一般为学生姓名<br>最长48个字符，显示在键盘左上角|
2909 2917  
2910 2918 - **示例代码**
  2919 +
2911 2920 ```json
2912 2921 {
2913 2922 "fun":"rtSetKpBindingInfo",
... ... @@ -2926,7 +2935,7 @@ Ver 1.0.1
2926 2935 ```
2927 2936  
2928 2937 ##### clearKpBindingInfo
2929   -- **主题**：/client/\${baseSN}/send
  2938 +- **主题**：/client/{baseSN}/send
2930 2939 - **功能描述**：清除键盘绑定信息
2931 2940 - **参数说明**
2932 2941  
... ... @@ -2938,6 +2947,7 @@ Ver 1.0.1
2938 2947 |+keySns|array||否|需要清除绑定信息键盘SN数组，<br>空数组表示清空所有键盘|
2939 2948  
2940 2949 - **示例代码**
  2950 +
2941 2951 ```json
2942 2952 {
2943 2953 "fun":"clearKpBindingInfo",
... ... @@ -2952,7 +2962,7 @@ Ver 1.0.1
2952 2962 发送指令后返回接收状态
2953 2963  
2954 2964 ##### fEvtKpBindingInfo
2955   -- **主题**：/basestation/\${baseSN}/receive
  2965 +- **主题**：/basestation/{baseSN}/receive
2956 2966 - **功能描述**：返回键盘实时设置绑定信息的状态是否成功
2957 2967 - **参数说明**
2958 2968  
... ... @@ -2965,6 +2975,7 @@ Ver 1.0.1
2965 2975 |++state|string||是|设置的绑定信息是否成功<br>0 - 成功<br>1 - 失败|
2966 2976  
2967 2977 - **示例代码**
  2978 +
2968 2979 ```json
2969 2980 {
2970 2981 "fun":"fEvtKpBindingInfo",
... ... @@ -2982,7 +2993,7 @@ Ver 1.0.1
2982 2993 }
2983 2994 ```
2984 2995 ##### fEvtClearKpBindingInfo
2985   -- **主题**：/basestation/\${baseSN}/receive
  2996 +- **主题**：/basestation/{baseSN}/receive
2986 2997 - **功能描述**：返回清空绑定信息的指令状态是否成功
2987 2998 - **参数说明**
2988 2999  
... ... @@ -2994,6 +3005,7 @@ Ver 1.0.1
2994 3005 |+state|string||是|设置的绑定信息是否成功<br>0 - 成功<br>1 - 失败|
2995 3006  
2996 3007 - **示例代码**
  3008 +
2997 3009 ```json
2998 3010 {
2999 3011 "fun":"fEvtClearKpBindingInfo",
... ... @@ -3007,7 +3019,7 @@ Ver 1.0.1
3007 3019 ### 同步签到
3008 3020 #### 方法
3009 3021 ##### startKpSignIn
3010   -- **主题**：/client/\${baseSN}/send
  3022 +- **主题**：/client/{baseSN}/send
3011 3023 - **功能描述**：启动同步签到
3012 3024 - **参数说明**
3013 3025  
... ... @@ -3049,7 +3061,7 @@ Ver 1.0.1
3049 3061 }
3050 3062 ```
3051 3063 <!-- ##### stopKpSignIn
3052   -- **主题**：/client/\${baseSN}/send
  3064 +- **主题**：/client/{baseSN}/send
3053 3065 - **功能描述**：停止同步签到
3054 3066 - **参数说明**
3055 3067  
... ... @@ -3078,7 +3090,7 @@ Ver 1.0.1
3078 3090 ### 随时签到
3079 3091 #### 方法
3080 3092 ##### rtStartKpSignIn
3081   -- **主题**：/client/\${baseSN}/send
  3093 +- **主题**：/client/{baseSN}/send
3082 3094 - **功能描述**：启动随时签到绑定
3083 3095 - **参数说明**
3084 3096  
... ... @@ -3090,6 +3102,7 @@ Ver 1.0.1
3090 3102 |+mode|int|-|是|签到模式<br>1-按键签到，按OK键签到自动授权(<font color="red">暂不支持</font>)<br>2-PIN码签到，输入pin码后由应用程序决定是否授权|
3091 3103  
3092 3104 - **示例代码**
  3105 +
3093 3106 ```json
3094 3107 {
3095 3108 "fun":"rtStartKpSignIn",
... ... @@ -3100,7 +3113,7 @@ Ver 1.0.1
3100 3113 }
3101 3114 ```
3102 3115 ##### rtStopKpSignIn
3103   -- **主题**：/client/\${baseSN}/send
  3116 +- **主题**：/client/{baseSN}/send
3104 3117 - **功能描述**：停止随时签到绑定
3105 3118 - **参数说明**
3106 3119  
... ... @@ -3110,6 +3123,7 @@ Ver 1.0.1
3110 3123 |dataTag|string|-|否|数据包标识,可为空字符串|
3111 3124  
3112 3125 - **示例代码**
  3126 +
3113 3127 ```json
3114 3128 {
3115 3129 "fun":"rtStopKpSignIn",
... ... @@ -3117,7 +3131,7 @@ Ver 1.0.1
3117 3131 }
3118 3132 ```
3119 3133 ##### rtSetKpLoginAllowed
3120   -- **主题**：/client/\${baseSN}/send
  3134 +- **主题**：/client/{baseSN}/send
3121 3135 - **功能描述**：实时PIN绑定授权,可取消授权
3122 3136 - **参数说明**
3123 3137  
... ... @@ -3130,6 +3144,7 @@ Ver 1.0.1
3130 3144 |+state|int|-|是|1-授权成功<br>2-授权失败<br>3-解除已授权|
3131 3145  
3132 3146 - **示例代码**
  3147 +
3133 3148 ```json
3134 3149 {
3135 3150 "fun":"rtSetKpLoginAllowed",
... ... @@ -3145,7 +3160,7 @@ Ver 1.0.1
3145 3160 发送指令后返回接收状态
3146 3161  
3147 3162 ##### fEvtKpSignIn
3148   -- **主题**：/basestation/\${baseSN}/receive
  3163 +- **主题**：/basestation/{baseSN}/receive
3149 3164 - **功能描述**：返回键盘提交签到信息
3150 3165 - **参数说明**
3151 3166  
... ... @@ -3161,6 +3176,7 @@ Ver 1.0.1
3161 3176 |++retryCount|int||是|键盘提交数据的重发次数|
3162 3177  
3163 3178 - **示例代码**
  3179 +
3164 3180 ```json
3165 3181 {
3166 3182 "fun":"fEvtKpSignIn",
... ... @@ -3179,7 +3195,7 @@ Ver 1.0.1
3179 3195 }
3180 3196 ```
3181 3197 ##### fEvtKpLoginAllowed
3182   -- **主题**：/basestation/\${baseSN}/receive
  3198 +- **主题**：/basestation/{baseSN}/receive
3183 3199 - **功能描述**：返回键盘授权状态
3184 3200 - **参数说明**
3185 3201  
... ... @@ -3192,6 +3208,7 @@ Ver 1.0.1
3192 3208 |+state|string||是|0-执行成功<br> 1-执行失败|
3193 3209  
3194 3210 - **示例代码**
  3211 +
3195 3212 ```json
3196 3213 {
3197 3214 "fun":"fEvtKpLoginAllowed",
... ... @@ -3206,7 +3223,7 @@ Ver 1.0.1
3206 3223 ### 判断题
3207 3224 #### 方法
3208 3225 ##### startQATrueFalse
3209   -- **主题**：/client/\${baseSN}/send
  3226 +- **主题**：/client/{baseSN}/send
3210 3227 - **功能描述**：启动判断题答题
3211 3228 - **参数说明**
3212 3229  
... ... @@ -3224,6 +3241,7 @@ Ver 1.0.1
3224 3241 |++answer|string||是|预设提交的按键值<br>1-对 <br>2-错|
3225 3242  
3226 3243 - **示例代码**
  3244 +
3227 3245 ```json
3228 3246 {
3229 3247 "fun":"startQATrueFalse",
... ... @@ -3241,7 +3259,7 @@ Ver 1.0.1
3241 3259 }
3242 3260 ```
3243 3261 <!-- ##### stopQATrueFalse
3244   -- **主题**：/client/\${baseSN}/send
  3262 +- **主题**：/client/{baseSN}/send
3245 3263 - **功能描述**：停止判断题答题
3246 3264 - **参数说明**
3247 3265  
... ... @@ -3251,6 +3269,7 @@ Ver 1.0.1
3251 3269 |dataTag|string|-|否|数据包标识,可为空字符串|
3252 3270  
3253 3271 - **示例代码**
  3272 +
3254 3273 ```json
3255 3274 {
3256 3275 "fun":"stopQATrueFalse",
... ... @@ -3266,7 +3285,7 @@ Ver 1.0.1
3266 3285 发送指令后返回接收状态
3267 3286  
3268 3287 ##### fEvtQATrueFalse
3269   -- **主题**：/basestation/\${baseSN}/receive
  3288 +- **主题**：/basestation/{baseSN}/receive
3270 3289 - **功能描述**：返回键盘提交答题信息
3271 3290 - **参数说明**
3272 3291  
... ... @@ -3282,6 +3301,7 @@ Ver 1.0.1
3282 3301 |++retryCount|int||是|键盘提交数据的重发次数|
3283 3302  
3284 3303 - **示例代码**
  3304 +
3285 3305 ```json
3286 3306 {
3287 3307 "fun":"fEvtQATrueFalse",
... ... @@ -3297,7 +3317,7 @@ Ver 1.0.1
3297 3317 ### 选择题
3298 3318 #### 方法
3299 3319 ##### startQAChoice
3300   -- **主题**：/client/\${baseSN}/send
  3320 +- **主题**：/client/{baseSN}/send
3301 3321 - **功能描述**：启动选择题答题
3302 3322 - **参数说明**
3303 3323  
... ... @@ -3318,6 +3338,7 @@ Ver 1.0.1
3318 3338 |++answer|string||是|预设提交的按键值|
3319 3339  
3320 3340 - **示例代码**
  3341 +
3321 3342 ```json
3322 3343 {
3323 3344 "fun":"startQAChoice",
... ... @@ -3338,7 +3359,7 @@ Ver 1.0.1
3338 3359 }
3339 3360 ```
3340 3361 <!-- ##### stopQAChoice
3341   -- **主题**：/client/\${baseSN}/send
  3362 +- **主题**：/client/{baseSN}/send
3342 3363 - **功能描述**：停止选择题答题
3343 3364 - **参数说明**
3344 3365  
... ... @@ -3348,6 +3369,7 @@ Ver 1.0.1
3348 3369 |dataTag|string|-|否|数据包标识,可为空字符串|
3349 3370  
3350 3371 - **示例代码**
  3372 +
3351 3373 ```json
3352 3374 {
3353 3375 "fun":"stopQAChoice",
... ... @@ -3362,7 +3384,7 @@ Ver 1.0.1
3362 3384 发送指令后返回接收状态
3363 3385  
3364 3386 ##### fEvtQAChoice
3365   -- **主题**：/basestation/\${baseSN}/receive
  3387 +- **主题**：/basestation/{baseSN}/receive
3366 3388 - **功能描述**：返回键盘提交答题信息
3367 3389 - **参数说明**
3368 3390  
... ... @@ -3378,6 +3400,7 @@ Ver 1.0.1
3378 3400 |++retryCount|int||是|键盘提交数据的重发次数|
3379 3401  
3380 3402 - **示例代码**
  3403 +
3381 3404 ```json
3382 3405 {
3383 3406 "fun":"fEvtQAChoice",
... ... @@ -3392,7 +3415,7 @@ Ver 1.0.1
3392 3415 ### 数字题
3393 3416 #### 方法
3394 3417 ##### startQANum
3395   -- **主题**：/client/\${baseSN}/send
  3418 +- **主题**：/client/{baseSN}/send
3396 3419 - **功能描述**：启动数字题答题
3397 3420 - **参数说明**
3398 3421  
... ... @@ -3412,6 +3435,7 @@ Ver 1.0.1
3412 3435 |++answer|string||是|预设提交的按键值|
3413 3436  
3414 3437 - **示例代码**
  3438 +
3415 3439 ```json
3416 3440 {
3417 3441 "fun":"startQANum",
... ... @@ -3431,7 +3455,7 @@ Ver 1.0.1
3431 3455 }
3432 3456 ```
3433 3457 <!-- ##### stopQANum
3434   -- **主题**：/client/\${baseSN}/send
  3458 +- **主题**：/client/{baseSN}/send
3435 3459 - **功能描述**：停止数字题答题
3436 3460 - **参数说明**
3437 3461  
... ... @@ -3441,6 +3465,7 @@ Ver 1.0.1
3441 3465 |dataTag|string|-|否|数据包标识,可为空字符串|
3442 3466  
3443 3467 - **示例代码**
  3468 +
3444 3469 ```json
3445 3470 {
3446 3471 "fun":"stopQANum",
... ... @@ -3455,7 +3480,7 @@ Ver 1.0.1
3455 3480 发送指令后返回接收状态
3456 3481  
3457 3482 ##### fEvtQANum
3458   -- **主题**：/basestation/\${baseSN}/receive
  3483 +- **主题**：/basestation/{baseSN}/receive
3459 3484 - **功能描述**：返回键盘提交答题信息
3460 3485 - **参数说明**
3461 3486  
... ... @@ -3471,11 +3496,12 @@ Ver 1.0.1
3471 3496 |++retryCount|int||是|键盘提交数据的重发次数|
3472 3497  
3473 3498 - **示例代码**
  3499 +
3474 3500 ```json
3475 3501 {
3476 3502 "fun":"fEvtQANum",
3477 3503 "dataTag":"1",
3478   - "data": [{
  3504 + "data":[{
3479 3505 "keySn": "1234567890",
3480 3506 "keyValue":"10",
3481 3507 "keyTime":3.2
... ... @@ -3485,7 +3511,7 @@ Ver 1.0.1
3485 3511 ### 抢答题
3486 3512 #### 方法
3487 3513 ##### startQAQuicker
3488   -- **主题**：/client/\${baseSN}/send
  3514 +- **主题**：/client/{baseSN}/send
3489 3515 - **功能描述**：启动抢答题答题
3490 3516 - **参数说明**
3491 3517  
... ... @@ -3518,7 +3544,7 @@ Ver 1.0.1
3518 3544 }
3519 3545 ```
3520 3546 <!-- ##### stopQAQuicker
3521   -- **主题**：/client/\${baseSN}/send
  3547 +- **主题**：/client/{baseSN}/send
3522 3548 - **功能描述**：停止抢答答题
3523 3549 - **参数说明**
3524 3550  
... ... @@ -3528,6 +3554,7 @@ Ver 1.0.1
3528 3554 |dataTag|string|-|否|数据包标识,可为空字符串|
3529 3555  
3530 3556 - **示例代码**
  3557 +
3531 3558 ```json
3532 3559 {
3533 3560 "fun":"stopQAQuicker",
... ... @@ -3543,7 +3570,7 @@ Ver 1.0.1
3543 3570 发送指令后返回接收状态
3544 3571  
3545 3572 ##### fEvtQAQuicker
3546   -- **主题**：/basestation/\${baseSN}/receive
  3573 +- **主题**：/basestation/{baseSN}/receive
3547 3574 - **功能描述**：返回键盘提交答题信息
3548 3575 - **参数说明**
3549 3576  
... ... @@ -3559,6 +3586,7 @@ Ver 1.0.1
3559 3586 |++retryCount|int||是|键盘提交数据的重发次数|
3560 3587  
3561 3588 - **示例代码**
  3589 +
3562 3590 ```json
3563 3591 {
3564 3592 "fun":"fEvtQAQuicker",
... ... @@ -3573,7 +3601,7 @@ Ver 1.0.1
3573 3601 ### 待机实时反馈
3574 3602 #### 方法
3575 3603 ##### setKpStbResponse
3576   -- **主题**：/client/\${baseSN}/send
  3604 +- **主题**：/client/{baseSN}/send
3577 3605 - **功能描述**：启动待机实时反馈
3578 3606 - **参数说明**
3579 3607  
... ... @@ -3618,7 +3646,7 @@ Ver 1.0.1
3618 3646 ```
3619 3647  
3620 3648 ##### getKpStbResponse
3621   -- **主题**：/client/\${baseSN}/send
  3649 +- **主题**：/client/{baseSN}/send
3622 3650 - **功能描述**：获取实时反馈是否打开
3623 3651 - **参数说明**
3624 3652  
... ... @@ -3637,8 +3665,8 @@ Ver 1.0.1
3637 3665 ```
3638 3666  
3639 3667 #### 事件
3640   -#### fEvtKpStbResponse
3641   -- **主题**：/basestation/\${baseSN}/receive
  3668 +##### fEvtKpStbResponse
  3669 +- **主题**：/basestation/{baseSN}/receive
3642 3670 - **功能描述**：返回当前待机按键反馈开启状态
3643 3671 - **参数说明**
3644 3672  
... ... @@ -3682,7 +3710,7 @@ Ver 1.0.1
3682 3710 ### 标准测验
3683 3711 #### 方法
3684 3712 ##### startKpExam
3685   -- **主题**：/client/\${baseSN}/send
  3713 +- **主题**：/client/{baseSN}/send
3686 3714 - **功能描述**：启动标准测验
3687 3715 - **参数说明**
3688 3716  
... ... @@ -3694,7 +3722,7 @@ Ver 1.0.1
3694 3722 |+examNo|int||是|0-9999<br>=0，新的测验<br>>0时,与上次启动卷号一致继续测验，不一致进入新的测验|
3695 3723 |+mode|int||是|显示模式<br>0-不显示开头<br>1-显示“Q”开头<br>2-显示“题”开头|
3696 3724 |+questions|array||是|题目详情|
3697   -|++quesType | int||是| 题目类型<br>1:单选<br>2:多选（排序）<br>3:数字<br>4:判断 |
  3725 +|++quesType | int||是| 题目类型<br>1:单选<br>2:多选（排序）<br>3:数字<br>4:判断 <br>5:自判题|
3698 3726 |++option |int||是 |选项数目<br> quesType = 1 有效。<br>quesType = 2 有效。<br>此项缺省时 默认4;<br>范围：1-10。|
3699 3727 |++startNo | string||是| 起始题号,可以为数字+“-”，单级的题号数字范围1-255，如“1”，“1-1”，“1-1-1”，最多只能输入三级<br>mode=0 时有效，mode=1或2时键盘按顺序显示题号|
3700 3728 |++count | int||是| 相同参数的连续题目数量, >0 <br>注意：总题数最多支持200题 |
... ... @@ -3892,7 +3920,7 @@ Ver 1.0.1
3892 3920 ```
3893 3921  
3894 3922 <!-- ##### stopKpExam
3895   -- **主题**：/client/\${baseSN}/send
  3923 +- **主题**：/client/{baseSN}/send
3896 3924 - **功能描述**：停止标准测验
3897 3925 - **参数说明**
3898 3926  
... ... @@ -3902,6 +3930,7 @@ Ver 1.0.1
3902 3930 |dataTag|string|-|否|数据包标识,可为空字符串|
3903 3931  
3904 3932 - **示例代码**
  3933 +
3905 3934 ```json
3906 3935 {
3907 3936 "fun":"stopKpExam",
... ... @@ -3912,7 +3941,7 @@ Ver 1.0.1
3912 3941 停止在线测验
3913 3942  
3914 3943 ##### rtGetKpExamData
3915   -- **主题**：/client/\${baseSN}/send
  3944 +- **主题**：/client/{baseSN}/send
3916 3945 - **功能描述**：刷新作答数据
3917 3946 - **参数说明**
3918 3947  
... ... @@ -3934,7 +3963,7 @@ Ver 1.0.1
3934 3963 }
3935 3964 ```
3936 3965 ##### rtKpAllowEdited
3937   -- **主题**：/client/\${baseSN}/send
  3966 +- **主题**：/client/{baseSN}/send
3938 3967 - **功能描述**：键盘提交后，允许键盘修改答案
3939 3968 - **参数说明**
3940 3969  
... ... @@ -3946,6 +3975,7 @@ Ver 1.0.1
3946 3975 |+keySns|array||是|指定的键盘SN数组，空数组表示全部在线键盘|
3947 3976  
3948 3977 - **示例代码**
  3978 +
3949 3979 ```json
3950 3980 {
3951 3981 "fun":"rtKpAllowEdited",
... ... @@ -3960,7 +3990,7 @@ Ver 1.0.1
3960 3990 发送指令后返回接收状态
3961 3991  
3962 3992 ##### fEvtKpExam
3963   -- **主题**：/basestation/\${baseSN}/receive
  3993 +- **主题**：/basestation/{baseSN}/receive
3964 3994 - **功能描述**：返回键盘提交答题信息
3965 3995 - **参数说明**
3966 3996  
... ... @@ -3976,6 +4006,7 @@ Ver 1.0.1
3976 4006 |++retryCount|int||是|键盘提交数据的重发次数|
3977 4007  
3978 4008 - **示例代码**
  4009 +
3979 4010 ```json
3980 4011 {
3981 4012 "fun":"fEvtKpExam",
... ... @@ -3994,7 +4025,7 @@ Ver 1.0.1
3994 4025 }
3995 4026 ```
3996 4027 ##### fEvtFinalSubmit
3997   -- **主题**：/basestation/\${baseSN}/receive
  4028 +- **主题**：/basestation/{baseSN}/receive
3998 4029 - **功能描述**：返回键盘手动交卷标识
3999 4030 - **参数说明**
4000 4031  
... ... @@ -4008,6 +4039,7 @@ Ver 1.0.1
4008 4039 |++keyTime|double||是|提交时间，从启动开始计算，单位秒|
4009 4040  
4010 4041 - **示例代码**
  4042 +
4011 4043 ```json
4012 4044 {
4013 4045 "fun":"fEvtFinalSubmit",
... ... @@ -4023,7 +4055,7 @@ Ver 1.0.1
4023 4055 ### 多科测验
4024 4056 #### 方法
4025 4057 ##### startKpMultiExam
4026   -- **主题**：/client/\${baseSN}/send
  4058 +- **主题**：/client/{baseSN}/send
4027 4059 - **功能描述**：启动多科测验
4028 4060 - **参数说明**
4029 4061  
... ... @@ -4035,11 +4067,11 @@ Ver 1.0.1
4035 4067 |+examNo|int||是|0-9999<br>=0，新的测验<br>>0时,与上次启动卷号一致继续测验，不一致进入新的测验|
4036 4068 |+mode|int||是|显示模式<br>0-不显示开头<br>1-显示“Q”开头<br>2-显示“题”开头|
4037 4069 |+questions|array||是|题目详情|
4038   -|++subject | int||是 | 科目序号,1-9,对应键盘中内置的科目1-9<br>键盘答题时可选择科目切换答题|
  4070 +|++subject | int||是 | 科目序号,1-11,对应键盘中内置的科目1-11<br>键盘答题时可选择科目切换答题|
4039 4071 |++quesType | int||是| 题目类型<br>1:单选<br>2:多选（排序）<br>3:数字<br>4:判断 |
4040 4072 |++option |int||是 |选项数目<br> quesType = 1 有效。<br>quesType = 2 有效。<br>此项缺省时 默认4;<br>范围：1-10。|
4041 4073 |++startNo | string||是| 起始题号,可以为数字+“-”，单级的题号数字范围1-255，如“1”，“1-1”，最多支持两级题号<br>mode=0 时有效，mode=1或2时键盘按顺序显示题号|
4042   -|++count | int||是| 相同参数的连续题目数量, >0 <br>注意：所有科目的总题数最多支持200题|
  4074 +|++count | int||是| 相同参数的连续题目数量, >0 <br><font color="red">注意：所有科目的总题数最多支持200题</font>|
4043 4075 |+simParams|object||否|内部模拟测试参数设置对象|
4044 4076 |++answer|array||是|预设提交的按键值<br>格式为"单选题答案,多选题答案;<br>数字题答案;判断题答案(1对2错)"<br>如["A","ABCD","10","1"]|
4045 4077  
... ... @@ -4126,7 +4158,7 @@ Ver 1.0.1
4126 4158 ```
4127 4159  
4128 4160 <!-- ##### stopKpMultiExam
4129   -- **主题**：/client/\${baseSN}/send
  4161 +- **主题**：/client/{baseSN}/send
4130 4162 - **功能描述**：停止多科测验
4131 4163 - **参数说明**
4132 4164  
... ... @@ -4158,7 +4190,7 @@ Ver 1.0.1
4158 4190 ### 自主录分
4159 4191 #### 方法
4160 4192 ##### startKpScoreInput
4161   -- **主题**：/client/\${baseSN}/send
  4193 +- **主题**：/client/{baseSN}/send
4162 4194 - **功能描述**：启动自主录分
4163 4195 - **参数说明**
4164 4196  
... ... @@ -4201,7 +4233,7 @@ Ver 1.0.1
4201 4233 ```
4202 4234 <!--
4203 4235 ##### stopKpScoreInput
4204   -- **主题**：/client/\${baseSN}/send
  4236 +- **主题**：/client/{baseSN}/send
4205 4237 - **功能描述**：停止自主录分
4206 4238 - **参数说明**
4207 4239  
... ... @@ -4225,7 +4257,7 @@ Ver 1.0.1
4225 4257 发送指令后返回接收状态
4226 4258  
4227 4259 ##### fEvtKpScore
4228   -- **主题**：/basestation/\${baseSN}/receive
  4260 +- **主题**：/basestation/{baseSN}/receive
4229 4261 - **功能描述**：返回键盘提交录分信息
4230 4262 - **参数说明**
4231 4263  
... ... @@ -4257,4 +4289,141 @@ Ver 1.0.1
4257 4289 }
4258 4290 ]
4259 4291 }
  4292 +```
  4293 +
  4294 +### 自定义测验题型标题
  4295 +#### 方法
  4296 +##### setKpExamQuesTitle
  4297 +- **主题**：/client/{baseSN}/send
  4298 +- **功能描述**：设置自定义测验题题型标题，键盘需在线才能接收成功。<br>设置完成后启动测验，对应的题型显示为设置的自定义标题。<br><font color="red">题型标题相对固定，下发成功后键盘会保存标题，标题无变化时无需重复下发</font>
  4299 +- **参数说明**
  4300 +
  4301 +|参数名|类型|限制|是否必填|说明|
  4302 +|---|---|---|---|---|
  4303 +|fun|string|-|是|指令名称|
  4304 +|dataTag|string|-|否|数据包标识,可为空字符串|
  4305 +|data|object|-|是|传送参数的对象数组，不可为空|
  4306 +|+keySns|array||是|需要设置标题的键盘SN数组，为空代表全部在线键盘<br><font color="red">注意：指定键盘下发才有单个键盘下发是否成功的事件，全部在线键盘下发只有统一回复事件</font>|
  4307 +|+type|int||是|需要设置的题目类型<br>1-单选题<br>2-多选题<br>3-数字题<br>4-判断题<br>5-对错题(自判题)|
  4308 +|+title|string||是|设置的标题内容，长度不大于15个字符|
  4309 +
  4310 +
  4311 +- **示例代码**
  4312 +```json
  4313 +//指定下发
  4314 +{
  4315 + "fun":"setKpExamQuesTitle",
  4316 + "dataTag":"1",
  4317 + "data": {
  4318 + "keySns": ["1234567890","1234567891"],
  4319 + "type":1,
  4320 + "title": "请选择"
  4321 + }
  4322 +}
  4323 +
  4324 +//统一下发
  4325 +{
  4326 + "fun":"setKpExamQuesTitle",
  4327 + "dataTag":"1",
  4328 + "data": {
  4329 + "keySns": [],
  4330 + "type":1,
  4331 + "title": "请选择"
  4332 + }
  4333 +}
  4334 +```
  4335 +
  4336 +##### clearKpExamQuesTitle
  4337 +- **主题**：/client/{baseSN}/send
  4338 +- **功能描述**：清除键盘自定义测验题型标题
  4339 +- **参数说明**
  4340 +
  4341 +|参数名|类型|限制|是否必填|说明|
  4342 +|---|---|---|---|---|
  4343 +|fun|string|-|是|指令名称|
  4344 +|dataTag|string|-|否|数据包标识,可为空字符串|
  4345 +|data|object|-|是|传送参数的对象数组|
  4346 +|+type|int||是|需要清除自定义标题的题目类型<br>0-所有题型<br>1-单选题<br>2-多选题<br>3-数字题<br>4-判断题<br>5-对错题(自判题)|
  4347 +|+keySns|array||否|需要清除绑定信息键盘SN数组，<br>空数组表示清空所有键盘|
  4348 +
  4349 +- **示例代码**
  4350 +```json
  4351 +{
  4352 + "fun":"clearKpExamQuesTitle",
  4353 + "dataTag":"1",
  4354 + "data": {
  4355 + "type":0,
  4356 + "keySns":[]
  4357 + }
  4358 +}
  4359 +```
  4360 +
  4361 +#### 事件
  4362 +##### [sEvtStateCode](#sevtstatecode)
  4363 +发送指令后返回接收状态
  4364 +
  4365 +##### fEvtKpExamQuesTitle
  4366 +- **主题**：/basestation/{baseSN}/receive
  4367 +- **功能描述**：返回键盘实时设置绑定信息的状态是否成功
  4368 +- **参数说明**
  4369 +
  4370 +|参数名|类型|限制|非空|说明|
  4371 +|---|---|---|---|---|
  4372 +|fun|string|-|是|指令名称|
  4373 +|dataTag|string|-|否|数据包标识,可为空字符串|
  4374 +|data|array|-|否|返回的对象数组|
  4375 +|++keySn|string||是|设置自定义题型的SN，如果未指定键盘，则keySn为空字符串|
  4376 +|++state|string||是|设置的自定义信息是否成功<br>0 - 成功<br>1 - 失败|
  4377 +
  4378 +- **示例代码**
  4379 +```json
  4380 +//指定下发
  4381 +{
  4382 + "fun":"fEvtKpExamQuesTitle",
  4383 + "dataTag":"1",
  4384 + "data": [
  4385 + {
  4386 + "keySn":"1234567890",
  4387 + "state": "0"
  4388 + },
  4389 + {
  4390 + "keySn":"1234567891",
  4391 + "state": "0"
  4392 + }
  4393 + ]
  4394 +}
  4395 +
  4396 +//统一下发
  4397 +{
  4398 + "fun":"fEvtKpExamQuesTitle",
  4399 + "dataTag":"1",
  4400 + "data": [
  4401 + {
  4402 + "keySn":"",
  4403 + "state": "0"
  4404 + }
  4405 + ]
  4406 +}
  4407 +```
  4408 +##### fEvtClearKpExamQuesTitle
  4409 +- **主题**：/basestation/{baseSN}/receive
  4410 +- **功能描述**：返回清空自定义题型标题的指令状态是否成功
  4411 +- **参数说明**
  4412 +
  4413 +|参数名|类型|限制|非空|说明|
  4414 +|---|---|---|---|---|
  4415 +|fun|string|-|是|指令名称|
  4416 +|dataTag|string|-|否|数据包标识,可为空字符串|
  4417 +|data|object|-|否|传送参数的对象|
  4418 +|+state|string||是|清空自定义标题是否成功<br>0 - 成功<br>1 - 失败|
  4419 +
  4420 +- **示例代码**
  4421 +```json
  4422 +{
  4423 + "fun":"fEvtClearKpExamQuesTitle",
  4424 + "dataTag":"1",
  4425 + "data": {
  4426 + "state": "0"
  4427 + }
  4428 +}
4260 4429 ```
4261 4430 \ No newline at end of file
... ...