添加签到功能

孙向锦
1 parent 5eaddad4
Showing 1 changed file with 70 additions and 2 deletions
海亮定制.md
@@ -157,7 +157,7 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 | m | object | 答题消息的内容(message) 对象或数组 |
 | c | string | 答题器的序号(card) |
 | t | number | 时间戳(10位timestamp) 单位秒 需要先校时 |
-| qm | number | 模式(question model)取值范围：<br> 0：停止 <br> 1：单题  <br> 14：多级编号答题 |
+| qm | number | 模式(question model)取值范围：<br> 0：停止 <br> 1：单题  <br> 7：签到 <br> 14：多级编号答题 |
 | qt | number | 题型（question type），取值范围： <br> 0：字母单选 <br> 1：字母多选 <br> 2：数字题 <br> 3：判断题 <br> 5：抢答 <br> 7: 自判题判断题 |
 | qs | number | 该题型数量（question sum），单题为1，多题则为实际数量。 |
 | qn | number | 题目序号(question No)，题目顺序号 |
@@ -452,8 +452,76 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 | --- | --- |
 | i = 5 |清空白名单 |
-
+### 签到
+#### 开启签到
+由应用程序发给基站，应用按照主题发送
+<br>主题: /lesson/class/${clinetId}/receive
+<br>指令内容：
+```json
+{
+	"i": 12,
+	"en": "6",
+	"qm": 7,
+	"m": {
+		"tp": "pin",
+		"on": 10,
+		"optional": 4,
+		"mode": 1,
+		"content": "hex: c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2"
+	}
+}
+```
+| 名称 | 备注 |
+| --- | --- |
+| i = 12 |下发答题  |
+| en |序号  |
+| qm = 7 |签到 |
+| tp  |签到功能  目前支持传入固定值："pin"  为pin码签到 |
+| on  |选项数  10表示选择 1,2,3,4,5,6,7,8,9,0; 4表示只能选择1,2,3,4 |
+| optional  |可选数量 |
+| mode  |迫选模式 0 允许缺选  1 不允许缺选  2 单个选项可以选多次  3 单个选项可选多次且迫选 |
+| content |签到标题，hex: 为内容的GB2312编码的hex内容 |
+
+
+
+####  接收签到信息
+由基站发给应用程序，应用订阅主题
+<br>主题: /lesson/class/${clinetId}/send
+<br>指令内容：
+```json
+{
+	"i": 13,
+	"en": "6",
+	"qm": 7,
+	"c": "2126833671",
+	"m": [{
+		"a": "6542",
+		"t": 1626016599
+	}]
+}
+```
+| 名称 | 备注 |
+| --- | --- |
+| i = 13 | 签到数据 |
+| t  |提交答案时间 单位秒 需要先校时|
+| a  | 签到信息（签到码） |
+
+
+#### 停止签到
+由应用程序发给基站，应用按照发送
+<br>主题：/lesson/class/${clinetId}/receive 
+<br>指令内容：
+```json
+{
+	"i": 11,
+	"en": "6"
+}
+```
+| 名称 | 备注 |
+| --- | --- |
+| i = 11 | 停止签到 |
+| en |停止对序号6的练习 |