diff --git a/通讯协议-SDK应用部分.md b/通讯协议-SDK应用部分.md index 62bae91..56d9283 100644 --- a/通讯协议-SDK应用部分.md +++ b/通讯协议-SDK应用部分.md @@ -8,7 +8,7 @@ WSCmdApp协议接口说明
-Ver5.1.6 +Ver5.1.7


@@ -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接口
2. 增加举手功能接口| +|5.1.7| 2024年04月22日|陈定敏|1. 增加后台签到接口
2. 增加键盘最终提交状态接口|
@@ -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:{"state":"OK"}//返回状态,成功为OK } ``` -#### 支持设备说明 +##### 支持设备说明 |**基站+键盘 **|**支持/不支持**|**备注**| | --- | --- | --- | |B100-2.4G+S6|支持|| |B200-2.4G+S6|支持|| |B200-5.8G+T2|支持|| +#### 后台签到 +##### 设置后台签到模式 + +注意：此接口只支持广播模式使用。 + +发送： + +fun: "backendBind" // +params：{} + +|**Json字段**| **字段含义** | **赋值及含义**| +| --- | --- | --- | +| mode | 签到模式| 0: 关闭
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:成功
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:{"state":"OK"}//返回状态,成功为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:{ "funId":"F0001","code":"10002"}// |F0115|写入键盘姓名| |F0116|键盘关机时间等级| |F0117|基础配置模式| +|F0118|最终提交状态| +|F0119|后台签到| +|F0120|键盘授权| diff --git a/通讯协议-SDK应用部分[内部].md b/通讯协议-SDK应用部分[内部].md index b0c99c0..7cf8600 100644 --- a/通讯协议-SDK应用部分[内部].md +++ b/通讯协议-SDK应用部分[内部].md @@ -8,7 +8,7 @@ WSCmdApp协议接口说明
-Ver5.1.6 +Ver5.1.7


@@ -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接口
2. 增加举手功能接口| +|5.1.7| 2024年04月22日|陈定敏|1. 增加后台签到接口
2. 增加键盘最终提交状态接口|
@@ -491,8 +492,8 @@ params：{} //为空 ### 签到设备 - -#### 开始签到 +#### 普通签到 +##### 开始签到 发送： @@ -530,7 +531,7 @@ params：{} } ``` -#### 接收签到信息 +##### 接收签到信息 接收： @@ -560,7 +561,7 @@ infos:{} } ``` -#### 停止签到 +##### 停止签到 发送： @@ -597,13 +598,153 @@ infos:{"state":"OK"}//返回状态,成功为OK } ``` -#### 支持设备说明 +##### 支持设备说明 |**基站+键盘 **|**支持/不支持**|**备注**| | --- | --- | --- | |B100-2.4G+S6|支持|| |B200-2.4G+S6|支持|| |B200-5.8G+T2|支持|| +#### 后台签到 +##### 设置后台签到模式 + +注意：此接口只支持广播模式使用。 + +发送： + +fun: "backendBind" // +params：{} + +|**Json字段**| **字段含义** | **赋值及含义**| +| --- | --- | --- | +| mode | 签到模式| 0: 关闭
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:成功
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:{ "funId":"F0001","code":"10002"}// |F0115|写入键盘姓名| |F0116|键盘关机时间等级| |F0117|基础配置模式| -|F0118|提交状态| +|F0118|最终提交状态| +|F0119|后台签到| +|F0120|键盘授权|