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