李外 / Protocol

Commit 2f6c6309f5cd4f125a789ab962575ca2cb8bee58

Authored by 刘琴
1 parent 4e55ae70

修改自定义提示下发的keySns的说明，统一keySns的说明

Inline Side-by-side
Showing 1 changed file with 25 additions and 13 deletions
通讯协议-B200W-MQTT协议[内部].md
  View file @2f6c630
... ... @@ -1186,23 +1186,35 @@
1186 1186 |fun|string|-|是|指令名称|
1187 1187 |dataTag|string|-|否|数据包标识,可为空字符串|
1188 1188 |data|array|-|否|传送参数的对象数组|
1189   -|++keySns|array||是|指定的键盘SN数组，可空表示全部在线键盘|
1190   -|++info|string||否|设置的反馈信息，<br>不同键盘可设置不同反馈信息|
  1189 +|++keySns|array||是|指定的键盘SN数组，空数组表示全部在线键盘<br><font color="red">注意：不允许空数组和指定SN数组混合使用<br>包含空数组默认为全部在线键盘，其他指定键盘无效</font>|
  1190 +|++info|string||否|设置的反馈信息<br>不同键盘可设置不同反馈信息|
1191 1191 ```json
  1192 +//分别提示
1192 1193 {
1193 1194 "fun": "rtSetKpUserPrompt",
1194 1195 "dataTag":"1",
1195 1196 "data": [
1196 1197 {
1197   - "keySn": ["1479824643","1479824645"],
  1198 + "keySns": ["1479824643","1479824645"],
1198 1199 "info": "答对了"
1199 1200 },
1200 1201 {
1201   - "keySn": ["1479824644"],
  1202 + "keySns": ["1479824644"],
1202 1203 "info": "答错了"
1203 1204 }
1204 1205 ]
1205 1206 }
  1207 +//统一提示
  1208 +{
  1209 + "fun": "rtSetKpUserPrompt",
  1210 + "dataTag":"1",
  1211 + "data": [
  1212 + {
  1213 + "keySns": [],
  1214 + "info": "答题结束"
  1215 + }
  1216 + ]
  1217 +}
1206 1218 ```
1207 1219 #### 事件
1208 1220 ##### [sEvtStateCode](#sevtstatecode)
... ... @@ -1314,7 +1326,7 @@
1314 1326 |fun|string|-|是|指令名称|
1315 1327 |dataTag|string|-|否|数据包标识,可为空字符串|
1316 1328 |data|object|-|是|传送参数的对象数组|
1317   -|+keySns|array||否|需要执行指令的键盘SN数组,<br>为空表示所有键盘|
  1329 +|+keySns|array||否|需要执行指令的键盘SN数组,<br>空数组表示所有键盘|
1318 1330  
1319 1331 - **示例代码**
1320 1332 ```Json
... ... @@ -1336,7 +1348,7 @@
1336 1348 |fun|string|-|是|指令名称|
1337 1349 |dataTag|string|-|否|数据包标识,可为空字符串|
1338 1350 |data|object|-|是|传送参数的对象数组|
1339   -|+keySns|array||否|需要执行指令的键盘SN数组，为空表示所有键盘|
  1351 +|+keySns|array||否|需要执行指令的键盘SN数组，空数组表示所有键盘|
1340 1352  
1341 1353 - **示例代码**
1342 1354 ```Json
... ... @@ -1496,7 +1508,7 @@
1496 1508 |fun|string|-|是|指令名称|
1497 1509 |dataTag|string|-|否|数据包标识,可为空字符串|
1498 1510 |data|object|-|是|传送参数的对象数组|
1499   -|+keySns|array||否|需要清除绑定信息键盘SN数组，<br>为空表示清空所有键盘|
  1511 +|+keySns|array||否|需要清除绑定信息键盘SN数组，<br>空数组表示清空所有键盘|
1500 1512 ```json
1501 1513 {
1502 1514 "fun": "clearKpBindingInfo",
... ... @@ -1687,7 +1699,7 @@
1687 1699 |fun|string|-|是|指令名称|
1688 1700 |dataTag|string|-|否|数据包标识,可为空字符串|
1689 1701 |data|object|-|是|传送参数的对象|
1690   -|+keySns|array||是|指定的键盘SN数组，可空表示全部在线键盘|
  1702 +|+keySns|array||是|指定的键盘SN数组，空数组表示全部在线键盘|
1691 1703 |+count|int||是|题目数量，1-16，>1多题快答|
1692 1704 |+mode|int||是|1 - True/False 对/错 <br>2 - Yes/No 是/否<br> 3 - √/×|
1693 1705 |+allowModify|int||是|0 - 不允许修改<br>1 - 允许修改|
... ... @@ -1766,7 +1778,7 @@
1766 1778 |fun|string|-|是|指令名称|
1767 1779 |dataTag|string|-|否|数据包标识,可为空字符串|
1768 1780 |data|object|-|是|传送参数的对象|
1769   -|+keySns|array||是|指定的键盘SN数组，可空表示全部在线键盘|
  1781 +|+keySns|array||是|指定的键盘SN数组，空数组表示全部在线键盘|
1770 1782 |+count|int||是|题目数量，1-16，>1多题快答<br>optionalN >1时无效|
1771 1783 |+mode|int||是|显示模式<br>1:显示字母(默认值) </br>2:显示数字 |
1772 1784 |+lessMode|int||是|迫选模式<br>0:可缺选(默认值) </br>1:不可缺选</br>2:允许重复输入</br>3:允许重复输入且不可缺选 |
... ... @@ -1850,7 +1862,7 @@
1850 1862 |fun|string|-|是|指令名称|
1851 1863 |dataTag|string|-|否|数据包标识,可为空字符串|
1852 1864 |data|object|-|是|传送参数的对象|
1853   -|+keySns|array||是|指定的键盘SN数组，可空表示全部在线键盘|
  1865 +|+keySns|array||是|指定的键盘SN数组，空数组表示全部在线键盘|
1854 1866 |+mode|int||是|模式<br>0:无规则 （S6最多16位，T2最多14位）<br>1:带小数位上下限（T2不支持）|
1855 1867 |+digits|int||是|小数位数,范围0-2，mode=1时有效
1856 1868 |+numMin|int||是|可输入下限,mode=1有效<br> digits=0时 范围：0~65535 <br> digits=1时 范围：0~6553 <br> digits=2时 范围：0~655|
... ... @@ -1932,7 +1944,7 @@
1932 1944 |fun|string|-|是|指令名称|
1933 1945 |dataTag|string|-|否|数据包标识,可为空字符串|
1934 1946 |data|object|-|是|传送参数的对象|
1935   -|+keySns|array||是|指定的键盘SN数组，可空表示全部在线键盘|
  1947 +|+keySns|array||是|指定的键盘SN数组，空数组表示全部在线键盘|
1936 1948 |+mode|int||是|模式<br>0:普通抢答|
1937 1949 |+allowModify|int||是|修改模式<br>0 - 不允许修改<br>1 - 允许修改|
1938 1950 |+tip|string||否|提示的标题，长度不超过16字符|
... ... @@ -2124,7 +2136,7 @@
2124 2136 |fun|string|-|是|指令名称|
2125 2137 |dataTag|string|-|否|数据包标识,可为空字符串|
2126 2138 |data|object|-|是|传送参数的对象|
2127   -|+keySns|array||是|指定的键盘SN数组，可空表示全部在线键盘|
  2139 +|+keySns|array||是|指定的键盘SN数组，空数组表示全部在线键盘|
2128 2140 ```json
2129 2141 {
2130 2142 "fun": "rtGetKpExamData",
... ... @@ -2144,7 +2156,7 @@
2144 2156 |fun|string|-|是|指令名称|
2145 2157 |dataTag|string|-|否|数据包标识,可为空字符串|
2146 2158 |data|object|-|是|传送参数的对象|
2147   -|+keySns|array||是|指定的键盘SN数组，可空表示全部在线键盘|
  2159 +|+keySns|array||是|指定的键盘SN数组，空数组表示全部在线键盘|
2148 2160 ```json
2149 2161 {
2150 2162 "fun": "rtKpAllowEdited",
... ...