李外 / Protocol

Commit 37f57c56d63b35d6e5bc5bffb01f5e7f400889cc

Authored by 刘琴
1 parent 0f1000be

修改在线测验示例代码，删除自主录分的最小值参数

Inline Side-by-side
Showing 1 changed file with 160 additions and 51 deletions
通讯协议-B200W-MQTT协议[内部].md
  View file @37f57c5
... ... @@ -151,7 +151,7 @@
151 151 ### 键盘管理
152 152 |功能归类|功能|API指令|指令事件|
153 153 |---|---|---|---|
154   -|<font color="red">识别设置 - 出厂编码(内)|<font color="red">设置键盘出厂编码(内)|[setKpSN](#setkpsn)|[fEvtSetKpSN](#fevtsetkpsn)<br>[sEvtBsKpOnlineMsg](#sevtbskponlinemsg)|
  154 +|<font color="red">识别设置 - 出厂编码(内)|<font color="red">设置键盘出厂编码(内)|[setKpSN](#setkpsn)|[fEvtSetKpSN](#fevtsetkpsn)<br>|
155 155 |<font color="red">识别设置 - 键盘编号(内)|<font color="red">设置键盘编号(内)|[setKpID](#setkpid)|[fEvtSetKpID](#fevtsetkpid)|
156 156 |<font color="red">识别设置 - 识别模式(内)|<font color="red">获取键盘识别模式(内)|[getKpIdentityMode](#getkpidentitymode)|[fEvtKpIdentityMode](#fevtkpidentitymode)|
157 157 ||<font color="red">设置键盘识别模式(内)|[setKpIdentityMode](#setkpidentitymode)|[fEvtKpIdentityMode](#fevtkpidentitymode)|
... ... @@ -3524,86 +3524,203 @@
3524 3524 |++answer|array||是|预设提交的按键值<br>格式为"单选题答案,多选题答案;<br>数字题答案;判断题答案(1对2错)"<br>如["A","ABCD","10","1"]|
3525 3525  
3526 3526 - **示例代码**
  3527 +
  3528 +**常用样例**：一级题型 + 显示“Q”开头, 单一题型，全单选题共10题
  3529 +```json
  3530 +{
  3531 + "fun":"startKpExam",
  3532 + "dataTag":"1",
  3533 + "data":{
  3534 + "mode": 1,
  3535 + "examNo": 1,
  3536 + "questions": [{
  3537 + "quesType": 1, //单选题
  3538 + "startNo": 1, //题号从1开始
  3539 + "count":10 //连续10题
  3540 + }],
  3541 + "simParams":{
  3542 + "answer":["A","ABCD","10","1"]
  3543 + }
  3544 + }
  3545 +}
  3546 +```
  3547 +
  3548 +指令样例：一级题型 + 不显示开头，总题数6题
3527 3549 ```json
3528   -//自定义题号
3529 3550 {
3530 3551 "fun":"startKpExam",
3531 3552 "dataTag":"1",
3532 3553 "data":{
3533 3554 "mode": 0,
3534 3555 "examNo": 1,
3535   - "questions": [{
3536   - //题号1-1-1 到1-1-10 共10题单选
3537   - "symbol": "1-1-",
3538   - "quesType": 1,
3539   - "startNo": 1,
3540   - "count":10
3541   - }, {
3542   - //题号2-2和2-3共两题 多选题，5个选项
3543   - "symbol": "2-",
3544   - "quesType": 2,
3545   - "option": 5,
3546   - "startNo": 2,
3547   - "count":2
3548   - }, {
3549   - //题号3-1和3-2共两道数字题
  3556 + //第1、2题单选题，第3、4题多选题，第5题数字，第6题判断，共6题
  3557 + "questions": [{
  3558 + "quesType": 1, //单选题
  3559 + "startNo": 1, //题号从1开始
  3560 + "count":2 //连续2题
  3561 + },{
  3562 + "quesType": 2, //多选题
  3563 + "startNo": 3, //题号从3开始
  3564 + "count":2, //连续2题
  3565 + "option":5
  3566 + },{
  3567 + "quesType": 1, //数字题
  3568 + "startNo": 5, //题号从5开始
  3569 + "count":1 //连续1题
  3570 + },{
  3571 + "quesType": 4, //判断题
  3572 + "startNo": 6, //题号从6开始
  3573 + "count":1 //连续1题
  3574 + }],
  3575 + "simParams":{
  3576 + "answer":["A","ABCD","10","1"]
  3577 + }
  3578 + }
  3579 +}
  3580 +```
  3581 +
  3582 +指令样例：二级题型 + 不显示开头，总题数6题
  3583 +```json
  3584 +{
  3585 + "fun":"startKpExam",
  3586 + "dataTag":"1",
  3587 + "data":{
  3588 + "mode": 0,
  3589 + "examNo": 1,
  3590 + //第1-1、1-2题单选题，第2-1、2-2题多选题，第3-1题数字，第4-1题判断，共6题
  3591 + "questions": [{
  3592 + "symbol": "1-",
  3593 + "quesType": 1, //单选题
  3594 + "startNo": 1, //题号从1-1开始
  3595 + "count":2 //连续2题
  3596 + },{
  3597 + "symbol": "2-",
  3598 + "quesType": 2, //多选题
  3599 + "startNo": 1, //题号从2-1开始
  3600 + "count":2, //连续2题
  3601 + "option":5
  3602 + },{
3550 3603 "symbol": "3-",
3551   - "quesType": 3,
3552   - "startNo": 1,
3553   - "count":2
3554   - }, {
3555   - //题号4和5 ，判断题
3556   - "symbol": "",
3557   - "quesType": 4,
3558   - "startNo": 4,
3559   - "count":2
  3604 + "quesType": 3, //数字题
  3605 + "startNo": 1, //题号从3-1开始
  3606 + "count":1 //连续1题
  3607 + },{
  3608 + "symbol": "4-",
  3609 + "quesType": 4, //判断题
  3610 + "startNo": 1, //题号从4-1开始
  3611 + "count":1 //连续1题
3560 3612 }],
3561 3613 "simParams":{
3562 3614 "answer":["A","ABCD","10","1"]
3563 3615 }
3564 3616 }
3565 3617 }
  3618 +```
3566 3619  
3567   -//显示Q开头
  3620 +指令样例：三级题型 + 不显示开头，总题数6题
  3621 +```json
  3622 +{
  3623 + "fun":"startKpExam",
  3624 + "dataTag":"1",
  3625 + "data":{
  3626 + "mode": 0,
  3627 + "examNo": 1,
  3628 + //第1-1-1、1-1-2题单选题，第1-2-1、1-2-2题多选题，第2-1-1题数字，第3-1-1题判断，共6题
  3629 + "questions": [{
  3630 + "symbol": "1-1-",
  3631 + "quesType": 1, //单选题
  3632 + "startNo": 1, //题号从1-1-1开始
  3633 + "count":2 //连续2题
  3634 + },{
  3635 + "symbol": "1-2-",
  3636 + "quesType": 2, //多选题
  3637 + "startNo": 1, //题号从1-2-1开始
  3638 + "count":2, //连续2题
  3639 + "option":5
  3640 + },{
  3641 + "symbol": "2-1-",
  3642 + "quesType": 3, //数字题
  3643 + "startNo": 1, //题号从2-1-1开始
  3644 + "count":1 //连续1题
  3645 + },{
  3646 + "symbol": "3-1-",
  3647 + "quesType": 4, //判断题
  3648 + "startNo": 1, //题号从3-1-1开始
  3649 + "count":1 //连续1题
  3650 + }],
  3651 + "simParams":{
  3652 + "answer":["A","ABCD","10","1"]
  3653 + }
  3654 + }
  3655 +}
  3656 +```
  3657 +
  3658 +指令样例：一级题型 + 显示“Q”开头, 共6题
  3659 +```json
3568 3660 {
3569 3661 "fun":"startKpExam",
3570 3662 "dataTag":"1",
3571 3663 "data":{
3572 3664 "mode": 1,
3573 3665 "examNo": 1,
3574   - "questions": [{
3575   - //Q1-Q20,单选题
3576   - "symbol": "",
3577   - "quesType": 1,
3578   - "startNo": 1,
3579   - "count":20
  3666 + "questions": [{
  3667 + "quesType": 1, //单选题
  3668 + "startNo": 1, //题号从1开始
  3669 + "count":2 //连续2题
  3670 + },{
  3671 + "quesType": 2, //多选题
  3672 + "startNo": 3, //题号从3开始
  3673 + "count":2, //连续2题
  3674 + "option":5
  3675 + },{
  3676 + "quesType": 1, //数字题
  3677 + "startNo": 5, //题号从5开始
  3678 + "count":1 //连续1题
  3679 + },{
  3680 + "quesType": 4, //判断题
  3681 + "startNo": 6, //题号从6开始
  3682 + "count":1 //连续1题
3580 3683 }],
3581 3684 "simParams":{
3582   - "answer":["A","","",""]
  3685 + "answer":["A","ABCD","10","1"]
3583 3686 }
3584 3687 }
3585 3688 }
  3689 +```
3586 3690  
3587   -//显示题开头
  3691 +指令样例：一级题型 + 显示“题”开头, 共6题
  3692 +```json
3588 3693 {
3589 3694 "fun":"startKpExam",
3590 3695 "dataTag":"1",
3591 3696 "data":{
3592 3697 "mode": 2,
3593 3698 "examNo": 1,
3594   - "questions": [{
3595   - //题1-题20,单选题
3596   - "symbol": "",
3597   - "quesType": 1,
3598   - "startNo": 1,
3599   - "count":20
  3699 + "questions": [{
  3700 + "quesType": 1, //单选题
  3701 + "startNo": 1, //题号从1开始
  3702 + "count":2 //连续2题
  3703 + },{
  3704 + "quesType": 2, //多选题
  3705 + "startNo": 3, //题号从3开始
  3706 + "count":2, //连续2题
  3707 + "option":5
  3708 + },{
  3709 + "quesType": 1, //数字题
  3710 + "startNo": 5, //题号从5开始
  3711 + "count":1 //连续1题
  3712 + },{
  3713 + "quesType": 4, //判断题
  3714 + "startNo": 6, //题号从6开始
  3715 + "count":1 //连续1题
3600 3716 }],
3601 3717 "simParams":{
3602   - "answer":["A","","",""]
  3718 + "answer":["A","ABCD","10","1"]
3603 3719 }
3604 3720 }
3605 3721 }
3606 3722 ```
  3723 +
3607 3724 <!-- ##### stopKpExam
3608 3725 - **主题**：/client/\${baseSN}/send
3609 3726 - **功能描述**：停止标准测验
... ... @@ -3789,7 +3906,6 @@
3789 3906 }, {
3790 3907 "subject":1, //科目1
3791 3908 //题号4和5 ，判断题
3792   - "symbol": "",
3793 3909 "quesType": 4,
3794 3910 "startNo": 4,
3795 3911 "count":2
... ... @@ -3810,7 +3926,6 @@
3810 3926 "questions": [{
3811 3927 "subject":1,
3812 3928 //Q1-Q20,单选题
3813   - "symbol": "",
3814 3929 "quesType": 1,
3815 3930 "startNo": 1,
3816 3931 "count":20
... ... @@ -3831,7 +3946,6 @@
3831 3946 "questions": [{
3832 3947 "subject":1,
3833 3948 //题1-题20,单选题
3834   - "symbol": "",
3835 3949 "quesType": 1,
3836 3950 "startNo": 1,
3837 3951 "count":20
... ... @@ -3889,7 +4003,6 @@
3889 4003 |+mode|int||是|录分模式<br>0-自主录分<br>1-交叉录分，需先输入录分的人员标识|
3890 4004 |+questions|array||是|题目详情|
3891 4005 |++symbol | string||是 | 题号前缀,可为空 |
3892   -|++min |int||是|可输入的最小值，默认为0|
3893 4006 |++max |int||是|可输入的最大值，<=100|
3894 4007 |++digits|int||是|可输入的小数位数，范围0-2|
3895 4008 |++startNo | int||是| 起始题号|
... ... @@ -3904,17 +4017,13 @@
3904 4017 "mode": 0,
3905 4018 "examNo": 0,
3906 4019 "questions": [{
3907   - //题号1-1-1 到1-1-2 共2题,单题满分10分
3908   - "symbol": "1-",
3909   - "min": 0,
  4020 + //题号1 到 2 共2题,单题满分10分
3910 4021 "max":10,
3911 4022 "digits":1,
3912 4023 "startNo": 1,
3913 4024 "count":2
3914 4025 }, {
3915 4026 //题号3到6 共4道题，单题满分5
3916   - "symbol": "",
3917   - "min": 0,
3918 4027 "max":5,
3919 4028 "digits":0,
3920 4029 "startNo": 3,
... ...