From cbb226ff41418c9a5499056ae8f280735ef922b1 Mon Sep 17 00:00:00 2001 From: 刘琴 Date: Mon, 20 May 2024 09:54:22 +0800 Subject: [PATCH] 快速下发类键盘执行结果拆回具体的方法中，这样更直观一些，定义测验的examNo=0时，基站启动新的测验，>0时根据examNo决定是否继续答题 --- 通讯协议-B200W-MQTT协议[内部].md | 179 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++------------------------------------------------ 1 file changed, 131 insertions(+), 48 deletions(-) diff --git a/通讯协议-B200W-MQTT协议[内部].md b/通讯协议-B200W-MQTT协议[内部].md index d29e5d1..eb5647f 100644 --- a/通讯协议-B200W-MQTT协议[内部].md +++ b/通讯协议-B200W-MQTT协议[内部].md @@ -92,7 +92,7 @@ |识别设置 - 识别模式(内)|获取键盘识别模式(内)|[getKpIdentityMode](#getkpidentitymode)|[fEvtKpIdentityMode](#fevtkpidentitymode)| ||设置键盘识别模式(内)|[setKpIdentityMode](#setkpidentitymode)|[fEvtKpIdentityMode](#fevtkpidentitymode)| |交互设置 - 用户内置状态语|设置用户内置状态语|[setKpUserStbMsg](#setkpuserstbmsg)|[fEvtKpUserStbMsg](#fevtkpuserstbmsg)| -|交互设置 - 用户实时提示信息|实时设置提示反馈信息|[rtSetKpUserPrompt](#rtsetkpuserprompt)|[sEvtStateCode](#sevtstatecode)
[sEvtKpExecState](#sevtkpexecstate)| +|交互设置 - 用户实时提示信息|实时设置提示反馈信息|[rtSetKpUserPrompt](#rtsetkpuserprompt)|[sEvtStateCode](#sevtstatecode)
[fEvtSetKpUserPrompt](#fevtsetkpuserprompt)| |在线状态获取|开启扫描在线键盘|[startGetKpOnline](#startgetkponline)|[sEvtStateCode](#sevtstatecode)
[sEvtBsKpOnlineMsg](#sevtbskponlinemsg)| ||停止扫描在线键盘|[stopGetKpOnline](#stopgetkponline)|[sEvtStateCode](#sevtstatecode)| |维护功能 - 遥控功能|遥控键盘关机|[remoteKpPowerOff](#remotekppoweroff)|[fEvtRemoteKpPowerOff](#fevtremotekppoweroff)| @@ -101,14 +101,14 @@ ### 绑定 |功能归类|功能|API指令|指令事件| |---|---|---|---| -|无线绑定|设置绑定信息到键盘|[rtSetKpBindingInfo](#rtsetkpbindinginfo)|[sEvtStateCode](#sevtstatecode)
[sEvtKpExecState](#sevtkpexecstate)| -||清除键盘绑定信息|[clearKpBindingInfo](#clearkpbindinginfo)|[sEvtStateCode](#sevtstatecode)
[sEvtKpExecState](#sevtkpexecstate)| +|无线绑定|设置绑定信息到键盘|[rtSetKpBindingInfo](#rtsetkpbindinginfo)|[sEvtStateCode](#sevtstatecode)
[fEvtKpBindingInfo](#fevtkpbindinginfo)| +||清除键盘绑定信息|[clearKpBindingInfo](#clearkpbindinginfo)|[sEvtStateCode](#sevtstatecode)
[fEvtClearKpBindingInfo](#fevtclearkpbindinginfo)| ### 签到 |功能归类|功能|API指令|指令事件| |---|---|---|---| |随时签到|启动随时签到|[rtStartKpSignIn](#rtstartkpsignin)|[sEvtStateCode](#sevtstatecode)
[fEvtKpSignIn](#fevtkpsignin)| ||停止随时签到|[rtStopKpSignIn](#rtstopkpsignin)|[sEvtStateCode](#sevtstatecode)| -||实时PIN签到授权|[rtSetKpLoginAllowed](#rtsetkploginallowed)|[sEvtStateCode](#sevtstatecode)
[sEvtKpExecState](#sevtkpexecstate)| +||实时PIN签到授权|[rtSetKpLoginAllowed](#rtsetkploginallowed)|[sEvtStateCode](#sevtstatecode)
[fEvtKpLoginAllowed](#fevtkploginallowed)| ### 按键反馈 |功能归类|功能|API指令|指令事件| |---|---|---|---| @@ -126,7 +126,7 @@ |标准测验|启动标准测验|[startKpExam](#startkpexam)|[sEvtStateCode](#sevtstatecode)
[fEvtKpExam](#fevtkpexam)
[fEvtFinalSubmit](#fevtfinalsubmit)| ||停止标准测验|[stopKpExam](#stopkpexam)|[sEvtStateCode](#sevtstatecode)| ||刷新作答数据|[rtGetKpExamData](#rtgetkpexamdata)|[fEvtKpExam](#fevtkpexam)| -||允许键盘提交后退回修改|[rtAllowEdited](#rtkpallowedited)|[sEvtStateCode](#sevtstatecode)
[sEvtKpExecState](#sevtkpexecstate)| +||允许键盘提交后退回修改|[rtAllowEdited](#rtkpallowedited)|[sEvtStateCode](#sevtstatecode)
[fEvtKpAllowEdited](#fevtkpallowedited)| ## 公共事件 ### sEvtBsConnectState @@ -279,39 +279,6 @@ } } ``` - -### sEvtKpExecState -- **主题**: /basestation/\${baseSN}/receive -- **功能描述**：返回基站接收指令后对键盘设置的是否成功 -- **参数说明** - -|参数名|类型|限制|非空|说明| -|---|---|---|---|---| -|fun|string|-|是|事件名称| -|dataTag|string|-|否|数据包标识| -|data|object|-|是|传送参数的对象| -|+funName|string||是|指令名称| -|+states|array||是|返回键盘的执行结果| -|++keySn|string||是|键盘sn| -|++state|int||是|0-成功
1-失败| - -- **示例代码** -```Json -{ - "fun":"sEvtKpExecState", - "dataTag":"1", - "data":{ - "funName":"clearKpBindingInfo", - "states":[ - { - "keySn":"1234567890", - "state":0 - } - ] - } -} -``` - ## 基站管理 ### 基站连接 #### 方法 @@ -1409,6 +1376,9 @@ } ``` #### 事件 +##### [sEvtStateCode](#sevtstatecode) +发送指令后返回接收状态 + ##### fEvtKpUserStbMsg - **主题**：/basestation/\${baseSN}/receive - **功能描述**：返回设置状态语的状态 @@ -1431,9 +1401,38 @@ } } ``` +##### fEvtSetKpUserPrompt +- **主题**：/basestation/\${baseSN}/receive +- **功能描述**：返回实时设置提示语是否成功 +- **参数说明** -##### [sEvtKpExecState](#sevtkpsetstate) - +|参数名|类型|限制|非空|说明| +|---|---|---|---|---| +|fun|string|-|是|指令名称| +|dataTag|string|-|否|数据包标识,可为空字符串| +|data|array|-|是|传送参数的对象数组| +|++keySn|string||是|设置提示语信息的键盘SN| +|++state|string||是|设置的提示语是否成功
0 - 成功
1 - 失败| +```json +{ + "fun": "fEvtSetKpUserPrompt", + "dataTag":"1", + "data": [ + { + "keySn": "1479824643", + "state": "0" + }, + { + "keySn": "1479824645", + "state": "0" + }, + { + "keySn": "1479824644", + "state": "1" + } + ] +} +``` ### 在线状态 #### 方法 ##### startGetKpOnline @@ -1700,9 +1699,54 @@ ##### [sEvtStateCode](#sevtstatecode) 发送指令后返回接收状态 -##### [sEvtKpExecState](#sevtkpexecstate) -返回键盘执行指令的结果 +##### fEvtKpBindingInfo +- **主题**：/basestation/\${baseSN}/receive +- **功能描述**：返回键盘实时设置绑定信息的状态是否成功 +- **参数说明** + +|参数名|类型|限制|非空|说明| +|---|---|---|---|---| +|fun|string|-|是|指令名称| +|dataTag|string|-|否|数据包标识,可为空字符串| +|data|array|-|否|传送参数的对象数组| +|++keySn|string||是|需要设置绑定信息的键盘SN| +|++state|string||是|设置的绑定信息是否成功
0 - 成功
1 - 失败| +```json +{ + "fun": "fEvtKpBindingInfo", + "dataTag":"1", + "data": [ + { + "keySn": "1479824643", + "state": "0" + }, + { + "keySn": "1479824644", + "state": "1" + } + ] +} +``` +##### fEvtClearKpBindingInfo +- **主题**：/basestation/\${baseSN}/receive +- **功能描述**：返回清空绑定信息的指令状态是否成功 +- **参数说明** +|参数名|类型|限制|非空|说明| +|---|---|---|---|---| +|fun|string|-|是|指令名称| +|dataTag|string|-|否|数据包标识,可为空字符串| +|data|object|-|否|传送参数的对象| +|+state|string||是|设置的绑定信息是否成功
0 - 成功
1 - 失败| +```json +{ + "fun": "fEvtSetKpBindingInfo", + "dataTag":"1", + "data": { + "state": "0" + } +} +``` ## 签到 ### 随时签到 #### 方法 @@ -1767,9 +1811,6 @@ ##### [sEvtStateCode](#sevtstatecode) 发送指令后返回接收状态 -##### [sEvtKpExecState](#sevtkpexecstate) -返回键盘执行指令的结果 - ##### fEvtKpSignIn - **主题**：/basestation/\${baseSN}/receive - **功能描述**：返回键盘提交签到信息 @@ -1800,6 +1841,28 @@ ] } ``` +##### fEvtKpLoginAllowed +- **主题**：/basestation/\${baseSN}/receive +- **功能描述**：返回键盘授权状态 +- **参数说明** + +|参数名|类型|限制|非空|说明| +|---|---|---|---|---| +|fun|string|-|是|指令名称| +|dataTag|string|-|否|数据包标识,可为空字符串| +|data|object|-|是|传送参数的对象| +|+keySn|string||是|键盘SN| +|+state|string||是|0-执行成功
1-执行失败| +```json +{ + "fun": "fEvtKpLoginAllowed", + "dataTag":"1", + "data": { + "keySn":"1479824643", + "state":1 + } +} +``` ## 按键反馈 ### 判断题 #### 方法 @@ -2140,7 +2203,7 @@ |dataTag|string|-|否|数据包标识,可为空字符串| |data|object|-|是|传送参数的对象| |+keySns|array||是|指定的键盘SN数组，可空表示全部在线键盘| -|+examNo|int||是|1-9999| +|+examNo|int||是|0-9999
=0，新的测验
>0时,与上次启动卷号一致继续测验，不一致进入新的测验| |+mode|int||是|显示模式
0-不显示开头
1-显示“Q”开头
2-显示“题”开头| |+questions|array||是|题目详情| |++symbol | string||是 | 题号前缀,可为空 | @@ -2344,5 +2407,25 @@ }] } ``` -##### [sEvtKpExecState](#sevtkpexecstate) -返回键盘执行指令的结果 \ No newline at end of file +##### fEvtKpAllowEdited +- **主题**：/basestation/\${baseSN}/receive +- **功能描述**：返回允许键盘修改答案状态 +- **参数说明** + +|参数名|类型|限制|非空|说明| +|---|---|---|---|---| +|fun|string|-|是|指令名称| +|dataTag|string|-|否|数据包标识,可为空字符串| +|data|object|-|是|传送参数的对象| +|+keySn|string||是|键盘SN| +|+state|int||是|0-成功
1-失败| +```json +{ + "fun": "fEvtKpAllowEdited", + "dataTag":"1", + "data": { + "keySn": "1234567890", + "state":0 + } +} +``` \ No newline at end of file -- libgit2 0.21.4