SDK应用部分

1.增加keypadRemoteControl接口 2.增加举手功能接口

SDK应用部分
1.增加keypadRemoteControl接口 2.增加举手功能接口
DMchen
1 parent cfd7dae6
Showing 2 changed files with 231 additions and 5 deletions
通讯协议-SDK应用部分.md
通讯协议-SDK应用部分[内部].md
@@ -8,7 +8,7 @@ WSCmdApp协议接口说明
 <div  style="text-align: center;font-size: 30px;">
-Ver5.1.5
+Ver5.1.6
 </div>
 <br>
 <br>
@@ -47,6 +47,7 @@ Ver5.1.5
 |5.1.2| 2023年11月07日|陈定敏|1.  增加配对模式设置接口|
 |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.  增加举手功能接口|
 <br>
@@ -4772,7 +4773,7 @@ params：{&quot;mode&quot;:&quot;1&quot;, &quot;value&quot;:&quot;4&quot;}//
 | **Json字段** | **字段含义** | **赋值及含义** |
 | --- | --- | --- |
 |mode|反馈模式| 0:不启用（默认0不启用）<br>1:通用键码|
-|value|反馈最大有效按键|1\~10|
+|value|反馈最大有效按键|1~10|
 指令样例：
@@ -4924,6 +4925,135 @@ infos:{ &quot;hModel&quot;: &quot;67&quot;,&quot;keySn&quot;:&quot;1479824643&quot;,&quot;keyValue&quot;:&quot;0&quot;,&quot;ver&quot;:&quot;1.0.0&quot;,&quot;volt&quot;:
 | B200-2.4G+S6 | 支持 |出厂配置有心跳时反馈，出厂配置无心跳时不反馈|
+#### S7键盘遥控器反馈[上报] 
+特定的遥控器键盘反馈数据接口。
+
+| **Json字段** | **字段含义** | **赋值及含义** |
+| --- | --- | --- |
+|keySn|键盘Sn||
+|keyValue|值|1~17|
+|count|提交次数|1~255|
+
+指令样例：
+
+```json
+{
+	"fun": "keypadRemoteControl",
+	"baseId": 1,
+	"baseSn":"2023031402",
+	"infos": {
+		"keySn": "1479824643",
+		"keyValue": "1",
+		"count": "1"
+	},
+	"packetTag": "0"
+}
+```
+键值对应请参考图片，如下：
+![](img/S7遥控器键盘键值分布图.png)
+
+
+支持设备说明
+
+| **基站+键盘** | **支持** | **备注** |
+| --- | --- | --- |
+| B100-2.4G+S7 | 支持 ||
+| B200-2.4G+S7 | 支持 ||
+
+#### 键盘举手功能参数
+
+读
+发送：
+fun: "readKeypadHandUpMode" //读键盘举手功能参数
+baseId:  1//1~32 (必须指定基站)
+params：{}//读取时不需要
+
+指令样例：
+
+```json
+{
+	"fun": "readKeypadHandUpMode",
+	"baseId": 1,
+	"baseSn":"2023031402",
+	"packetTag": "1"
+}
+```
+
+写
+
+发送：
+fun: "writeKeypadHandUpMode" //写键盘举手功能参数
+baseId: 1//1~32 (必须指定基站)
+params：{"value":"0"}//
+
+| **Json字段** | **字段含义** | **赋值及含义** |
+| --- | --- | --- |
+|value|举手功能开关|0：关闭举手功能<br>1：开启举手功能|
+
+指令样例：
+
+```json
+{
+	"fun": "writeKeypadHandUpMode",
+	"baseId": 1,
+	"baseSn":"2023031402",
+	"params": {
+		"value": "0"
+	},
+	"packetTag": "1"
+}
+```
+
+返回
+
+接收：
+fun: "KeypadHandUpMode" 
+baseId: 1//基站ID
+infos:{ "value":"0"}//返回参数值
+
+| **Json字段** | **字段含义** | **赋值及含义** |
+| --- | --- | --- |
+|value|举手功能开关|0：关闭举手功能<br>1：开启举手功能|
+
+指令样例：
+```json
+{
+	"fun": "KeypadHandUpMode",
+	"baseId": 1,
+	"baseSn":"2023031402",
+	"infos": {
+		"value": "0"
+	},
+	"packetTag": "1"
+}
+```
+
+
+下面是键盘按了举手键后接收到指令。
+
+接收：
+fun: "keypadHandUp" 
+指令样例：
+```json
+{	
+	"fun": "keypadHandUp",
+	"baseId": 1,
+	"baseSn":"2023031402",
+	"infos": {
+		"keySn": "0589445416"
+	},
+	"packetTag": "2"
+}
+```
+
+
+
+支持设备说明
+
+| **基站+键盘** | **支持** | **备注** |
+| --- | --- | --- |
+| B100-2.4G+S7 | 支持 |  |
+| B200-2.4G+S7 | 支持 |  |
 #### 遥控键盘关机
@@ -8,7 +8,7 @@ WSCmdApp协议接口说明
 <div  style="text-align: center;font-size: 30px;">
-Ver5.1.5
+Ver5.1.6
 </div>
 <br>
 <br>
@@ -47,6 +47,7 @@ Ver5.1.5
 |5.1.2| 2023年11月07日|陈定敏|1.  增加配对模式设置接口|
 |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.  增加举手功能接口|
 <br>
@@ -5693,7 +5694,7 @@ params：{&quot;mode&quot;:&quot;1&quot;, &quot;value&quot;:&quot;4&quot;}//
 | **Json字段** | **字段含义** | **赋值及含义** |
 | --- | --- | --- |
 |mode|反馈模式| 0:不启用（默认0不启用）<br>1:通用键码|
-|value|反馈最大有效按键|1\~10|
+|value|反馈最大有效按键|1~10|
 指令样例：
@@ -5863,7 +5864,7 @@ infos:{ &quot;hModel&quot;: &quot;67&quot;,&quot;keySn&quot;:&quot;1479824643&quot;,&quot;keyValue&quot;:&quot;0&quot;,&quot;ver&quot;:&quot;1.0.0&quot;,&quot;volt&quot;:
 	"baseSn":"2023031402",
 	"infos": {
 		"keySn": "1479824643",
-		"keyValue": "0",
+		"keyValue": "1",
 		"count": "1"
 	},
 	"packetTag": "0"
@@ -5880,6 +5881,101 @@ infos:{ &quot;hModel&quot;: &quot;67&quot;,&quot;keySn&quot;:&quot;1479824643&quot;,&quot;keyValue&quot;:&quot;0&quot;,&quot;ver&quot;:&quot;1.0.0&quot;,&quot;volt&quot;:
 | B100-2.4G+S7 | 支持 ||
 | B200-2.4G+S7 | 支持 ||
+#### 键盘举手功能参数
+
+读
+发送：
+fun: "readKeypadHandUpMode" //读键盘举手功能参数
+baseId:  1//1~32 (必须指定基站)
+params：{}//读取时不需要
+
+指令样例：
+
+```json
+{
+	"fun": "readKeypadHandUpMode",
+	"baseId": 1,
+	"baseSn":"2023031402",
+	"packetTag": "1"
+}
+```
+
+写
+
+发送：
+fun: "writeKeypadHandUpMode" //写键盘举手功能参数
+baseId: 1//1~32 (必须指定基站)
+params：{"value":"0"}//
+
+| **Json字段** | **字段含义** | **赋值及含义** |
+| --- | --- | --- |
+|value|举手功能开关|0：关闭举手功能<br>1：开启举手功能|
+
+指令样例：
+
+```json
+{
+	"fun": "writeKeypadHandUpMode",
+	"baseId": 1,
+	"baseSn":"2023031402",
+	"params": {
+		"value": "0"
+	},
+	"packetTag": "1"
+}
+```
+
+返回
+
+接收：
+fun: "KeypadHandUpMode" 
+baseId: 1//基站ID
+infos:{ "value":"0"}//返回参数值
+
+| **Json字段** | **字段含义** | **赋值及含义** |
+| --- | --- | --- |
+|value|举手功能开关|0：关闭举手功能<br>1：开启举手功能|
+
+指令样例：
+```json
+{
+	"fun": "KeypadHandUpMode",
+	"baseId": 1,
+	"baseSn":"2023031402",
+	"infos": {
+		"value": "0"
+	},
+	"packetTag": "1"
+}
+```
+
+
+下面是键盘按了举手键后接收到指令。
+
+接收：
+fun: "keypadHandUp" 
+指令样例：
+```json
+{	
+	"fun": "keypadHandUp",
+	"baseId": 1,
+	"baseSn":"2023031402",
+	"infos": {
+		"keySn": "0589445416"
+	},
+	"packetTag": "2"
+}
+```
+
+
+
+支持设备说明
+
+| **基站+键盘** | **支持** | **备注** |
+| --- | --- | --- |
+| B100-2.4G+S7 | 支持 |  |
+| B200-2.4G+S7 | 支持 |  |
+
 #### 遥控键盘关机
 写