Commit 763bbf9e3520aa8b5f6c0308f327b32ba329bc5c
1 parent
b86f7566
添加mqtt协议
Showing
1 changed file
with
947 additions
and
0 deletions
c200k基站mqtt协议文档对内版.md
0 → 100644
| 1 | +# C200K | |
| 2 | + | |
| 3 | +# 基站 | |
| 4 | + | |
| 5 | +# 开发说明文档 | |
| 6 | + | |
| 7 | +版 本 历 史 | |
| 8 | + | |
| 9 | + | |
| 10 | +|版本/状态 | 日期 | 备注 | | |
| 11 | +| --- | --- | --- | | |
| 12 | +| 1.0 | 2022-9-30 | | | |
| 13 | +| 1.1 | 2022-10-14 | | |
| 14 | +1. 添加刷卡事件 | |
| 15 | +2. 修改套题带题干指令码 | |
| 16 | +原qm =3 修改成qm = 8签到 qm =0 修改成 qm =7 | | |
| 17 | +| 1.2 | |
| 18 | + | 2022-11-21 | | |
| 19 | +1. 离线下载套题带题干 | |
| 20 | +2. 收取离线带题干答案 | |
| 21 | +3. 离线下载多题不带题干 | |
| 22 | +4. 收取离线多题不带题干 | |
| 23 | +5. 收取离线文本 | |
| 24 | +6. 添加了指纹事件 | |
| 25 | + | | |
| 26 | +| 1.3 | 2022-11-30 | | |
| 27 | +1. 考勤功能 | |
| 28 | +2. 添加基站信息设置和读取 | |
| 29 | +3. 在线键盘检测 | |
| 30 | +4. 自动测试模式添加(单题,套题,离线文本收取) | |
| 31 | +5. 键盘关机 | |
| 32 | + | |
| 33 | + | | |
| 34 | +| 1.4 | 2022-12-30 | 第一版协议整理 | | |
| 35 | +| 1.5 | 2023-3-3 | 紫光和指纹答题器协议整合 | | |
| 36 | +| 1.6 | 2024-1-19 | | |
| 37 | +1. 添加pin签到 | |
| 38 | +2. 下发姓名 | |
| 39 | +3. 多级编号题目下发 | |
| 40 | + | | |
| 41 | +| | |
| 42 | + | | |
| 43 | + | | |
| 44 | + | | |
| 45 | + | |
| 46 | +[1. 前言 4](#_Toc13718) | |
| 47 | + | |
| 48 | +[1.1. 背景 4](#_Toc718) | |
| 49 | + | |
| 50 | +[1.2. 编写目的 4](#_Toc3440) | |
| 51 | + | |
| 52 | +[1.3. 读者对象 4](#_Toc31450) | |
| 53 | + | |
| 54 | +[2. 开发流程 4](#_Toc7713) | |
| 55 | + | |
| 56 | +[2.1. MQTT服务器准备 5](#_Toc30569) | |
| 57 | + | |
| 58 | +[2.2. 基站配置 5](#_Toc20774) | |
| 59 | + | |
| 60 | +[2.3. 应用开发 6](#_Toc18021) | |
| 61 | + | |
| 62 | +[3. 功能清单 7](#_Toc1458) | |
| 63 | + | |
| 64 | +[3.1. 支持的功能清单 7](#_Toc14170) | |
| 65 | + | |
| 66 | +[3.2. 协议简介 8](#_Toc23318) | |
| 67 | + | |
| 68 | +[3.2.1. MQTT 8](#_Toc19246) | |
| 69 | + | |
| 70 | +[3.2.2. 协议格式 9](#_Toc21885) | |
| 71 | + | |
| 72 | +[3.2.3. 指令属性介绍 9](#_Toc7095) | |
| 73 | + | |
| 74 | +[3.3. 功能说明 12](#_Toc31431) | |
| 75 | + | |
| 76 | +[3.3.1. 授时 12](#_Toc25808) | |
| 77 | + | |
| 78 | +[3.3.2. 基站管理 12](#_Toc31670) | |
| 79 | + | |
| 80 | +[3.3.3. 键盘管理 15](#_Toc14326) | |
| 81 | + | |
| 82 | +[3.3.4. 签到 17](#_Toc16527) | |
| 83 | + | |
| 84 | +[3.3.5. 单题 18](#_Toc28200) | |
| 85 | + | |
| 86 | +[3.3.6. 多题 20](#_Toc20704) | |
| 87 | + | |
| 88 | +[3.3.7. 套卷带题干 21](#_Toc24866) | |
| 89 | + | |
| 90 | +[3.3.8. 离线套卷带题干下载 23](#_Toc22094) | |
| 91 | + | |
| 92 | +[3.3.9. 离线下载多题不带题干 25](#_Toc22371) | |
| 93 | + | |
| 94 | +[3.3.10. 收取离线文本 28](#_Toc31494) | |
| 95 | + | |
| 96 | +[3.3.11. 多题题号多题 29](#_Toc362) | |
| 97 | + | |
| 98 | +[3.3.12. 下发姓名 30](#_Toc10374) | |
| 99 | + | |
| 100 | +[3.3.13. 基站升级 31](#_Toc6604) | |
| 101 | + | |
| 102 | +[3.3.14. 键盘升级 32](#_Toc4566) | |
| 103 | + | |
| 104 | +[3.3.15. 刷卡事件 33](#_Toc1814) | |
| 105 | + | |
| 106 | +[3.3.16. 指纹事件 33](#_Toc3181) | |
| 107 | + | |
| 108 | +[3.3.17. 考勤 34](#_Toc5523) | |
| 109 | + | |
| 110 | +1. | |
| 111 | +## 前言 | |
| 112 | + | |
| 113 | + 1. | |
| 114 | +## 背景 | |
| 115 | + | |
| 116 | +方便客户基于C200K基站设备使用 通信基站数据接收及解析。 | |
| 117 | + | |
| 118 | + 1. | |
| 119 | +## 编写目的 | |
| 120 | + | |
| 121 | +此说明书是为了说明协议内容,开发流程,方便基于此进行二次开发。 | |
| 122 | + | |
| 123 | + 1. | |
| 124 | +## 读者对象 | |
| 125 | + | |
| 126 | +1. 相关研发人员 | |
| 127 | +2. 方案制定人员 | |
| 128 | +3. 决策人员 | |
| 129 | + | |
| 130 | +1. | |
| 131 | +## 开发流程 | |
| 132 | + | |
| 133 | +C200K基站,采用MQTT协议进行开发,基站接入MQTT服务器,应用从MQTT服务器下发指令和接收数据 | |
| 134 | + | |
| 135 | +整个交互图如下: | |
| 136 | + | |
| 137 | + | |
| 138 | + | |
| 139 | + 1. | |
| 140 | +## MQTT服务器准备 | |
| 141 | + | |
| 142 | +MQTT服务器要求: | |
| 143 | + | |
| 144 | +能够正常收发MQTT数据。 | |
| 145 | + | |
| 146 | +服务器的性能参数由业务决定。 | |
| 147 | + | |
| 148 | +域名: | |
| 149 | + | |
| 150 | +公网域名或ip或者基站所处局域网ip。 | |
| 151 | + | |
| 152 | +MQTT服务器配置结果检查 | |
| 153 | + | |
| 154 | +使用MQTT.FX客户端,配置域名,端口,用户名和密码信息,然后连接,如果提示连接成功,则表示MQTT服务器可用。基站client id 是基站编号。 | |
| 155 | + | |
| 156 | + | |
| 157 | + | |
| 158 | + 1. | |
| 159 | +## 基站配置 | |
| 160 | + | |
| 161 | +通过USB连接基站,打开基站服务器配置软件。 | |
| 162 | + | |
| 163 | + | |
| 164 | + | |
| 165 | +如果基站没有连接电脑,工具显示检测基站中,这时候读写无效。 | |
| 166 | + | |
| 167 | +连接正常后,按照各个信息进行写入。 | |
| 168 | + | |
| 169 | +设置基站服务器域名(ip)、端口,用户信息、密码信息,写入基站。 | |
| 170 | + | |
| 171 | +如果MQTT服务器没有启用用户密码验证,用户密码信息可以随机设置。 | |
| 172 | + | |
| 173 | +拔掉USB,连接网线,接入网络,查看网络是否连接正常。(基站上面的灯是否蓝色闪烁) | |
| 174 | + | |
| 175 | +基站说明 | |
| 176 | + | |
| 177 | + | |
| 178 | + | |
| 179 | + 1. | |
| 180 | +## 应用开发 | |
| 181 | + | |
| 182 | +整体开发流程图如下: | |
| 183 | + | |
| 184 | + | |
| 185 | + | |
| 186 | +1. | |
| 187 | +## 功能清单 | |
| 188 | + | |
| 189 | + 1. | |
| 190 | +## 支持的功能清单 | |
| 191 | + | |
| 192 | +| **功能** | **说明** | | |
| 193 | +| --- | --- | | |
| 194 | +| 授时 | 给基站校时 | | |
| 195 | +| 基站上下线 | 基站上下线信息 | | |
| 196 | +| 键盘上下线 | 键盘上下线信息 | | |
| 197 | +| 刷卡/指纹 | 键盘刷卡/指纹信息 | | |
| 198 | +| 签到 | 答题器按键签到 | | |
| 199 | +| 单题 | 下发一题测验 | | |
| 200 | +| 多题 | 下发多题测验 | | |
| 201 | +| 套卷 | 下发复杂题型测验 | | |
| 202 | +| 离线下载 | 下载试题到键盘,离线答题 | | |
| 203 | +| 基站升级 | 基站固件升级 | | |
| 204 | +| 键盘升级 | 键盘固件升级 | | |
| 205 | +| 基站错误信息上报 | 基站错误信息上报 | | |
| 206 | + | |
| 207 | + 1. | |
| 208 | +## 协议简介 | |
| 209 | + | |
| 210 | + 1. | |
| 211 | +### MQTT | |
| 212 | + | |
| 213 | +关于MQTT说明,请参考 https://mqtt.org/ | |
| 214 | + | |
| 215 | +${clinetId} clinetId 是基站编号,为替换字符串。 | |
| 216 | + | |
| 217 | + 1. | |
| 218 | +#### 应用程序发布的主题 | |
| 219 | + | |
| 220 | +| 主题 | 功能 | | |
| 221 | +| --- | --- | | |
| 222 | +| /client/${clientId}/operate | 基站的设置,查询等指令 | | |
| 223 | +| /lesson/class/${clinetId}/receive | 接收答题的指令 | | |
| 224 | + | |
| 225 | + 1. | |
| 226 | +#### 应用程序订阅的主题 | |
| 227 | + | |
| 228 | +| 主题 | 功能 | | |
| 229 | +| --- | --- | | |
| 230 | +| /client/${clientId}/online | 基站上线通知。 | | |
| 231 | +| /client/${clientId}/offline | 基站下线通知。 | | |
| 232 | +| /client/${clientId}/card/online | 答题器上线通知。 | | |
| 233 | +| /client/${clientId}/card/offline | 答题器离线通知。 | | |
| 234 | +| /client/${clientId}/card/swipe | 答题器刷卡事件 | | |
| 235 | +| /client/${clientId}/report | 基站主动上报状态,或者对设置指令的回应。 | | |
| 236 | +| /lesson/class/${clinetId}/send | 基站对答题/签到数据的反馈 | | |
| 237 | +| /client/${clientId}/card/fingerprint | 指纹事件 | | |
| 238 | +| /client/${clientId}/error | 基站错误信息上报 | | |
| 239 | + | |
| 240 | + 1. | |
| 241 | +### 协议格式 | |
| 242 | + | |
| 243 | + | |
| 244 | + | |
| 245 | +协议采用json格式,数据中字段见属性介绍。 | |
| 246 | + | |
| 247 | + 1. | |
| 248 | +### 指令属性介绍 | |
| 249 | + | |
| 250 | +| 名称 | 类型 | 说明 | | |
| 251 | +| --- | --- | --- | | |
| 252 | +| i | number | 消息指令类型(instruction),取值范围: 1-9999。 I=1 开启白名单 I=2 关闭白名单 I=3 添加白名单 I=4 删除白名单 I=5 清除白名单i = 6 开启考勤i = 7 关闭考勤 i=8 设置考勤信息 i =9 上报考勤数据 i = 11 停止i = 12开启答题/签到 i = 13 接收答题数据 i = 14 键盘上线 i = 15 键盘下线 i = 16 键盘检测 i = 17 基站升级 i = 18 升级报告 i = 19 授时i=20 设置基站信息i=21基站信息上报i=22基站错误信息上报 i = 28 键盘升级 i = 29 键盘升级报告 I= 30 读取白名单 I= 31 白名单上传 i = 40 基站上线 i = 41 基站下线 i = 50 刷卡事件 I = 51 指纹事件 I = 60 姓名下发I = 61 文本预设 | | |
| 253 | +| m | object | 答题消息的内容(message) 对象或数组 | | |
| 254 | +| c | string | 答题器的序号(card) | | |
| 255 | +| t | number | 时间戳(10位timestamp) | | |
| 256 | +| qm | number | 模式(question model)取值范围: 0:停止 1:单题 2:多题 3:套卷 4: 抢答 5:单题测试 6:多题测试 7:签到 8:套卷带题干 9:离线下载套题带题干 10:收取离线带题干答案 11:离线下载多题不带题干 12:收取离线多题不带题干 13:收取离线文本14:多级编号答题 | | |
| 257 | +| qt | number | 题型(question type),取值范围: 0:字母单选 1:字母多选 2:数字题 3:判断题 4: 填空题 ~~5:抢答~~ 6:文本题(目前只支持离线答题) | | |
| 258 | +| qs | number | 该题型数量(question sum),单体为1,多题则为实际数量。 | | |
| 259 | +| qn | number | 题型序号(question No) | | |
| 260 | +| tp | String | 类型,例如在签到中,tp=pin 表示pin签到类型 | | |
| 261 | +| a | string | 答案(answer)示例:字母单选:A字母多选:A|B文本题:hex: 标记是gbk编码的hex内容 | | |
| 262 | +| en | string | 练习(考试)编号(exercise No)每次考试或者练习的唯一编号,用于确定提交的答案属于那次练习。 | | |
| 263 | +| on | number | 单选和多选题的选项数量(option No) | | |
| 264 | +| cid | string | 客户端ID(client Id) | | |
| 265 | +| cm | string | 客户端型号(client Model) | | |
| 266 | +| cv | string | 客户端版本(client Version)基站软件版本号 | | |
| 267 | +| f | number | 信道频点(frequency)基站频点取值:1-80 | | |
| 268 | +| ap | number | 考勤功率(attend Power)取值:0-31,值约小,基站的接收能力约强。 | | |
| 269 | +| rssi | number | 答题器考勤的RSSI阈值,软件实现的过滤。RSSI高于该值的答题器的该次考勤会丢弃。默认0,不过滤。 | | |
| 270 | +| khs | string | 键盘心跳开关(keyboard Heartbeat Switch),on开启,off关闭 | | |
| 271 | +| arti | number | 考勤上报时间间隔(attend Reoprt Time Interval),默认30秒 | | |
| 272 | +| content | string | 题干内容(选项信息都包含在此),中文信息用hex进行传输。内容前面需要 hex:详见后面示例 | | |
| 273 | +| at | Number | Auto Test自动测试,at = 1,则键盘按到约定自动提交目前支持功能:离线问题提取后续功能慢慢增加 | | |
| 274 | +| sn | String | SN 序列号 | | |
| 275 | +| mc | string | Match code 基站配对码 | | |
| 276 | +| mm | number | match mode 基站配对模式 mm = 1 固定模式 mm = 2 自由模式 mm = 3 免配对模式 mm = 4 配对SN模式 mm= 5 自由sn模式 mm= 6 免配对sn模式 mm= 7 免配对同频点sn号模式 mm= 8 免配对多频点sn号模式 mm =9 免配对白名单模式 | |
| 277 | + | | |
| 278 | +| el | number | Electricity 键盘电量 百分比 0.75 75% | | |
| 279 | +| pm | Number | Power mode 关机模式 pm = 0 在线不关机Pm = 1 在线超时关机 | | |
| 280 | +| et | number | 错误类型et =1 基站频点冲突 | | |
| 281 | +| em | String | 错误消息em = "3" 配合et使用,如et=1 em=3 表示3号频点冲突 | | |
| 282 | +| success | number | 0 成功 非0:错误码 | | |
| 283 | + | |
| 284 | + 1. | |
| 285 | +## 功能说明 | |
| 286 | + | |
| 287 | + 1. | |
| 288 | +### 授时 | |
| 289 | + | |
| 290 | +对客户端授时,发送指令即可,基站会完成校时。 | |
| 291 | + | |
| 292 | +| 主题 | /client/${client}/operate | 备注 | | |
| 293 | +| --- | --- | --- | | |
| 294 | +| { "i": 19, "t": 1634802943} | t 当前时间轴 秒 | | |
| 295 | + | |
| 296 | + 1. | |
| 297 | +### 基站管理 | |
| 298 | + | |
| 299 | + 1. | |
| 300 | +#### 基站上线 | |
| 301 | + | |
| 302 | +由基站发给应用程序,应用需要订阅主题 | |
| 303 | + | |
| 304 | +| 主题 | /client/${clientId}/online | 备注 | | |
| 305 | +| --- | --- | --- | | |
| 306 | +| { "i": 40} | 基站上线 | | |
| 307 | + | |
| 308 | + 1. | |
| 309 | +#### 基站下线 | |
| 310 | + | |
| 311 | +由服务器发给应用程序,应用需要订阅主题 | |
| 312 | + | |
| 313 | +| 主题 | /client/${clientId}/offline | 备注 | | |
| 314 | +| --- | --- | --- | | |
| 315 | +| { "i": 41} | 基站下线 | | |
| 316 | + | |
| 317 | + 1. | |
| 318 | +#### 基站信息设置与读取 | |
| 319 | + | |
| 320 | +应用程序发送给基站 | |
| 321 | + | |
| 322 | +| 主题 | /client/${client}/operate | 备注 | | |
| 323 | +| --- | --- | --- | | |
| 324 | +| { "i": 20, "m": { "f": 0, "ap": 0, "rssi": 0, "khs": "on", "mm": 1, "pm": 0, "arti": 30, "mqtt\_ip": "edunew.sunvotecloud.cn", "mqtt\_port": 8443, "mqtt\_username": "admin", "mqtt\_password": "1223456789", "heartbeat":0, "keypad\_af":0, "keypad\_ap":0 }} | f 基站频点ap 考勤功率 rssi 答题器考勤的RSSI阈值 khs 键盘心跳开关 mm 基站配对模式arti 考勤上报时间间隔 pm 键盘关机模式 mqtt\_ip:连接服务器的IP(只能是IP,不能是域名) mqtt\_port:连接mqtt服务器的端口 mqtt\_username: 连接mqtt服务器的用户名 Mqtt\_password:连接mqtt服务器的密码 heartbeat: 心跳 0 关闭 1 开启 Keypad\_af:考勤频率(0-3) keypad\_ap:考勤功率(0-5)注意:如果没有该字段则不设置该值,保持原值下发对有需要修改的值设置完成后,基站信息会自动上报一次 | |
| 325 | + | | |
| 326 | + | |
| 327 | + 1. | |
| 328 | +#### 基站信息上报 | |
| 329 | + | |
| 330 | +基站发送给应用程序 | |
| 331 | + | |
| 332 | +| 主题 | /client/${client}/report | 备注 | | |
| 333 | +| --- | --- | --- | | |
| 334 | +| { "i": 21,"cId":"2024010282" "m": { "f": 1, "ap": 1, "rssi": 1, "khs": "off", "mc": "AFCEABCD", "mm": 4, "sn": "32121234", "arti": 30, "pm": 1, "cm": "1.0.0", "cv": "1.0.0", "mqtt\_ip": "edunew.sunvotecloud.cn", "mqtt\_port": 8443, "mqtt\_username": "admin", "mqtt\_password": "1223456789", "heartbeat":0, "keypad\_af":0, "keypad\_ap":0 | |
| 335 | + | |
| 336 | + }} | f 基站频点ap 考勤功率 rssi 答题器考勤的RSSI阈值 khs 键盘心跳开关 mc 基站配对码 mm 基站配对模式arti 考勤上报时间间隔 sn 基站sn号 cm 客户端设备型号 cv 客户端设备版本 pm 键盘关机模式读取时,会全部返回值 mqtt\_ip:连接服务器的IP mqtt\_port:连接mqtt服务器的端口 mqtt\_username: 连接mqtt服务器的用户名 Mqtt\_password:连接mqtt服务器的密码 heartbeat: 心跳 0 关闭 1 开启 Keypad\_af:考勤频率(0-3 0关闭) keypad\_ap:考勤功率(0-5) cId 基站编号 | |
| 337 | + | | |
| 338 | + | |
| 339 | + 1. | |
| 340 | +#### 基站错误信息上报 | |
| 341 | + | |
| 342 | +基站发送给应用程序 | |
| 343 | + | |
| 344 | +| 主题 | /client/${client}/error | 备注 | | |
| 345 | +| --- | --- | --- | | |
| 346 | +| { "i": 22, "m": { "et": 1, "em": "3" }} | et 错误类型 et = 1 :基站频点冲突 em 错误消息 em=3 :3号频点示例 基站频点3冲突 | | |
| 347 | + | |
| 348 | + 1. | |
| 349 | +### 键盘管理 | |
| 350 | + | |
| 351 | + 1. | |
| 352 | +#### 键盘上线 | |
| 353 | + | |
| 354 | +由基站发给应用程序,应用需要订阅主题 | |
| 355 | + | |
| 356 | +| 主题 | /client/${clientId}/card/online | 备注 | | |
| 357 | +| --- | --- | --- | | |
| 358 | +| { "i":14, "m":[{ "c":"12345", "el":0.75, "t":1626016299 }]} | i = 14 键盘上线 el 电量信息答题器编号和上线时间及电量信息 | | |
| 359 | + | |
| 360 | + 1. | |
| 361 | +#### 键盘下线 | |
| 362 | + | |
| 363 | +由基站发给应用程序,应用需要订阅主题 | |
| 364 | + | |
| 365 | +| 主题 | /client/${clientId}/card/offline | 备注 | | |
| 366 | +| --- | --- | --- | | |
| 367 | +| { "i":15, "m":[{ "c":"12345", "t":1626016299 }]} | i = 15 键盘下线 | |
| 368 | +答题器编号和下线时间 | | |
| 369 | + | |
| 370 | + 1. | |
| 371 | +#### 键盘在线检测 | |
| 372 | + | |
| 373 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 374 | +| --- | --- | --- | | |
| 375 | +| { "i":16} | i = 16应用主动通知键盘发送在线键盘信息。键盘上线参考"键盘上线3.3.3.1" | | |
| 376 | + | |
| 377 | + 1. | |
| 378 | +#### 键盘遥控指令 | |
| 379 | + | |
| 380 | +应用程序发送给基站 | |
| 381 | + | |
| 382 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 383 | +| --- | --- | --- | | |
| 384 | +| { "i":52, "m"{ "cmd":"shutdown" }} | i = 52通知遥控指令 Cmd 不超过16个字符 Cmd = "shutdown"遥控关机Cmd="reset" 遥控重启 | | |
| 385 | + | |
| 386 | + 1. | |
| 387 | +#### 开启白名单 | |
| 388 | + | |
| 389 | +应用程序发送给基站 | |
| 390 | + | |
| 391 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 392 | +| --- | --- | --- | | |
| 393 | +| { "i":1} | i = 1 开启白名单 | | |
| 394 | + | |
| 395 | + 1. | |
| 396 | +#### 关闭白名单 | |
| 397 | + | |
| 398 | +应用程序发送给基站 | |
| 399 | + | |
| 400 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 401 | +| --- | --- | --- | | |
| 402 | +| { "i":2} | i = 2 关闭白名单 | | |
| 403 | + | |
| 404 | + 1. | |
| 405 | +#### 读取白名单 | |
| 406 | + | |
| 407 | +应用程序发送给基站 | |
| 408 | + | |
| 409 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 410 | +| --- | --- | --- | | |
| 411 | +| { "i":30,} | i = 30 读取白名单 | | |
| 412 | + | |
| 413 | +基站发给应用程序 | |
| 414 | + | |
| 415 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 416 | +| --- | --- | --- | | |
| 417 | +| { "i": 31, "total": 1, "current": 1, "m": ["2126932551"]} | i = 31 白名单上传 | | |
| 418 | + | |
| 419 | + 1. | |
| 420 | +#### 添加白名单 | |
| 421 | + | |
| 422 | +应用程序发送给基站 | |
| 423 | + | |
| 424 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 425 | +| --- | --- | --- | | |
| 426 | +| { "i":3, "m":["12345","56789"] | |
| 427 | +} | i = 3 添加白名单m内包含白名单键盘按编号 | | |
| 428 | + | |
| 429 | + 1. | |
| 430 | +#### 删除白名单 | |
| 431 | + | |
| 432 | +应用程序发送给基站 | |
| 433 | + | |
| 434 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 435 | +| --- | --- | --- | | |
| 436 | +| { "i":4, "m":["12345","56789"] | |
| 437 | +} | i = 4 删除白名单m内包含白名单键盘按编号 | | |
| 438 | + | |
| 439 | + 1. | |
| 440 | +#### 清空白名单 | |
| 441 | + | |
| 442 | +应用程序发送给基站 | |
| 443 | + | |
| 444 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 445 | +| --- | --- | --- | | |
| 446 | +| { "i":5} | i = 5 清空白名单 | | |
| 447 | + | |
| 448 | + 1. | |
| 449 | +### 签到 | |
| 450 | + | |
| 451 | + 1. | |
| 452 | +#### 开启签到 | |
| 453 | + | |
| 454 | +由应用程序发给基站,应用按照主题发送 | |
| 455 | + | |
| 456 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 457 | +| --- | --- | --- | | |
| 458 | +| { "i": 12, "en": "12340", "qm": 7, "m": { "tp":"pin", "content":"hex: c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" }} | qm= 7 签到 en 序号(事务)ID,每个任务需要变化 Tp 签到模式 pin表示pin签到 Ok 表示按ok键签到,默认按OK键签到 | |
| 459 | + | |
| 460 | + | | |
| 461 | + | |
| 462 | + 1. | |
| 463 | +#### 接收签到信息 | |
| 464 | + | |
| 465 | +由基站发给应用程序,应用订阅主题 | |
| 466 | + | |
| 467 | +| 主题 | /lesson/class/${clinetId}/send | 备注 | | |
| 468 | +| --- | --- | --- | | |
| 469 | +| { "i":13, "en":"12340", "qm":7, "m":[{ "c":"12345", "a":"6542", "t":1626016299 }] } | qm = 7 签到 en 发起的序号ID c 键盘sn号 t 表示时间A 签到附带信息 | | |
| 470 | + | |
| 471 | + 1. | |
| 472 | +#### 停止签到 | |
| 473 | + | |
| 474 | +由应用程序发给基站,应用按照主题发送 | |
| 475 | + | |
| 476 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 477 | +| --- | --- | --- | | |
| 478 | +| { "i": 11, "en": "12340"} | 停止对序号12340的签到 | | |
| 479 | + | |
| 480 | + 1. | |
| 481 | +#### 签到结果下发 | |
| 482 | + | |
| 483 | +由应用程序发给基站,应用按照主题发送 | |
| 484 | + | |
| 485 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 486 | +| --- | --- | --- | | |
| 487 | +| { "i": 62, "en": "12340" "sn":["1","2"], "m":{ "success":0 "text":"hex:shjdfhkjhkjfd" }} | Pin 签到的签到结果下发 Success 签到状态结果Text 签到信息(例如签到失败) | | |
| 488 | + | |
| 489 | + 1. | |
| 490 | +### 单题 | |
| 491 | + | |
| 492 | + 1. | |
| 493 | +#### 开启答题 | |
| 494 | + | |
| 495 | +由应用程序发给基站,应用按照主题发送 | |
| 496 | + | |
| 497 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 498 | +| --- | --- | --- | | |
| 499 | +| { "i": 12, "en": "12340", "qm": 1, "m": { "qt": 0, "on": 4, "content":"hex: c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" }} | 示例为单题模式的字母单选。题目内容必须要转成GBK 16进制hex进行传输,并且在内容前面标记为hex: qm =1 单题模式 i=12 下发答题/签到指令 qt 字母单选on 选项数content 题目主干内容 | | |
| 500 | +| { "i": 12, "en": "12340", "qm": 1, "at": 1, "m": { "qt": 0, "on": 4, "content":"hex: c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" }} | 添加 at = 1 自动测试,键盘固定答案上传 | | |
| 501 | + | |
| 502 | + 1. | |
| 503 | +#### 接收答题数据 | |
| 504 | + | |
| 505 | +由基站发给应用程序,应用订阅主题 | |
| 506 | + | |
| 507 | +| 主题 | /lesson/class/${clinetId}/send | 备注 | | |
| 508 | +| --- | --- | --- | | |
| 509 | +| { "i":13, "en":"12340", "qm":1, "c":"12345", "m":[{ "qn":1, "a":"A", "t":1626016299 }] } | 按照题号(qn)来上报答题数据,单题题号固定为1, t为提交答案时间文本题:hex: 标记是gbk编码的hex内容 I = 13 上报信息 qm 字母单选题 c 键盘编号 qn 第几题 单选固定是1t 答题时间 | | |
| 510 | + | |
| 511 | + 1. | |
| 512 | +#### 停止答题 | |
| 513 | + | |
| 514 | +由应用程序发给基站,应用按照主题发送 | |
| 515 | + | |
| 516 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 517 | +| --- | --- | --- | | |
| 518 | +| { "i": 11, "en": "12340"} | 停止对序号12340的测验 | | |
| 519 | + | |
| 520 | + 1. | |
| 521 | +### 多题 | |
| 522 | + | |
| 523 | + 1. | |
| 524 | +#### 开启答题 | |
| 525 | + | |
| 526 | +由应用程序发给基站,应用按照主题发送 | |
| 527 | + | |
| 528 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 529 | +| --- | --- | --- | | |
| 530 | +| "i":12, "en":"12341", "qm":2, "m":{ "qt":0, "on": 4, "qs":20, "content":"hex: c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" }} | 示例为多题模式不带内容的快速20道字母单选。 qm =2 多题模式 Qt 题目模式 qt = 0 字母单选 On 选项数量 Qs 题目数量 | |
| 531 | + | | |
| 532 | + | |
| 533 | + 1. | |
| 534 | +#### 接收答题数据 | |
| 535 | + | |
| 536 | +由基站发给应用程序,应用订阅主题 | |
| 537 | + | |
| 538 | +| 主题 | /lesson/class/${clinetId}/send | 备注 | | |
| 539 | +| --- | --- | --- | | |
| 540 | +| { "i":13, "en":"12341", "qm":2, "c":"12345", "m":[{ "qn":1, "a":"A", "t":1626016299 }] } | 按照题号(qn)来上报答题数据,单题题号固定为1, t为提交答案时间 "a":"hex:",文本题:hex: 标记是gbk编码的hex内容 | | |
| 541 | + | |
| 542 | + 1. | |
| 543 | +#### 停止答题 | |
| 544 | + | |
| 545 | +由应用程序发给基站,应用按照主题发送 | |
| 546 | + | |
| 547 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 548 | +| --- | --- | --- | | |
| 549 | +| { "i": 11, "en": "12341"} | 停止对序号12341的测验 | | |
| 550 | + | |
| 551 | + 1. | |
| 552 | +### 套卷 | |
| 553 | + | |
| 554 | + 1. | |
| 555 | +#### 开启答题 | |
| 556 | + | |
| 557 | +由应用程序发给基站,应用按照主题发送 | |
| 558 | + | |
| 559 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 560 | +| --- | --- | --- | | |
| 561 | +| "i":12, "en":"12341", "qm":3, "qs":4, "m":[{ "qt":0, "qs":1, "on":6 },{ "qt":1, "qs":1, "on":6 | |
| 562 | + },{ "qt":3, "qs":1, "on":6 | |
| 563 | + },{ "qt":0, "qs":1, "on":6 }]} | 示例为多题模式不带内容的快速20道字母单选。 qm =3 套卷模式 Qt 题目模式 qt = 0 字母单选 On 选项数量 Qs 题目数量 | |
| 564 | + | | |
| 565 | + | |
| 566 | + 1. | |
| 567 | +#### 接收答题数据 | |
| 568 | + | |
| 569 | +由基站发给应用程序,应用订阅主题 | |
| 570 | + | |
| 571 | +| 主题 | /lesson/class/${clinetId}/send | 备注 | | |
| 572 | +| --- | --- | --- | | |
| 573 | +| { "i":13, "en":"12341", "qm":2, "c":"12345", "m":[{ "qn":1, "a":"A", "t":1626016299 }] } | 按照题号(qn)来上报答题数据,单题题号固定为1, t为提交答案时间 "a":"hex:",文本题:hex: 标记是gbk编码的hex内容 | | |
| 574 | + | |
| 575 | + 1. | |
| 576 | +#### 停止答题 | |
| 577 | + | |
| 578 | +由应用程序发给基站,应用按照主题发送 | |
| 579 | + | |
| 580 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 581 | +| --- | --- | --- | | |
| 582 | +| { "i": 11, "en": "12341"} | 停止对序号12341的测验 | | |
| 583 | + | |
| 584 | + 1. | |
| 585 | +### 抢答 | |
| 586 | + | |
| 587 | + 1. | |
| 588 | +#### 开启答题 | |
| 589 | + | |
| 590 | +由应用程序发给基站,应用按照主题发送 | |
| 591 | + | |
| 592 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 593 | +| --- | --- | --- | | |
| 594 | +| { "i":12, "en":"12341", "qm":4} | 示例为多题模式不带内容的快速20道字母单选。 qm =3 套卷模式 Qt 题目模式 qt = 0 字母单选 On 选项数量 Qs 题目数量 | |
| 595 | + | | |
| 596 | + | |
| 597 | + 1. | |
| 598 | +#### 接收答题数据 | |
| 599 | + | |
| 600 | +由基站发给应用程序,应用订阅主题 | |
| 601 | + | |
| 602 | +| 主题 | /lesson/class/${clinetId}/send | 备注 | | |
| 603 | +| --- | --- | --- | | |
| 604 | +| { "i":13, "en":"12341", "qm":2, "c":"12345", "m":[{ "qn":1, "a":"A", "t":1626016299 }] } | 按照题号(qn)来上报答题数据,单题题号固定为1, t为提交答案时间 "a":"hex:",文本题:hex: 标记是gbk编码的hex内容 | | |
| 605 | + | |
| 606 | + 1. | |
| 607 | +#### 停止答题 | |
| 608 | + | |
| 609 | +由应用程序发给基站,应用按照主题发送 | |
| 610 | + | |
| 611 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 612 | +| --- | --- | --- | | |
| 613 | +| { "i": 11, "en": "12341"} | 停止对序号12341的测验 | | |
| 614 | + | |
| 615 | + 1. | |
| 616 | +### 套卷带题干 | |
| 617 | + | |
| 618 | + 1. | |
| 619 | +#### 开启答题(套卷带题干) | |
| 620 | + | |
| 621 | +由应用程序发给基站,应用按照主题发送 | |
| 622 | + | |
| 623 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 624 | +| --- | --- | --- | | |
| 625 | +| { "i":12, "en":"12342", "qm":8, "qs":4, "total":1, "current":1, "m":[{ "qt":0, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" },{ "qt":1, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" },{ "qt":3, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" },{ "qt":0, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" }] } | 示例: 1道字母单选, 1道字母多选, 1道判断题, 1道字母单选。 I = 12 指令 en = 12342该答题序号为12342,应用程序自定义 qm 题型 total 这次数据一共多少包 current 当前第几包。如果套卷内容过大,需要分包传输,一个包的数据量是整个 json数据不能超过4k(4096个字节)。 m 题目详情 qt 题型 qs 题数 on 选项数 content 题目内容 | | |
| 626 | +| { "i":12, "en":"12342", "qm":8, "qs":4, "total":1, "current":1, "at":1, "m":[{ "qt":0, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" },{ "qt":1, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" },{ "qt":3, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" },{ "qt":0, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" }] } | 比上一个用例多一个 at= 1表示自动测试键盘固定答案上传 | | |
| 627 | + | |
| 628 | + 1. | |
| 629 | +#### 接收答题信息 | |
| 630 | + | |
| 631 | +由基站发给应用程序,应用需要订阅主题 | |
| 632 | + | |
| 633 | +| 主题 | /lesson/class/${clinetId}/send | 备注 | | |
| 634 | +| --- | --- | --- | | |
| 635 | +| { "i":13, "en":"12342", "qm":8, "c":"12345", "m":[{ "qn":1, "a":"A", "t":1626016299 | |
| 636 | + }] } | 按照题号(qn)来上报答题数据,单题题号固定为1, t为提交答案时间示例说明:键盘号为12345的键盘在时间轴1626016299 答的套卷第一题的答案为A "a":"hex:",文本题:hex: 标记是gbk编码的hex内容 | | |
| 637 | + | |
| 638 | + 1. | |
| 639 | +#### 停止答题 | |
| 640 | + | |
| 641 | +由应用程序发给基站,应用按照主题发送 | |
| 642 | + | |
| 643 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 644 | +| --- | --- | --- | | |
| 645 | +| { "i": 11, "en": "12342"} | 停止对序号12342的测验 | | |
| 646 | + | |
| 647 | + 1. | |
| 648 | +### 离线套卷带题干下载 | |
| 649 | + | |
| 650 | + 1. | |
| 651 | +#### 下载套题(套卷带题干) 键盘只能保存一套套卷试题 | |
| 652 | + | |
| 653 | +由应用程序发给基站,应用按照主题发送 | |
| 654 | + | |
| 655 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 656 | +| --- | --- | --- | | |
| 657 | +| { "i":12, "en":"12342", "qm":9, "qs":4, "total":1, "current":1, "m":[{ "qt":0, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" },{ "qt":1, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" },{ "qt":3, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" },{ "qt":0, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" }] } | 示例: 1道字母单选, 1道字母多选, 1道判断题, 1道字母单选。 I = 12 指令 en = 12342该答题序号为12342,应用程序自定义 qm 题型 total 这次数据一共多少包 current 当前第几包。如果套卷内容过大,需要分包传输,一个包的数据量是整个json数据不能超过4k(4096个字节)。 m 题目详情 qt 题型 qs 题数 on 选项数 content 题目内容 | |
| 658 | +套题最多20题,每题不超过50个汉字 | | |
| 659 | + | |
| 660 | + 1. | |
| 661 | +#### 停止下载 | |
| 662 | + | |
| 663 | +由应用程序发给基站,应用按照主题发送 | |
| 664 | + | |
| 665 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 666 | +| --- | --- | --- | | |
| 667 | +| { "i": 11, "en": "12342"} | 停止对序号12342的下载 | | |
| 668 | + | |
| 669 | + 1. | |
| 670 | +#### 收取离线答案(键盘在线) | |
| 671 | + | |
| 672 | +由应用程序发给基站,应用按照主题发送 | |
| 673 | + | |
| 674 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 675 | +| --- | --- | --- | | |
| 676 | +| { "i": 12, "en": "12342", "qm": 10,} | 开始对序号12342的离线答案收取 | | |
| 677 | +| | |
| 678 | + | | |
| 679 | + | | |
| 680 | + | |
| 681 | + 1. | |
| 682 | +#### 接收答题信息 | |
| 683 | + | |
| 684 | +由基站发给应用程序,应用需要订阅主题 | |
| 685 | + | |
| 686 | +| 主题 | /lesson/class/${clinetId}/send | 备注 | | |
| 687 | +| --- | --- | --- | | |
| 688 | +| { "i":13, "en":"12342", "c":"12345", "qm":"10", "m":[{ "qn":1, "a":"A", "t":1626016299 | |
| 689 | + }] } | 按照题号(qn)来上报答题数据,单题题号固定为1, t为提交答案时间示例说明:键盘号为12345的键盘在时间轴1626016299 答的套卷第一题的答案为A "a":"hex:",文本题:hex: 标记是gbk编码的hex内容 | | |
| 690 | + | |
| 691 | + 1. | |
| 692 | +#### 停止收取离线答案 | |
| 693 | + | |
| 694 | +由应用程序发给基站,应用按照主题发送 | |
| 695 | + | |
| 696 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 697 | +| --- | --- | --- | | |
| 698 | +| { "i": 11, "en": "12342"} | 停止对序号12342的下载 | | |
| 699 | + | |
| 700 | + 1. | |
| 701 | +### 离线下载多题不带题干 | |
| 702 | + | |
| 703 | + 1. | |
| 704 | +#### 下载套题 | |
| 705 | + | |
| 706 | +由应用程序发给基站,应用按照主题发送 | |
| 707 | + | |
| 708 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 709 | +| --- | --- | --- | | |
| 710 | +| { "i": 12, "en": "12341", "qm": 11, "m": [{ "qn": 1, "qt": 0, "qs": 20, "on": 4, "content":"hex: c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" }, { "qn": 21, "qt": 1, "qs": 20, "on": 4 }]} | qm = 11示例为多题模式不带内容的快速20道字母单选,20题多选。总题数不能超过200题目前只支持客观题 | | |
| 711 | +| { "i": 12, "en": "12341", "qm": 11, "at": 1, "m": [{ "qn": 1, "qt": 0, "qs": 20, "on": 4 }, { "qn": 21, "qt": 1, "qs": 20, "on": 4 }]} | "at":1 表示自动测试模式。基站根据各题型自动填充答案。 | |
| 712 | + | | |
| 713 | + | |
| 714 | + 1. | |
| 715 | +#### 停止下载套题 | |
| 716 | + | |
| 717 | +由应用程序发给基站,应用按照主题发送 | |
| 718 | + | |
| 719 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 720 | +| --- | --- | --- | | |
| 721 | +| { "i": 11, "en": "12341"} | 停止对序号12341的测验 | | |
| 722 | + | |
| 723 | + 1. | |
| 724 | +#### 开启收取离线多题答案 | |
| 725 | + | |
| 726 | +由应用程序发给基站,应用按照主题发送 | |
| 727 | + | |
| 728 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 729 | +| --- | --- | --- | | |
| 730 | +| { "i": 12, "en": "12342", "qm": 12} | 开始对序号12342的离线答案收取 | | |
| 731 | + | |
| 732 | + 1. | |
| 733 | +#### 离线多题答案收取 | |
| 734 | + | |
| 735 | +基站发给应用程序 | |
| 736 | + | |
| 737 | +| 主题 | /lesson/class/${clinetId}/send | 备注 | | |
| 738 | +| --- | --- | --- | | |
| 739 | +| { "i":13, "en":"12342", "c":"12345", "qm": 12, "m":[{ "qn":1, "a":"A", "t":1626016299 }] } | 按照题号(qn)来上报答题数据,单题题号固定为1, t为提交答案时间示例说明:键盘号为12345的键盘在时间轴1626016299 答的套卷第一题的答案为A "a":"hex:",文本题:hex: 标记是gbk编码的hex内容 | | |
| 740 | + | |
| 741 | + 1. | |
| 742 | +#### 停止收取离线多题答案 | |
| 743 | + | |
| 744 | +由应用程序发给基站,应用按照主题发送 | |
| 745 | + | |
| 746 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 747 | +| --- | --- | --- | | |
| 748 | +| { "i": 11, "en": "12342"} | 停止对序号12342的离线答案收取 | | |
| 749 | + | |
| 750 | + 1. | |
| 751 | +### 收取离线文本 | |
| 752 | + | |
| 753 | + 1. | |
| 754 | +#### 开始收取离线文本 | |
| 755 | + | |
| 756 | +由应用程序发给基站,应用按照主题发送 | |
| 757 | + | |
| 758 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 759 | +| --- | --- | --- | | |
| 760 | +| { "i": 12, "qm": 13} | 正常收取离线文本 | | |
| 761 | +| { "i": 12, "qm": 13, "at": 1} | 自动测试收取离线文本 at = 0 或缺省是正常模式 at = 1 表示自动测试测试 | |
| 762 | + | | |
| 763 | + | |
| 764 | + 1. | |
| 765 | +#### 离线文本收取 | |
| 766 | + | |
| 767 | +基站发给应用程序 | |
| 768 | + | |
| 769 | +| 主题 | /lesson/class/${clinetId}/send | 备注 | | |
| 770 | +| --- | --- | --- | | |
| 771 | +| { "i":13, "en":"12342", "c":"12345", "qm": 13, "m":{ "a":"hex:", "t":1626016299 } } | t为提交答案时间示例说明:键盘号为12345的键盘在时间轴1626016299 答的套卷第一题的答案为 "a":"hex:",文本题:hex: 标记是gbk编码的hex内容 | | |
| 772 | + | |
| 773 | + 1. | |
| 774 | +#### 停止收取离线文本 | |
| 775 | + | |
| 776 | +由应用程序发给基站,应用按照主题发送 | |
| 777 | + | |
| 778 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 779 | +| --- | --- | --- | | |
| 780 | +| { "i": 11} | 停止收取离线文本 | | |
| 781 | + | |
| 782 | + 1. | |
| 783 | +### 多题题号多题 | |
| 784 | + | |
| 785 | + 1. | |
| 786 | +#### 开启答题 | |
| 787 | + | |
| 788 | +由应用程序发给基站,应用按照主题发送 | |
| 789 | + | |
| 790 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 791 | +| --- | --- | --- | | |
| 792 | +| {"i":12, "en":"12341", "qm":14, "qs":3, "m":[{ "qt":0, "on": 4, "qn":"1-1-1", "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" },{ "qt":0, "on": 4, "qn":"2-1" "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" },{ "qt":0, "on": 4, "qn":"3" "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" }]} | 示例为多题模式 qm =14 多题多级编号模式 Qt 题目模式 qt = 0 字母单选 On 选项数量 Qn 题目多级编号 多级编号必须用"-"隔开。其他必须是数字 content 题目内容 | |
| 793 | + | | |
| 794 | + | |
| 795 | + 1. | |
| 796 | +#### 接收答题数据 | |
| 797 | + | |
| 798 | +由基站发给应用程序,应用订阅主题 | |
| 799 | + | |
| 800 | +| 主题 | /lesson/class/${clinetId}/send | 备注 | | |
| 801 | +| --- | --- | --- | | |
| 802 | +| { "i":13, "en":"12341", "qm":14, "c":"12345", "m":[{ "qn":"1-1-1", "a":"A", "t":1626016299 }] } | 按照题号(qn)来上报答题数据,t为提交答案时间 | | |
| 803 | + | |
| 804 | + 1. | |
| 805 | +#### 停止答题 | |
| 806 | + | |
| 807 | +由应用程序发给基站,应用按照主题发送 | |
| 808 | + | |
| 809 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 810 | +| --- | --- | --- | | |
| 811 | +| { "i": 11, "en": "12341"} | 停止对序号12341的测验 | | |
| 812 | + | |
| 813 | + 1. | |
| 814 | +### 下发姓名 | |
| 815 | + | |
| 816 | + 1. | |
| 817 | +#### 姓名下发 | |
| 818 | + | |
| 819 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 820 | +| --- | --- | --- | | |
| 821 | +| { "i":60, "total":1, "current":1, "en":"12342", "qs":2, "m":[{ "sn":"202308093214", "name":"张三", },{ "sn":"202308093215", "name":"李四",}]} | Qs 总下发姓名数量 I=60 姓名下发指令 total 这次数据一共多少包 current 当前第几包。 Sn 键盘编号name 姓名 | | |
| 822 | + | |
| 823 | + 1. | |
| 824 | +#### 成功失败返回 | |
| 825 | + | |
| 826 | +| 主题 | /lesson/class/${clinetId}/send | 备注 | | |
| 827 | +| --- | --- | --- | | |
| 828 | +| { "i":60, "total":1, "current":1, "m":[{ "sn":"202308093214", "success":0 },{ "sn":"202308093215", "success":0}]} | | |
| 829 | + Sn 姓名写成功键盘编号 | |
| 830 | + | | |
| 831 | + | |
| 832 | + 1. | |
| 833 | +### 基站升级 | |
| 834 | + | |
| 835 | + 1. | |
| 836 | +#### 开始升级 | |
| 837 | + | |
| 838 | +| 主题 | /client/${client}/operate | 备注 | | |
| 839 | +| --- | --- | --- | | |
| 840 | +| { "i":17, "m":{ "url":"", "version":"", "CRC":"" }} | url:升级包地址 version:版本号CRC:CRC-32校验码 | | |
| 841 | + | |
| 842 | + 1. | |
| 843 | +#### 升级进度报告 | |
| 844 | + | |
| 845 | +| 主题 | /client/${client}/report | 备注 | | |
| 846 | +| --- | --- | --- | | |
| 847 | +| { "i":18, "m":{ "cId":"123456", "percent":0, "status":0 }} | cId:客户端设备ID percent:升级进度,0-100status:升级状态信息,0:未开始;1:升级中;2:升级成功;4固件版本号错误;5:不在升级名单内;6:升级指令错误;\>127:升级中的错误码。 | | |
| 848 | + | |
| 849 | + 1. | |
| 850 | +### 键盘升级 | |
| 851 | + | |
| 852 | + 1. | |
| 853 | +#### 开始升级 | |
| 854 | + | |
| 855 | +| 主题 | /client/${client}/operate | 备注 | | |
| 856 | +| --- | --- | --- | | |
| 857 | +| { "i":28, "m":{ "url":"", "version":"", "CRC":"" }} | url:升级包地址 version:版本号CRC:CRC-32校验码 | | |
| 858 | + | |
| 859 | + 1. | |
| 860 | +#### 升级进度报告 | |
| 861 | + | |
| 862 | +| 主题 | /client/${client}/report | 备注 | | |
| 863 | +| --- | --- | --- | | |
| 864 | +| { "i":29, "m":{ "cId":"123456", "percent":0, "status":0 }} | cId:客户端设备ID percent:升级进度,0-100 status:升级状态信息, 0:未开始; 1:升级中; 2:升级成功; 4固件版本号错误; 5:不在升级名单内;6:升级指令错误;\>127:升级中的错误码。 | | |
| 865 | + | |
| 866 | + 1. | |
| 867 | +### 刷卡事件 | |
| 868 | + | |
| 869 | +由基站发给应用程序,应用需要订阅主题 | |
| 870 | + | |
| 871 | +| 主题 | /client/${clientId}/card/swipe | 备注 | | |
| 872 | +| --- | --- | --- | | |
| 873 | +| { "i":50, "m":[{ "c":"12345", "el":0.75, "t":1626016299 }]} | i = 50 刷卡事件答题器编号和刷卡时间 | | |
| 874 | + | |
| 875 | + 1. | |
| 876 | +### 指纹事件 | |
| 877 | + | |
| 878 | +由基站发给应用程序,应用需要订阅主题 | |
| 879 | + | |
| 880 | +| 主题 | /client/${clientId}/card/fingerprint | 备注 | | |
| 881 | +| --- | --- | --- | | |
| 882 | +| { "i":51, "m":[{ "c":"12345", "el":0.75, "t":1626016299 }]} | i = 51指纹事件答题器编号和刷卡时间 | | |
| 883 | + | |
| 884 | + 1. | |
| 885 | +### 考勤 | |
| 886 | + | |
| 887 | + 1. | |
| 888 | +#### 打开考勤功能 | |
| 889 | + | |
| 890 | +应用程序发送给基站 | |
| 891 | + | |
| 892 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 893 | +| --- | --- | --- | | |
| 894 | +| { "i":6} | i = 6 开启考勤功能 | | |
| 895 | + | |
| 896 | + 1. | |
| 897 | +#### 关闭考勤功能 | |
| 898 | + | |
| 899 | +应用程序发送给基站 | |
| 900 | + | |
| 901 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 902 | +| --- | --- | --- | | |
| 903 | +| { "i":7} | i = 7 关闭考勤功能 | | |
| 904 | + | |
| 905 | + 1. | |
| 906 | +#### 设置考勤上传频率 | |
| 907 | + | |
| 908 | +应用程序发送给基站 | |
| 909 | + | |
| 910 | +| 主题 | /lesson/class/${clinetId}/receive | 备注 | | |
| 911 | +| --- | --- | --- | | |
| 912 | +| { "i":8, "m":30} | i = 8 设置考勤频率m = 30 表示频率率为30秒采集一次 | | |
| 913 | + | |
| 914 | + 1. | |
| 915 | +#### 上报考勤数据 | |
| 916 | + | |
| 917 | +| 主题 | /lesson/class/${clientId}/attend | 备注 | | |
| 918 | +| --- | --- | --- | | |
| 919 | +| { "i":9, "m":[{ "c":"12345", "t":1626016299 }], "total":4, "current":1} | 内容为答题器序号和时间戳, total为本次上报的总的传输包数,current为当前传输包序号。 | | |
| 920 | + | |
| 921 | + 1. | |
| 922 | +### 文本预设 | |
| 923 | + | |
| 924 | + 1. | |
| 925 | +#### 文本设置 | |
| 926 | + | |
| 927 | +| 主题 | /client/${client}/operate | 备注 | | |
| 928 | +| --- | --- | --- | | |
| 929 | +| { "i":61, "en":"123552", "sn":["12345","56789"], "m":[{ "cmd":81, "text":"",}]} | Cmd:对应测验题显示 1 姓名 2 积分 3 81 单选 82 多选 83 数字 84 判断 85 自判题判断 86 自判题数字 87 清除 Text:文本预设内容,最长不超过8个汉字。 sn 键盘列表 | |
| 930 | + | | |
| 931 | + | |
| 932 | + 1. | |
| 933 | +#### 设置返回 | |
| 934 | + | |
| 935 | +| 主题 | /client/${client}/report | 备注 | | |
| 936 | +| --- | --- | --- | | |
| 937 | +| { "i":61, "en":"123552", "m":[{ "cmd":81, "success":0, "sn":["12345","56789"]}]} | Cmd:对应测验题显示 81单选 82 多选 83 数字 84 判断 85 自判题判断 86 自判题数字 87 清除Text:文本预设内容,最长不超过8个汉字。 | | |
| 938 | + | |
| 939 | + 1. | |
| 940 | +### 学生卡信息上报 | |
| 941 | + | |
| 942 | +主题:/client/${client}/report | |
| 943 | + | |
| 944 | +| 主题 | /client/${client}/report | 备注 | | |
| 945 | +| --- | --- | --- | | |
| 946 | +| { "i":32, "m":[{ "c":"1873373905", "cv":"0.2.2", "hw":"67.0", "t":1638865040 }] } | |
| 947 | + | 消息格式:卡初始化组网的时候会上报一次 c 键盘编号 t 时间 hw 硬件版本号cv 软件版本号 | | |
| 0 | 948 | \ No newline at end of file | ... | ... |