Commit 68de43d285bc4b1cfc2678d897984009f7a71b5a

Authored by DMchen
1 parent 672a1818

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

通讯协议-SDK应用部分.md
... ... @@ -8,7 +8,7 @@ WSCmdApp协议接口说明
8 8  
9 9  
10 10 <div style="text-align: center;font-size: 30px;">
11   -Ver5.1.6
  11 +Ver5.1.7
12 12 </div>
13 13 <br>
14 14 <br>
... ... @@ -48,6 +48,7 @@ Ver5.1.6
48 48 |5.1.3| 2023年11月15日|陈定敏|1. 更新语音题接口参数|
49 49 |5.1.5| 2023年12月28日|陈定敏|1. 增加Json指令支持基站id和基站SN两种模式|
50 50 |5.1.6| 2024年02月19日|陈定敏|1. 增加keypadRemoteControl接口<br>2. 增加举手功能接口|
  51 +|5.1.7| 2024年04月22日|陈定敏|1. 增加后台签到接口<br>2. 增加键盘最终提交状态接口|
51 52  
52 53 <br>
53 54  
... ... @@ -491,8 +492,8 @@ params:{} //为空
491 492  
492 493  
493 494 ### 签到设备
494   -
495   -#### 开始签到
  495 +#### 普通签到
  496 +##### 开始签到
496 497  
497 498 发送:
498 499  
... ... @@ -522,7 +523,6 @@ params:{}
522 523 "bindMode": "1",
523 524 "lessMode": "0",
524 525 "modifyMode": "1",
525   - "limitNumber": "1",
526 526 "options": "10",
527 527 "optionalN": "10",
528 528 "keyValue": "0"
... ... @@ -531,7 +531,7 @@ params:{}
531 531 }
532 532 ```
533 533  
534   -#### 接收签到信息
  534 +##### 接收签到信息
535 535  
536 536 接收:
537 537  
... ... @@ -561,7 +561,7 @@ infos:{}
561 561 }
562 562 ```
563 563  
564   -#### 停止签到
  564 +##### 停止签到
565 565  
566 566 发送:
567 567  
... ... @@ -598,13 +598,153 @@ infos:{&quot;state&quot;:&quot;OK&quot;}//返回状态,成功为OK
598 598 }
599 599 ```
600 600  
601   -#### 支持设备说明
  601 +##### 支持设备说明
602 602  
603 603 |**基站+键盘 **|**支持/不支持**|**备注**|
604 604 | --- | --- | --- |
605 605 |B100-2.4G+S6|支持||
606 606 |B200-2.4G+S6|支持||
607 607 |B200-5.8G+T2|支持||
  608 +#### 后台签到
  609 +##### 设置后台签到模式
  610 +
  611 +注意:此接口只支持广播模式使用。
  612 +
  613 +发送:
  614 +
  615 +fun: "backendBind" //
  616 +params:{}
  617 +
  618 +|**Json字段**| **字段含义** | **赋值及含义**|
  619 +| --- | --- | --- |
  620 +| mode | 签到模式| 0: 关闭 <br> 1: 开启 |
  621 +
  622 +
  623 +指令样例:
  624 +
  625 +```json
  626 +{
  627 + "fun": "backendBind",
  628 + "baseId": 0,
  629 + "baseSn":"2023031402",
  630 + "params": {
  631 + "mode": "1"
  632 + },
  633 + "packetTag": "1"
  634 +}
  635 +```
  636 +
  637 +接收:
  638 +
  639 +fun: "backendBind" //
  640 +baseId: "1"//接收到指令的基站ID
  641 +infos:{"state":"OK"}//返回状态,成功为OK
  642 +
  643 +指令样例:
  644 +
  645 +```json
  646 +{
  647 + "fun": "backendBind",
  648 + "baseId": 1,
  649 + "baseSn":"2023031402",
  650 + "infos": {
  651 + "mode": "1",
  652 + "state": "OK"
  653 + },
  654 + "packetTag": "1"
  655 +}
  656 +```
  657 +
  658 +##### 接收签到信息
  659 +
  660 +接收:
  661 +
  662 +fun: "answerBind" //签到返回
  663 +baseId: "1"//接收到指令的基站ID
  664 +infos:{}
  665 +
  666 +| Json字段|字段含义|赋值及含义|
  667 +|---|---|---|
  668 +|time|答题时间|单位秒|
  669 +|keySn|键盘Sn||
  670 +|keyValue|键值|键盘提交的值|
  671 +
  672 +指令样例:
  673 +
  674 +```json
  675 +{
  676 + "fun": "answerBind",
  677 + "baseId": 1,
  678 + "baseSn":"2023031402",
  679 + "infos": {
  680 + "time": "0",
  681 + "keySn": "1479824643",
  682 + "keyValue": "1234"
  683 + },
  684 + "packetTag": "1"
  685 +}
  686 +```
  687 +
  688 +
  689 +
  690 +##### 键盘授权
  691 +
  692 +注意:此接口配合后台签到指令使用,只支持指定键盘操作。
  693 +
  694 +发送:
  695 +
  696 +fun: "keyPadAuthorize" //
  697 +baseId: "1"//收到的基站ID
  698 +params:{} //默认空
  699 +
  700 +| **Json字段** | **字段含义** | **赋值及含义** |
  701 +| --- | --- | --- |
  702 +| baseId | 基站ID | 1-32 |
  703 +| authorize | 状态 | 1:成功<br>2:失败|
  704 +
  705 +
  706 +指令样例:
  707 +```json
  708 +{
  709 + "fun": "keyPadAuthorize",
  710 + "baseId": 0,
  711 + "baseSn": "2023031402",
  712 + "keySnList": [{
  713 + "keySn": "0112540402"
  714 + }],
  715 + "params": {
  716 + "authorize": "1"
  717 + },
  718 + "packetTag": "20"
  719 +}
  720 +```
  721 +
  722 +接收:
  723 +
  724 +fun: "keyPadAuthorize" //
  725 +baseId: "1"//收到的基站ID
  726 +infos:{"authorize":"1"}//返回状态
  727 +
  728 +指令样例:
  729 +```json
  730 +{
  731 + "fun": "keyPadAuthorize",
  732 + "baseId": 1,
  733 + "baseSn":"2023031402",
  734 + "infos": {
  735 + "authorize": "1",
  736 + "keySn": "0112402128"
  737 + },
  738 + "packetTag": "20"
  739 +}
  740 +```
  741 +
  742 +##### 支持设备说明
  743 +
  744 +|**基站+键盘 **|**支持/不支持**|**备注**|
  745 +| --- | --- | --- |
  746 +|B100-2.4G+S6|支持||
  747 +|B200-2.4G+S6|支持||
608 748  
609 749 ### 选择题
610 750  
... ... @@ -2641,6 +2781,54 @@ infos:{&quot;state&quot;:&quot;OK&quot;}//返回状态,成功为OK
2641 2781 }
2642 2782 ```
2643 2783  
  2784 +#### 键盘最终提交状态
  2785 +
  2786 +发送:
  2787 +
  2788 +fun: "keyPadFinalSubmit" //
  2789 +baseId: "1"//收到的基站ID
  2790 +params:{} //默认空
  2791 +
  2792 +| **Json字段** | **字段含义** | **赋值及含义** |
  2793 +| --- | --- | --- |
  2794 +| baseId | 基站ID | 1-32 |
  2795 +| commitok | 状态 | 0:解锁 |
  2796 +
  2797 +
  2798 +指令样例:
  2799 +```json
  2800 +{
  2801 + "fun": "keyPadFinalSubmit",
  2802 + "baseId": 0,
  2803 + "baseSn":"2023031402",
  2804 + "params": {
  2805 + "commitok": "0"
  2806 + },
  2807 + "packetTag": "20"
  2808 +}
  2809 +```
  2810 +
  2811 +接收:
  2812 +
  2813 +fun: "keyPadFinalSubmit" //
  2814 +baseId: "1"//收到的基站ID
  2815 +infos:{"commitok":"OK"}//返回状态
  2816 +
  2817 +指令样例:
  2818 +```json
  2819 +{
  2820 + "fun": "keyPadFinalSubmit",
  2821 + "baseId": 1,
  2822 + "baseSn":"2023031402",
  2823 + "infos": {
  2824 + "commitok": "0",
  2825 + "keySn": "0112402128",
  2826 + "time": "84.5"
  2827 + },
  2828 + "packetTag": "20"
  2829 +}
  2830 +```
  2831 +
2644 2832 #### 支持设备说明
2645 2833  
2646 2834 | **基站+键盘** | **支持** | **备注** |
... ... @@ -5790,3 +5978,6 @@ infos:{ &quot;funId&quot;:&quot;F0001&quot;,&quot;code&quot;:&quot;10002&quot;}//
5790 5978 |F0115|写入键盘姓名|
5791 5979 |F0116|键盘关机时间等级|
5792 5980 |F0117|基础配置模式|
  5981 +|F0118|最终提交状态|
  5982 +|F0119|后台签到|
  5983 +|F0120|键盘授权|
... ...
通讯协议-SDK应用部分[内部].md
... ... @@ -8,7 +8,7 @@ WSCmdApp协议接口说明
8 8  
9 9  
10 10 <div style="text-align: center;font-size: 30px;">
11   -Ver5.1.6
  11 +Ver5.1.7
12 12 </div>
13 13 <br>
14 14 <br>
... ... @@ -48,6 +48,7 @@ Ver5.1.6
48 48 |5.1.3| 2023年11月15日|陈定敏|1. 更新语音题接口参数|
49 49 |5.1.5| 2023年12月28日|陈定敏|1. 增加Json指令支持基站id和基站SN两种模式|
50 50 |5.1.6| 2024年02月19日|陈定敏|1. 增加keypadRemoteControl接口<br>2. 增加举手功能接口|
  51 +|5.1.7| 2024年04月22日|陈定敏|1. 增加后台签到接口<br>2. 增加键盘最终提交状态接口|
51 52  
52 53 <br>
53 54  
... ... @@ -491,8 +492,8 @@ params:{} //为空
491 492  
492 493  
493 494 ### 签到设备
494   -
495   -#### 开始签到
  495 +#### 普通签到
  496 +##### 开始签到
496 497  
497 498 发送:
498 499  
... ... @@ -530,7 +531,7 @@ params:{}
530 531 }
531 532 ```
532 533  
533   -#### 接收签到信息
  534 +##### 接收签到信息
534 535  
535 536 接收:
536 537  
... ... @@ -560,7 +561,7 @@ infos:{}
560 561 }
561 562 ```
562 563  
563   -#### 停止签到
  564 +##### 停止签到
564 565  
565 566 发送:
566 567  
... ... @@ -597,13 +598,153 @@ infos:{&quot;state&quot;:&quot;OK&quot;}//返回状态,成功为OK
597 598 }
598 599 ```
599 600  
600   -#### 支持设备说明
  601 +##### 支持设备说明
601 602  
602 603 |**基站+键盘 **|**支持/不支持**|**备注**|
603 604 | --- | --- | --- |
604 605 |B100-2.4G+S6|支持||
605 606 |B200-2.4G+S6|支持||
606 607 |B200-5.8G+T2|支持||
  608 +#### 后台签到
  609 +##### 设置后台签到模式
  610 +
  611 +注意:此接口只支持广播模式使用。
  612 +
  613 +发送:
  614 +
  615 +fun: "backendBind" //
  616 +params:{}
  617 +
  618 +|**Json字段**| **字段含义** | **赋值及含义**|
  619 +| --- | --- | --- |
  620 +| mode | 签到模式| 0: 关闭 <br> 1: 开启 |
  621 +
  622 +
  623 +指令样例:
  624 +
  625 +```json
  626 +{
  627 + "fun": "backendBind",
  628 + "baseId": 0,
  629 + "baseSn":"2023031402",
  630 + "params": {
  631 + "mode": "1"
  632 + },
  633 + "packetTag": "1"
  634 +}
  635 +```
  636 +
  637 +接收:
  638 +
  639 +fun: "backendBind" //
  640 +baseId: "1"//接收到指令的基站ID
  641 +infos:{"state":"OK"}//返回状态,成功为OK
  642 +
  643 +指令样例:
  644 +
  645 +```json
  646 +{
  647 + "fun": "backendBind",
  648 + "baseId": 1,
  649 + "baseSn":"2023031402",
  650 + "infos": {
  651 + "mode": "1",
  652 + "state": "OK"
  653 + },
  654 + "packetTag": "1"
  655 +}
  656 +```
  657 +
  658 +##### 接收签到信息
  659 +
  660 +接收:
  661 +
  662 +fun: "answerBind" //签到返回
  663 +baseId: "1"//接收到指令的基站ID
  664 +infos:{}
  665 +
  666 +| Json字段|字段含义|赋值及含义|
  667 +|---|---|---|
  668 +|time|答题时间|单位秒|
  669 +|keySn|键盘Sn||
  670 +|keyValue|键值|键盘提交的值|
  671 +
  672 +指令样例:
  673 +
  674 +```json
  675 +{
  676 + "fun": "answerBind",
  677 + "baseId": 1,
  678 + "baseSn":"2023031402",
  679 + "infos": {
  680 + "time": "0",
  681 + "keySn": "1479824643",
  682 + "keyValue": "1234"
  683 + },
  684 + "packetTag": "1"
  685 +}
  686 +```
  687 +
  688 +
  689 +
  690 +##### 键盘授权
  691 +
  692 +注意:此接口配合后台签到指令使用,只支持指定键盘操作。
  693 +
  694 +发送:
  695 +
  696 +fun: "keyPadAuthorize" //
  697 +baseId: "1"//收到的基站ID
  698 +params:{} //默认空
  699 +
  700 +| **Json字段** | **字段含义** | **赋值及含义** |
  701 +| --- | --- | --- |
  702 +| baseId | 基站ID | 1-32 |
  703 +| authorize | 状态 | 1:成功<br>2:失败|
  704 +
  705 +
  706 +指令样例:
  707 +```json
  708 +{
  709 + "fun": "keyPadAuthorize",
  710 + "baseId": 0,
  711 + "baseSn": "2023031402",
  712 + "keySnList": [{
  713 + "keySn": "0112540402"
  714 + }],
  715 + "params": {
  716 + "authorize": "1"
  717 + },
  718 + "packetTag": "20"
  719 +}
  720 +```
  721 +
  722 +接收:
  723 +
  724 +fun: "keyPadAuthorize" //
  725 +baseId: "1"//收到的基站ID
  726 +infos:{"authorize":"1"}//返回状态
  727 +
  728 +指令样例:
  729 +```json
  730 +{
  731 + "fun": "keyPadAuthorize",
  732 + "baseId": 1,
  733 + "baseSn":"2023031402",
  734 + "infos": {
  735 + "authorize": "1",
  736 + "keySn": "0112402128"
  737 + },
  738 + "packetTag": "20"
  739 +}
  740 +```
  741 +
  742 +##### 支持设备说明
  743 +
  744 +|**基站+键盘 **|**支持/不支持**|**备注**|
  745 +| --- | --- | --- |
  746 +|B100-2.4G+S6|支持||
  747 +|B200-2.4G+S6|支持||
607 748  
608 749 ### 选择题
609 750  
... ... @@ -2808,7 +2949,7 @@ params:{} //默认空
2808 2949 "baseId": 0,
2809 2950 "baseSn":"2023031402",
2810 2951 "params": {
2811   - "commitok": "1"
  2952 + "commitok": "0"
2812 2953 },
2813 2954 "packetTag": "20"
2814 2955 }
... ... @@ -7079,4 +7220,6 @@ infos:{ &quot;funId&quot;:&quot;F0001&quot;,&quot;code&quot;:&quot;10002&quot;}//
7079 7220 |F0115|写入键盘姓名|
7080 7221 |F0116|键盘关机时间等级|
7081 7222 |F0117|基础配置模式|
7082   -|F0118|提交状态|
  7223 +|F0118|最终提交状态|
  7224 +|F0119|后台签到|
  7225 +|F0120|键盘授权|
... ...