1.SDK应用部分，更新了后台签到实例部分。

DMchen
1 parent 672a1818
Showing 2 changed files with 349 additions and 15 deletions
通讯协议-SDK应用部分.md
通讯协议-SDK应用部分[内部].md
@@ -8,7 +8,7 @@ WSCmdApp协议接口说明
  
  
 <div  style="text-align: center;font-size: 30px;">
-Ver5.1.6
+Ver5.1.7
 </div>
 <br>
 <br>
@@ -48,6 +48,7 @@ Ver5.1.6
 |5.1.3| 2023年11月15日|陈定敏|1.  更新语音题接口参数|
 |5.1.5| 2023年12月28日|陈定敏|1.  增加Json指令支持基站id和基站SN两种模式|
 |5.1.6| 2024年02月19日|陈定敏|1.  增加keypadRemoteControl接口<br>2.  增加举手功能接口|
+|5.1.7| 2024年04月22日|陈定敏|1.  增加后台签到接口<br>2.  增加键盘最终提交状态接口|
  
 <br>
  
@@ -491,8 +492,8 @@ params：{} //为空
  
  
 ### 签到设备
-
-#### 开始签到
+#### 普通签到
+##### 开始签到
  
 发送：
  
@@ -522,7 +523,6 @@ params：{}
 		"bindMode": "1",
 		"lessMode": "0",
 		"modifyMode": "1",
-		"limitNumber": "1",
 		"options": "10",
 		"optionalN": "10",
 		"keyValue": "0"
@@ -531,7 +531,7 @@ params：{}
 }
 ```
  
-#### 接收签到信息
+##### 接收签到信息
  
 接收：
  
@@ -561,7 +561,7 @@ infos:{}
 }
 ```
  
-#### 停止签到
+##### 停止签到
  
 发送：
  
@@ -598,13 +598,153 @@ infos:{&quot;state&quot;:&quot;OK&quot;}//返回状态,成功为OK
 }
 ```
  
-#### 支持设备说明
+##### 支持设备说明
  
 |**基站+键盘 **|**支持/不支持**|**备注**|
 | --- | --- | --- |
 |B100-2.4G+S6|支持||                 
 |B200-2.4G+S6|支持||               
 |B200-5.8G+T2|支持||
+#### 后台签到
+##### 设置后台签到模式
+
+注意：此接口只支持广播模式使用。
+
+发送：
+
+fun: "backendBind" //
+params：{}
+
+|**Json字段**| **字段含义** | **赋值及含义**|
+| --- | --- | --- |
+| mode | 签到模式| 0: 关闭 <br> 1: 开启 |
+
+
+指令样例：
+
+```json
+{
+	"fun": "backendBind",
+	"baseId": 0,
+	"baseSn":"2023031402",
+	"params": {
+		"mode": "1"
+	},
+	"packetTag": "1"
+}
+```
+
+接收：
+
+fun: "backendBind" //
+baseId: "1"//接收到指令的基站ID
+infos:{"state":"OK"}//返回状态,成功为OK
+
+指令样例：
+
+```json
+{
+	"fun": "backendBind",
+	"baseId": 1,
+	"baseSn":"2023031402",
+	"infos": {
+		"mode": "1",
+		"state": "OK"
+	},
+	"packetTag": "1"
+}
+```
+
+##### 接收签到信息
+
+接收：
+
+fun: "answerBind" //签到返回
+baseId: "1"//接收到指令的基站ID
+infos:{}
+
+|  Json字段|字段含义|赋值及含义|
+|---|---|---|
+|time|答题时间|单位秒|
+|keySn|键盘Sn||
+|keyValue|键值|键盘提交的值|
+
+指令样例：
+
+```json
+{
+	"fun": "answerBind",
+	"baseId": 1,
+	"baseSn":"2023031402",
+	"infos": {
+		"time": "0",
+		"keySn": "1479824643",
+		"keyValue": "1234"
+	},
+	"packetTag": "1"
+}
+```
+
+
+
+##### 键盘授权
+
+注意：此接口配合后台签到指令使用，只支持指定键盘操作。
+
+发送：
+
+fun: "keyPadAuthorize" //
+baseId: "1"//收到的基站ID
+params:{} //默认空
+
+| **Json字段** | **字段含义** | **赋值及含义** |
+| --- | --- | --- |
+| baseId | 基站ID | 1-32 |
+| authorize | 状态 | 1:成功<br>2:失败|
+
+
+指令样例：
+```json
+{
+	"fun": "keyPadAuthorize",
+	"baseId": 0,
+	"baseSn": "2023031402",
+	"keySnList": [{
+		"keySn": "0112540402"
+	}],
+	"params": {
+		"authorize": "1"
+	},
+	"packetTag": "20"
+}
+```
+
+接收：
+
+fun: "keyPadAuthorize" //
+baseId: "1"//收到的基站ID
+infos:{"authorize":"1"}//返回状态
+
+指令样例：
+```json
+{
+	"fun": "keyPadAuthorize",
+	"baseId": 1,
+	"baseSn":"2023031402",
+	"infos": {
+		"authorize": "1",
+		"keySn": "0112402128"
+	},
+	"packetTag": "20"
+}
+```
+
+##### 支持设备说明
+
+|**基站+键盘 **|**支持/不支持**|**备注**|
+| --- | --- | --- |
+|B100-2.4G+S6|支持||                 
+|B200-2.4G+S6|支持||            
  
 ### 选择题
  
@@ -2641,6 +2781,54 @@ infos:{&quot;state&quot;:&quot;OK&quot;}//返回状态,成功为OK
 }
 ```
  
+#### 键盘最终提交状态
+
+发送：
+
+fun: "keyPadFinalSubmit" //
+baseId: "1"//收到的基站ID
+params:{} //默认空
+
+| **Json字段** | **字段含义** | **赋值及含义** |
+| --- | --- | --- |
+| baseId | 基站ID | 1-32 |
+| commitok | 状态 | 0:解锁 |
+
+
+指令样例：
+```json
+{
+	"fun": "keyPadFinalSubmit",
+	"baseId": 0,
+	"baseSn":"2023031402",
+	"params": {
+		"commitok": "0"
+	},
+	"packetTag": "20"
+}
+```
+
+接收：
+
+fun: "keyPadFinalSubmit" //
+baseId: "1"//收到的基站ID
+infos:{"commitok":"OK"}//返回状态
+
+指令样例：
+```json
+{
+	"fun": "keyPadFinalSubmit",
+	"baseId": 1,
+	"baseSn":"2023031402",
+	"infos": {
+		"commitok": "0",
+		"keySn": "0112402128",
+		"time": "84.5"
+	},
+	"packetTag": "20"
+}
+```
+
 #### 支持设备说明
  
 | **基站+键盘** | **支持** | **备注** |
@@ -5790,3 +5978,6 @@ infos:{ &quot;funId&quot;:&quot;F0001&quot;,&quot;code&quot;:&quot;10002&quot;}//
 |F0115|写入键盘姓名|
 |F0116|键盘关机时间等级|
 |F0117|基础配置模式|
+|F0118|最终提交状态|
+|F0119|后台签到|
+|F0120|键盘授权|
@@ -8,7 +8,7 @@ WSCmdApp协议接口说明
  
  
 <div  style="text-align: center;font-size: 30px;">
-Ver5.1.6
+Ver5.1.7
 </div>
 <br>
 <br>
@@ -48,6 +48,7 @@ Ver5.1.6
 |5.1.3| 2023年11月15日|陈定敏|1.  更新语音题接口参数|
 |5.1.5| 2023年12月28日|陈定敏|1.  增加Json指令支持基站id和基站SN两种模式|
 |5.1.6| 2024年02月19日|陈定敏|1.  增加keypadRemoteControl接口<br>2.  增加举手功能接口|
+|5.1.7| 2024年04月22日|陈定敏|1.  增加后台签到接口<br>2.  增加键盘最终提交状态接口|
  
 <br>
  
@@ -491,8 +492,8 @@ params：{} //为空
  
  
 ### 签到设备
-
-#### 开始签到
+#### 普通签到
+##### 开始签到
  
 发送：
  
@@ -530,7 +531,7 @@ params：{}
 }
 ```
  
-#### 接收签到信息
+##### 接收签到信息
  
 接收：
  
@@ -560,7 +561,7 @@ infos:{}
 }
 ```
  
-#### 停止签到
+##### 停止签到
  
 发送：
  
@@ -597,13 +598,153 @@ infos:{&quot;state&quot;:&quot;OK&quot;}//返回状态,成功为OK
 }
 ```
  
-#### 支持设备说明
+##### 支持设备说明
  
 |**基站+键盘 **|**支持/不支持**|**备注**|
 | --- | --- | --- |
 |B100-2.4G+S6|支持||                 
 |B200-2.4G+S6|支持||               
 |B200-5.8G+T2|支持||
+#### 后台签到
+##### 设置后台签到模式
+
+注意：此接口只支持广播模式使用。
+
+发送：
+
+fun: "backendBind" //
+params：{}
+
+|**Json字段**| **字段含义** | **赋值及含义**|
+| --- | --- | --- |
+| mode | 签到模式| 0: 关闭 <br> 1: 开启 |
+
+
+指令样例：
+
+```json
+{
+	"fun": "backendBind",
+	"baseId": 0,
+	"baseSn":"2023031402",
+	"params": {
+		"mode": "1"
+	},
+	"packetTag": "1"
+}
+```
+
+接收：
+
+fun: "backendBind" //
+baseId: "1"//接收到指令的基站ID
+infos:{"state":"OK"}//返回状态,成功为OK
+
+指令样例：
+
+```json
+{
+	"fun": "backendBind",
+	"baseId": 1,
+	"baseSn":"2023031402",
+	"infos": {
+		"mode": "1",
+		"state": "OK"
+	},
+	"packetTag": "1"
+}
+```
+
+##### 接收签到信息
+
+接收：
+
+fun: "answerBind" //签到返回
+baseId: "1"//接收到指令的基站ID
+infos:{}
+
+|  Json字段|字段含义|赋值及含义|
+|---|---|---|
+|time|答题时间|单位秒|
+|keySn|键盘Sn||
+|keyValue|键值|键盘提交的值|
+
+指令样例：
+
+```json
+{
+	"fun": "answerBind",
+	"baseId": 1,
+	"baseSn":"2023031402",
+	"infos": {
+		"time": "0",
+		"keySn": "1479824643",
+		"keyValue": "1234"
+	},
+	"packetTag": "1"
+}
+```
+
+
+
+##### 键盘授权
+
+注意：此接口配合后台签到指令使用，只支持指定键盘操作。
+
+发送：
+
+fun: "keyPadAuthorize" //
+baseId: "1"//收到的基站ID
+params:{} //默认空
+
+| **Json字段** | **字段含义** | **赋值及含义** |
+| --- | --- | --- |
+| baseId | 基站ID | 1-32 |
+| authorize | 状态 | 1:成功<br>2:失败|
+
+
+指令样例：
+```json
+{
+	"fun": "keyPadAuthorize",
+	"baseId": 0,
+	"baseSn": "2023031402",
+	"keySnList": [{
+		"keySn": "0112540402"
+	}],
+	"params": {
+		"authorize": "1"
+	},
+	"packetTag": "20"
+}
+```
+
+接收：
+
+fun: "keyPadAuthorize" //
+baseId: "1"//收到的基站ID
+infos:{"authorize":"1"}//返回状态
+
+指令样例：
+```json
+{
+	"fun": "keyPadAuthorize",
+	"baseId": 1,
+	"baseSn":"2023031402",
+	"infos": {
+		"authorize": "1",
+		"keySn": "0112402128"
+	},
+	"packetTag": "20"
+}
+```
+
+##### 支持设备说明
+
+|**基站+键盘 **|**支持/不支持**|**备注**|
+| --- | --- | --- |
+|B100-2.4G+S6|支持||                 
+|B200-2.4G+S6|支持||            
  
 ### 选择题
  
@@ -2808,7 +2949,7 @@ params:{} //默认空
 	"baseId": 0,
 	"baseSn":"2023031402",
 	"params": {
-		"commitok": "1"
+		"commitok": "0"
 	},
 	"packetTag": "20"
 }
@@ -7079,4 +7220,6 @@ infos:{ &quot;funId&quot;:&quot;F0001&quot;,&quot;code&quot;:&quot;10002&quot;}//
 |F0115|写入键盘姓名|
 |F0116|键盘关机时间等级|
 |F0117|基础配置模式|
-|F0118|提交状态|
+|F0118|最终提交状态|
+|F0119|后台签到|
+|F0120|键盘授权|