From b7c3fd16e00e45b1d568b36ceaf08378b862bec5 Mon Sep 17 00:00:00 2001 From: DMchen Date: Wed, 3 Jan 2024 15:15:00 +0800 Subject: [PATCH] 1.SDK应用部分，增加了支持基站SN模式接口。 --- WSCmdApp Protocol Interface Description_V5.1.3.docx | Bin 326959 -> 0 bytes 通讯协议-SDK应用部分.md | 270 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++------------------------------------------------------ 通讯协议-SDK应用部分[内部].md | 314 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++----------------------------------------------------------- 3 files changed, 471 insertions(+), 113 deletions(-) diff --git a/WSCmdApp Protocol Interface Description_V5.1.3.docx b/WSCmdApp Protocol Interface Description_V5.1.3.docx index 6b4fdfe..acfcb26 100644 Binary files a/WSCmdApp Protocol Interface Description_V5.1.3.docx and b/WSCmdApp Protocol Interface Description_V5.1.3.docx differ diff --git a/通讯协议-SDK应用部分.md b/通讯协议-SDK应用部分.md index 42acb16..de2d6e1 100644 --- a/通讯协议-SDK应用部分.md +++ b/通讯协议-SDK应用部分.md @@ -8,7 +8,7 @@ WSCmdApp协议接口说明
-Ver5.1.3 +Ver5.1.5


@@ -46,6 +46,7 @@ Ver5.1.3 |5.1.1| 2023年10月09日|陈定敏|1. 初始版| |5.1.2| 2023年11月07日|陈定敏|1. 增加配对模式设置接口| |5.1.3| 2023年11月15日|陈定敏|1. 更新语音题接口参数| +|5.1.5| 2023年12月28日|陈定敏|1. 增加Json指令支持基站id和基站SN两种模式|
@@ -77,7 +78,8 @@ heartBeatOnOf:心跳判定开关，此参数配合协议文档中的“心跳” 当参数配置为1: WSCmdApp会配合的回复对应参数，进入心跳检测程序。 heartbeat: 心跳间隔时长 范围：10-60 单位秒 当heartBeatOnOff配置为1，并且WebSocket运行模式为客户端时，进入心跳检测程序后，在单位时间没有收到心跳指令，WebSocket客户端会重启，重新连接服务器。 - +language：切换WSCmdApp使用的语言，0:简体中文 1:英文 +jsonBase：切换Json指令中使用基站ID还是基站SN， 0:基站ID生效，基站SN无效，1:基站SN生效，基站ID无效。 # 设计目的 @@ -91,12 +93,15 @@ heartbeat: 心跳间隔时长 范围：10-60 单位秒 应用程序和WSCmdApp之间采用Json数据通信，通信的基本格式如下： +关于baseId和baseSnList的使用说明：二者使用切换可以在config.ini 文件的关键字jsonBase中切换，0:基站ID生效[baseId的值有效]，基站SN无效，1:基站SN生效[baseSnList的值有效]，基站ID无效，baseSnList是字符串数字类型,可以传递一个基站SN也可以传递多个基站SN。 + 下发：应用程序 -> WSCmdApp ```json { fun: "" // 功能定义 baseId: 1 // 基站id,数字类型 + baseSnList:["2023031402"] //基站SN列表，字符串数组 params： {} //参数对象/数组 packetTag: "" //数据包标签字符串 } @@ -104,7 +109,8 @@ heartbeat: 心跳间隔时长 范围：10-60 单位秒 fun 为功能对应的名称 如："readBaseStationID" 读取基站的id,"startChoices" //开始选择题, "stopChoices" //停止选择题. -baseId：基站ID，用来区分基站标志,0代表所有基站，1代表1号基站。 +baseId：基站ID，用来区分基站标志,0代表所有基站，1代表1号基站。[此参数请和config.ini 文件的关键字jsonBase的值配合使用] +baseSnList：基站SN列表，用来区分基站标志。[此参数请和config.ini 文件的关键字jsonBase的值配合使用] params：参数，功能相对于的参数，可以是数组或字段。 packerTag:这个是扩展字段，内容需要应用程序管理，功能相应的反馈指令packerTag位置会反馈相同字符串，方便应用程序跟踪记录。 @@ -114,6 +120,7 @@ packerTag:这个是扩展字段，内容需要应用程序管理，功能相应 { fun: "" //功能定义 baseId: 1 //基站id,数字类型 + baseSn:"2023031402" //基站SN infos: {} //信息对象/数组 packetTag: "" // 数据包标签字符串。 } @@ -121,6 +128,7 @@ packerTag:这个是扩展字段，内容需要应用程序管理，功能相应 fun： 功能对应的名称,如:"BaseStationID"读取基站id, " answerChoices" //选择题键盘反馈值. baseId: 基站ID，用来区分基站标志；0特殊代表所有基站，1代表1号基站。 +baseSn: 基站SN，用来区分基站标志。 infos: WSCmdApp反馈给APP层的数据。具体详见具体功能定义。 packetTag:这个是扩展字段，内容需要应用程序管理，反馈接收到的字符串。 @@ -156,12 +164,15 @@ WSCmdApp端被设置为Websocket 客户端模式时， WSCmdApp将自动根据 应用程序和WSCmdApp之间采用Json数据通信，通信的基本格式如下： + + 下发：应用程序 ->WSCmdApp ```json { fun: "" // 功能定义 baseId: 1 // 基站id,数字类型 + baseSnList:["2023031402"] //基站SN列表，字符串数组 params： {} //参数对象/数组 packetTag: "" //数据包标签字符串 } @@ -169,7 +180,9 @@ WSCmdApp端被设置为Websocket 客户端模式时， WSCmdApp将自动根据 fun：为功能定义，下发命令，要下发的命令函数 -baseId：基站ID，数字类型，如果不指定具体基站ID，可以传0或者不传该Key值。如果要指定多个基站ID，则需要多次下发该命令，切换不同的基站ID进行发送。 +baseId：基站ID，数字类型，如果不指定具体基站ID，可以传0或者不传该Key值。如果要指定多个基站ID，则需要多次下发该命令，切换不同的基站ID进行发送。[此参数请和config.ini 文件的关键字jsonBase的值配合使用] + +baseSnList：基站SN列表，字符串数组。可以传递一个基站SN也可以传递多个基站SN。[此参数请和config.ini 文件的关键字jsonBase的值配合使用] params：参数，可以为对象或者数组，用于伴随命令下发的数据附属包，详见具体功能定义。 @@ -182,6 +195,7 @@ packerTag: { fun: "" //功能定义 baseId: 1 //基站id,数字类型 + baseSn:"2023031402" //基站SN infos: {} //信息对象/数组 packetTag: "" // 数据包标签字符串，用于区别当前指令与其他指令。WSCmdApp发送给应用程序的用自增数字标记。WSCmdApp回复应用程序的，直接回填WSCmdApp收到的标签。 } @@ -189,6 +203,7 @@ packerTag: fun：同下发描述. baseId:同下发描述. +baseSn：同下发描述. infos:WSCmdApp反馈给应用程序层的数据。具体详见具体功能定义。 packetTag:数据标签字符串，反馈功能函数的状态为应用程序附带的数据包，如果WSCmdApp主动发送数据，是一组自增数据。 @@ -241,15 +256,12 @@ packetTag:"1"//数据包标签 读取在线基站状态 发送： fun: "readConnectBase" //连接基站 -baseId:0 //基站ID -params：{} //为空 packetTag:"1" // 指令样例： ```json { "fun": "readConnectBase", - "baseId": 0, "packetTag": "1" } ``` @@ -258,6 +270,7 @@ packetTag:"1" // fun: "connectBase" //连接基站 baseId:1 //基站ID +baseSn:"2023031402" //基站SN infos: {"state":"OK"} //OK连接成功 packetTag:"1" //收到的packetTag @@ -266,6 +279,7 @@ packetTag:"1" //收到的packetTag { "fun": "connectBase", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -279,6 +293,7 @@ packetTag:"1" //收到的packetTag fun: "connectBase" //连接基站 baseId:1 //基站ID +baseSn:"2023031402" //基站SN infos: {"state":"OK"} //OK连接成功 packetTag:"1" //收到的packetTag @@ -287,6 +302,7 @@ packetTag:"1" //收到的packetTag { "fun": "connectBase", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -310,6 +326,7 @@ packetTag:"1" { "fun": "disconnectBase", "baseId": 1, + "baseSn":"2023031402", "packetTag": "1" } ``` @@ -329,6 +346,7 @@ params:{} //无该值 { "fun": "resetBase", "baseId": 1, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -401,6 +419,7 @@ infos:{}//数组对象 {     "fun": "startBindKeypad", "baseId": 1, + "baseSnList":["2023031402"], "infos": [{             "keySn": "1837454011", "state": "OK"         @@ -425,24 +444,11 @@ params:{} //为空 {     "fun": "startBindKeypad", "baseId": 1, + "baseSnList":["2023031402"], "packetTag": "1" } ``` -停止作答 - -指令样例： - -```json -{        - "keySnList": [{             - "keySn": "1837454011"         - }, {             - "keySn": "1837454012"         - }] -} -``` - 键盘的接收状态返回 fun: "stopXXKeypad" //停止XX作答键盘(XX是停止作答对应具体名称) @@ -455,6 +461,7 @@ infos:{}//数组对象 { "fun": "stopBindKeypad", "baseId": 1, + "baseSn":"2023031402", "infos": [{ "keySn": "1837454011", "state": "OK" @@ -476,6 +483,7 @@ params：{} //为空 { "fun": "stopBindKeypad", "baseId": 1, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -508,6 +516,7 @@ params：{} { "fun": "startBind", "baseId": 0, + "baseSnList":["2023031402"], "params": { "bindMode": "1", "lessMode": "0", @@ -541,6 +550,7 @@ infos:{} { "fun": "answerBind", "baseId": 1, + "baseSn":"2023031402", "infos": { "time": "2.42", "keySn": "1479824643", @@ -563,6 +573,7 @@ params:{} //默认空 { "fun": "stopBind", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -620,6 +631,7 @@ params：{} { "fun": "startChoices", "baseId": 0, + "baseSnList":["2023031402"], "params": { "optionsMode": "1", "secrecyMode": "0", @@ -644,6 +656,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "startChoices", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -662,9 +675,10 @@ infos: {} |Json字段|字段含义|赋值及含义| |---|---|---| -| time|答题时间|单位秒| +|time|答题时间|单位秒| |keySn|键盘Sn|| |keyValue|键值|键盘提交的值| +|keyBattery|电池状态|S6键盘电压值（V）
T2键盘电量值（%）| 指令样例： @@ -672,6 +686,7 @@ infos: {} { "fun": "answerChoices", "baseId": 1, + "baseSn":"2023031402", "infos": { "time": "2.42", "keySn": "1479824643", @@ -693,6 +708,7 @@ params:{} //默认空 { "fun": "stopChoices", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -709,6 +725,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "stopChoices", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -747,6 +764,7 @@ params：{} { "fun": "startTrueFalse", "baseId": 0, + "baseSnList":["2023031402"], "params": { "optionsMode": "1", "secrecyMode": "0", @@ -768,6 +786,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "startTrueFalse", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -796,6 +815,7 @@ infos: {} { "fun": "answerTrueFalse", "baseId": 1, + "baseSn":"2023031402", "infos": { "time": "2.42", "keySn": "1479824643", @@ -818,6 +838,7 @@ params:{} //默认空 { "fun": "stopTrueFalse", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -834,6 +855,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "stopTrueFalse", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -874,6 +896,7 @@ params：{} { "fun": "startMulQuestions", "baseId": 0, + "baseSnList":["2023031402"], "params": { "questionType": "0", "secrecyMode": "0", @@ -898,6 +921,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "startMulQuestions", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -925,6 +949,7 @@ infos: {} { "fun": "answerMulQuestions", "baseId": 1, + "baseSn":"2023031402", "infos": { "time": "2.42", "keySn": "1479824643", @@ -947,6 +972,7 @@ params:{} //默认空 { "fun": "stopMulQuestions", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -963,6 +989,7 @@ infos:{"state":"OK"} //返回状态,成功为OK { "fun": "stopMulQuestions", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -1003,6 +1030,7 @@ params：{} { "fun": "startVoice", "baseId": 0, + "baseSnList":["2023031402"], "params": { "recordingMode": "0", "submitTimes": "0", @@ -1027,6 +1055,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "startVoice", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -1057,6 +1086,7 @@ infos: {} { "fun": "answerVoiceFile", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1479749926", "filePath": "D:\voice\3_1479749926_196_2023-08-21 16-09-02 530.Mp3" @@ -1092,6 +1122,7 @@ infos: {} { "fun": "answerVoiceStream", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1479824643", "voiceId": "1", @@ -1124,6 +1155,7 @@ params:{} //默认空， { "fun": "stopVoice", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -1140,6 +1172,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "stopVoice", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -1175,6 +1208,7 @@ infos:{} // { "fun": "voicePacketLossInfo", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1837454011", "voiceId": "1", @@ -1214,6 +1248,7 @@ params：{} { "fun": "startRushAnswer", "baseId": 0, + "baseSnList":["2023031402"], "params": { "rushAnswerMode": "0", "modifyMode": "1" @@ -1234,6 +1269,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "startRushAnswer", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -1261,6 +1297,7 @@ infos: {} { "fun": "answerRushAnswer", "baseId": 1, + "baseSn":"2023031402", "infos": { "time": "1.42", "keySn": "1479824643", @@ -1282,6 +1319,7 @@ params:{} //默认空 { "fun": "stopRushAnswer", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -1298,6 +1336,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "stopRushAnswer", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -1339,6 +1378,7 @@ params：{} { "fun": "startNumber", "baseId": 0, + "baseSnList":["2023031402"], "params": { "secrecyMode": "0", "modifyMode": "1", @@ -1363,6 +1403,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "startNumber", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -1391,6 +1432,7 @@ infos: {} { "fun": "answerNumber", "baseId": 1, + "baseSn":"2023031402", "infos": { "time": "2.42", "keySn": "1479824643", @@ -1413,6 +1455,7 @@ params:{} //默认空 { "fun": "stopNumber", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -1429,6 +1472,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "stopNumber", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -1477,6 +1521,7 @@ params：{} { "fun": "startKeyPadMultipleQuestionsTest", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 0, @@ -1505,6 +1550,7 @@ params：{} { "fun": "startKeyPadMultipleQuestionsTest", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 0, @@ -1537,6 +1583,7 @@ params：{} { "fun": "startKeyPadMultipleQuestionsTest", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 0, @@ -1573,6 +1620,7 @@ params：{} { "fun": "startKeyPadMultipleQuestionsTest", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 1, @@ -1600,6 +1648,7 @@ params：{} { "fun": "startKeyPadMultipleQuestionsTest", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 2, @@ -1633,6 +1682,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "keyPadMultipleQuestionsTest", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -1669,6 +1719,7 @@ params：{} { "fun": "startKeyPadMultipleQuestionsCourse", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 0, @@ -1715,6 +1766,7 @@ params：{} { "fun": "startKeyPadMultipleQuestionsCourse", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 0, @@ -1747,6 +1799,7 @@ params：{} { "fun": "startKeyPadMultipleQuestionsCourse", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 1, @@ -1779,6 +1832,7 @@ params：{} { "fun": "startKeyPadMultipleQuestionsCourse", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 2, @@ -1817,6 +1871,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "keyPadMultipleQuestionsCourse", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -1847,6 +1902,7 @@ params：{} { "fun": "startKeyPadMultipleQuestionsSubjective", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "questions": [{ @@ -1882,6 +1938,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "KeyPadMultipleQuestionsSubjective", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -1915,6 +1972,7 @@ infos: {} { "fun": "answerKeyPadMultipleQuestions", "baseId": 1, + "baseSn":"2023031402", "infos": { "time": "5.42", "keySn": "1479824643", @@ -1939,8 +1997,8 @@ params:{} //默认空 ```json { "fun": "stopKeyPadMultipleQuestions", - "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -1959,6 +2017,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "stopKeyPadMultipleQuestions", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -1981,8 +2040,8 @@ params:{} //默认空 ```json { "fun": "pauseKeyPadMultipleQuestions", - "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -2002,6 +2061,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "pauseKeyPadMultipleQuestions", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -2041,6 +2101,7 @@ params：{} { "fun": "continueKeyPadMultipleQuestionsTest", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 0, @@ -2068,6 +2129,7 @@ params：{} { "fun": "continueKeyPadMultipleQuestionsTest", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 0, @@ -2099,6 +2161,7 @@ params：{} { "fun": "continueKeyPadMultipleQuestionsTest", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 0, @@ -2134,6 +2197,7 @@ params：{} { "fun": "continueKeyPadMultipleQuestionsTest", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 1, @@ -2161,6 +2225,7 @@ params：{} { "fun": "continueKeyPadMultipleQuestionsTest", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 2, @@ -2194,6 +2259,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "keyPadMultipleQuestionsTest", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -2230,6 +2296,7 @@ params：{} { "fun": "continueKeyPadMultipleQuestionsCourse", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 0, @@ -2278,6 +2345,7 @@ params：{} { "fun": "continueKeyPadMultipleQuestionsCourse", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 0, @@ -2310,6 +2378,7 @@ params：{} { "fun": "continueKeyPadMultipleQuestionsCourse", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 1, @@ -2342,6 +2411,7 @@ params：{} { "fun": "continueKeyPadMultipleQuestionsCourse", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 2, @@ -2380,6 +2450,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "keyPadMultipleQuestionsCourse", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -2410,6 +2481,7 @@ params：{} { "fun": "continueKeyPadMultipleQuestionsSubjective", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "questions": [{ @@ -2445,6 +2517,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "keyPadMultipleQuestionsSubjective", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -2475,6 +2548,7 @@ params:{} // { "fun": "copyKeyPadMultipleQuestions", "baseId": 1, + "baseSnList":["2023031402"], "params": { "keySn": "0007831203", "questions": [{ @@ -2503,6 +2577,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "copyKeyPadMultipleQuestions", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -2531,6 +2606,7 @@ params:{} //默认空 { "fun": "okKeyPadMultipleQuestions", "baseId": 0, + "baseSnList":["2023031402"], "params": [{ "id": "1", "questionType": "1", @@ -2556,6 +2632,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "okKeyPadMultipleQuestions", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -2593,6 +2670,7 @@ params：{} { "fun": "startTextAnswer", "baseId": 0, + "baseSnList":["2023031402"], "params": { "optionsMode": "1", "modifyMode": "1", @@ -2614,6 +2692,7 @@ infos:{"state":"OK"} //返回状态,成功为OK { "fun": "startTextAnswer", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -2641,6 +2720,7 @@ infos: {} { "fun": "answerTextAnswer", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1479824643", "keyValue": "abcdef" @@ -2660,6 +2740,8 @@ params:{} //默认空 ```json { "fun": "stopTextAnswer", + "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -2675,6 +2757,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "stopTextAnswer", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -2704,6 +2787,7 @@ params：{} { "fun": "startFreeQuestion", "baseId": 0, + "baseSnList":["2023031402"], "params": {}, "packetTag": "1" } @@ -2721,6 +2805,7 @@ infos:{"state":"OK"} //返回状态,成功为OK { "fun": "startFreeQuestion", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -2751,6 +2836,7 @@ infos: {} { "fun": "answerChoices", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1479824643", "keyValue": "ABC" @@ -2775,6 +2861,7 @@ infos: {} { "fun": "answerTrueFalse", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1479824643", "keyValue": "1" @@ -2798,6 +2885,7 @@ infos: {} { "fun": "answerNumber", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1479824643", "keyValue": "99.99" @@ -2819,6 +2907,8 @@ params:{} //默认空 ```json { "fun": "stopFreeQuestion", + "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -2834,6 +2924,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "stopFreeQuestion", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -2875,6 +2966,7 @@ params:{}// { "fun": "writeNFCInfo", "baseId": 1, + "baseSnList":["2023031402"], "params": { "userName": "张三", "matchCode": "22120007" @@ -2894,6 +2986,7 @@ infos:{"value":"OK"}//返回状态,成功为OK { "fun": "writeNFCInfo", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "OK" }, @@ -2926,6 +3019,7 @@ infos:{} { "fun": "NFCInfo", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1479824643", "state": "4", @@ -2958,6 +3052,7 @@ params:{}// { "fun": "writeNFCEmpty", "baseId": 1, + "baseSnList":["2023031402"], "params": {}, "packetTag": "1" } @@ -2973,6 +3068,7 @@ infos:{"value":"OK"}//返回状态,成功为OK { "fun": "writeNFCEmpty", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "OK" }, @@ -3008,6 +3104,7 @@ params：{}//可不填 { "fun": "readBaseStationID", "baseId": 2, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -3026,6 +3123,7 @@ infos:{"value":"2"}//返回基站ID { "fun": "baseStationID", "baseId": 2, + "baseSn":"2023031402", "infos": { "pathAdd": "12345", "value": "2" @@ -3057,6 +3155,7 @@ params：{}//可不填 { "fun": "readBaseStationChannel", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -3080,6 +3179,7 @@ params：{"value":"1"}//1~12 （频点） { "fun": "writeBaseStationChannel", "baseId": 1, + "baseSnList":["2023031402"], "params": { "value": "3", "values": ["3", "6", "9", "12"] @@ -3102,6 +3202,7 @@ infos:{"value":"3"}//返回基站频点值 { "fun": "baseStationChannel", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "3", "values": ["3", "6", "9", "12"] @@ -3134,6 +3235,7 @@ params：{}//可不填 { "fun": "readKeyboardLoginMenu", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -3152,6 +3254,7 @@ params：{"value":"1"}//0~1 （0不允许登录；1允许登录） { "fun": "writeKeyboardLoginMenu", "baseId": 1, + "baseSnList":["2023031402"], "params": { "value": "1" }, @@ -3174,6 +3277,7 @@ infos:{"value":"1"}//返回键盘登录菜单显示值 { "fun": "baseStationKeyboardLoginMenu", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "1" }, @@ -3207,6 +3311,7 @@ params：{}//可不填 { "fun": "readBaseStationModel", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -3226,6 +3331,7 @@ infos:{"value":"218"}//返回基站型号 { "fun": "baseStationModel", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "218" }, @@ -3267,6 +3373,7 @@ params：{}//可不填 { "fun": "readBaseStationSVersion", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -3286,6 +3393,7 @@ infos:{"value":"V2.0.2"}//返回基站软件版本 { "fun": "baseStationSVersion", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "V2.0.2" }, @@ -3318,6 +3426,7 @@ params：{}//可不填 { "fun": "readBaseStationSN", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -3337,6 +3446,7 @@ infos:{"value":"FFFFFFFFFF"}//返回基站序列号 { "fun": "baseStationSN", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "FFFFFFFFFF" }, @@ -3369,6 +3479,7 @@ params：{}//可不填 { "fun": "readBaseStationTitle", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -3388,6 +3499,7 @@ params：{"value":" A2021"}//基站名称，最长12字节 { "fun": "writeBaseStationTitle", "baseId": 1, + "baseSnList":["2023031402"], "params": { "value": "A2021" }, @@ -3410,6 +3522,7 @@ infos:{"value":"A2021"}//返回基站名称 { "fun": "baseStationTitle", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "A2021" }, @@ -3437,6 +3550,7 @@ params：{}//可不填 { "fun": "readBaseStationPairMode", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -3460,6 +3574,7 @@ params：{"value":"1"}// { "fun": "writeBaseStationPairMode", "baseId": 1, + "baseSnList":["2023031402"], "params": { "value": "1" }, @@ -3478,6 +3593,7 @@ infos:{"value":"1"}//返回基站配对模式值 { "fun": "baseStationPairMode", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "1" }, @@ -3509,6 +3625,7 @@ params：{}//可不填 { "fun": "readBaseStationMatchCode", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -3528,6 +3645,7 @@ infos:{"value":"21072333"}//返回基站配对码 { "fun": "baseStationMatchCode", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "21072333" }, @@ -3560,6 +3678,7 @@ packetTag:"0"//数据包标签 { "fun": "baseStationChannelInterference", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "5" }, @@ -3592,6 +3711,7 @@ params：{}//可不填 { "fun": "readBaseStationCapacity", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -3608,9 +3728,10 @@ infos:{"keypadNumber":"60","lock":"1"}//返回基站键盘容量值 指令样例： ```json -{ - "baseId": 2, +{ "fun": "baseStationCapacity", + "baseId": 2, + "baseSn":"2023031402", "infos": { "keypadNumber": "60", "lock": "1" @@ -3642,6 +3763,7 @@ params：{} { "fun": "startQuickMatch", "baseId": 1, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -3659,6 +3781,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "startQuickMatch", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -3680,6 +3803,7 @@ params:{} //默认空 { "fun": "stopQuickMatch", "baseId": 1, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -3697,6 +3821,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "stopQuickMatch", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -3729,6 +3854,7 @@ params：{}//可不填 { "fun": "readKeyboardLoginPW", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -3747,6 +3873,7 @@ params：{"value":"0"}//0~9999 （0不用核对） { "fun": "writeKeyboardLoginPW", "baseId": 1, + "baseSnList":["2023031402"], "params": { "value": "0" }, @@ -3769,6 +3896,7 @@ infos:{"value":"1"}//返回键盘登录密码值 { "fun": "baseStationKeyboardLoginPW", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "0" }, @@ -3800,6 +3928,7 @@ params：{}//可不填 { "fun": "readBaseStationNameHidden", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -3822,6 +3951,7 @@ params：{"value":"0"}//0~1 （0隐藏，1不隐藏） { "fun": "writeBaseStationNameHidden", "baseId": 1, + "baseSnList":["2023031402"], "params": { "value": "0" }, @@ -3844,6 +3974,7 @@ infos:{"value":"1"}//返回基站名称隐藏值 （0隐藏，1不隐藏） { "fun": "baseStationNameHidden", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "0" }, @@ -3874,6 +4005,7 @@ params：{}//可不填 { "fun": "readBaseStationTcpIp", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -3893,6 +4025,7 @@ params： { "fun": "writeBaseStationTcpIp", "baseId": 1, + "baseSnList":["2023031402"], "params": { "mac": "FF:FF:FF:FF:FF:FF", "ip": "192.168.10.10", @@ -3919,6 +4052,7 @@ infos:{"value":"1"}//返回基站TcpIp { "fun": "baseStationTcpIp", "baseId": 1, + "baseSn":"2023031402", "infos": { "ip": "192.168.10.10", "mac": "FF:FF:FF:FF:FF:FF", @@ -3951,6 +4085,7 @@ baseId: 0// { "fun": "readWhiteList", "baseId": 0, + "baseSnList":["2023031402"], "params": {}, "packetTag": "1" } @@ -3973,6 +4108,7 @@ infos:{}// { "fun": "whiteList", "baseId": 1, + "baseSn":"2023031402", "infos": [{ "keySn": "2111120140", "state": "0" @@ -4011,6 +4147,7 @@ keySnList：[]//键盘SN数组最多200键盘SN { "fun": "writeWhiteList", "baseId": 0, + "baseSnList":["2023031402"], "keySnList": [{ "keySn": "2111120140" }, @@ -4044,6 +4181,7 @@ infos:{}// { "fun": "whiteList", "baseId": 1, + "baseSn":"2023031402", "infos": [{ "keySn": "2111120140", "state": "OK" @@ -4087,6 +4225,7 @@ params:{} //数组对象，指定键盘需填 { "fun": "lockKeypad", "baseId": 1, + "baseSnList":["2023031402"], "keySnList": [{ "keySn": "2111120140" }, @@ -4107,6 +4246,7 @@ params:{} //数组对象，指定键盘需填 { "fun": "lockKeypad", "baseId": 1, + "baseSn":"2023031402", "infos": [{ "keySn": "1837454011", "state": "OK" @@ -4144,6 +4284,7 @@ params:{} //数组对象，指定键盘需填 { "fun": "unlockKeypad", "baseId": 1, + "baseSnList":["2023031402"], "keySnList": [{ "keySn": "2111120140" }, @@ -4164,6 +4305,7 @@ params:{} //数组对象，指定键盘需填 { "fun": "unlockKeypad", "baseId": 1, + "baseSn":"2023031402", "infos": [{ "keySn": "2111120140", "state": "OK" @@ -4198,6 +4340,7 @@ keySnList:[ "keySn":"2111120140"] //列表不能为空 { "fun": "addWhiteList", "baseId": 1, + "baseSnList":["2023031402"], "keySnList": [{ "keySn": "2111120140" }], @@ -4219,6 +4362,7 @@ infos:{}// { "fun": "whiteList", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1837454012", "state": "OK" @@ -4246,6 +4390,7 @@ keySnList:[ "keySn":"2111120140"] //列表不能为空 { "fun": "delWhiteList", "baseId": 0, + "baseSnList":["2023031402"], "keySnList": [{ "keySn": "2111120140" }], @@ -4267,6 +4412,7 @@ infos:{}// { "fun": "delWhiteList", "baseId": 1, + "baseSn":"2023031402", "packetTag": "1", "infos": { "keySn": "1837454012", @@ -4294,6 +4440,7 @@ params:{} //无 { "fun": "clearWhiteList", "baseId": 1, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -4310,6 +4457,7 @@ infos:{}// { "fun": "clearWhiteList", "baseId": 1, + "baseSn":"2023031402", "packetTag": "1", "infos": { "state": "OK" @@ -4340,6 +4488,7 @@ params：{"value":0}// { "fun": "readKeypadAutoPowerOffLevel", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -4356,6 +4505,7 @@ params：{"value":"0"}// { "fun": "writeKeypadAutoPowerOffLevel", "baseId": 1, + "baseSnList":["2023031402"], "params": { "value": "0" }, @@ -4374,6 +4524,7 @@ infos:{"value":"0"}//返回键盘关机时间等级 { "fun": "keypadAutoPowerOffLevel", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "0" }, @@ -4398,6 +4549,7 @@ params：{}//可不填 { "fun": "readBaseStationBaseConfig", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -4421,6 +4573,7 @@ params：{}// { "fun": "writeBaseStationBaseConfig", "baseId": 1, + "baseSnList":["2023031402"], "params": { "bootVibraton": "1", "voteVibraton": "1", @@ -4442,6 +4595,7 @@ infos:{ }//返回基站 { "fun": "baseStationBaseConfig", "baseId": 1, + "baseSn":"2023031402", "infos": { "bootVibraton": "1", "voteVibraton": "1", @@ -4494,6 +4648,7 @@ params：{} // { "fun": "writeKeypadDevice", "baseId": 1, + "baseSnList":["2023031402"], "params": { "ledTimes": "3", "ledOnTime": "1", @@ -4524,6 +4679,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "writeKeypadDevice", "baseId": 0, + "baseSn":"2023031402", "infos": { "keySn": "0000000000", "state": "OK" @@ -4537,6 +4693,8 @@ infos:{"state":"OK"}//返回状态,成功为OK ```json { "fun": "writeKeypadDevice", + "baseId": 0, + "baseSnList":["2023031402"], "keySnList": [{ "keySn": "0007899478" }], @@ -4567,9 +4725,10 @@ infos:{}//数组对象,同发送的 指令样例： ```json -{ - "baseId": 3, +{ "fun": "writeKeypadDevice", + "baseId": 3, + "baseSn":"2023031402", "infos": { "keySn": "0007899478", "state": "OK" @@ -4598,6 +4757,7 @@ params：{}//读取时不需要 { "fun": "readKeypadFeedbackMode", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -4620,6 +4780,7 @@ params：{"mode":"1", "value":"4"}// { "fun": "writeKeypadFeedbackMode", "baseId": 0, + "baseSnList":["2023031402"], "params": { "mode": "1", "value": "4" @@ -4645,6 +4806,7 @@ infos:{ "mode":"1", "value":"4"}//返回键盘反馈模式参数值 { "fun": "keypadFeedbackMode", "baseId": 1, + "baseSn":"2023031402", "infos": { "mode": "1", "value": "4" @@ -4673,8 +4835,9 @@ infos:{ "keySn":"2307269906", "keyValue":"A"}//返回键盘反馈模式参数值 ```json { - "baseId": 1, "fun": "immediateFeedback", + "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "2307269906", "keyValue": "A" @@ -4708,6 +4871,7 @@ infos:{ "keySn":"1479824643"}//返回键盘反馈模式参数值 { "fun": "keyboardOnlineOne", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1479824643" }, @@ -4740,6 +4904,7 @@ infos:{ "hModel": "67","keySn":"1479824643","keyValue":"0","ver":"1.0.0","volt": { "fun": "KeyboardHeartbeat", "baseId": 1, + "baseSn":"2023031402", "infos": { "hModel": "67", "keySn": "1479824643", @@ -4772,6 +4937,7 @@ params：{}// { "fun": "remoteKeyShutdown", "baseId": 1, + "baseSnList":["2023031402"], "params": [{ "keySn": "1837454011" }], @@ -4790,6 +4956,7 @@ infos:{"keySn":"1837454011","state":"OK"}//遥控键盘关机 { "fun": "remoteKeyShutdown", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1837454011", "state": "OK" @@ -4825,6 +4992,7 @@ params：{} // 数组对象,对象中的默认值为空字符串 { "fun": "writeKeyMessage", "baseId": 0, + "baseSnList":["2023031402"], "params": { "txt": "最新消息" }, @@ -4843,6 +5011,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "writeKeyMessage", "baseId": 0, + "baseSn":"2023031402", "infos": { "keySn": "0000000000", "state": "OK" @@ -4856,6 +5025,8 @@ infos:{"state":"OK"}//返回状态,成功为OK ```json { "fun": "writeKeyMessage", + "baseId": 0, + "baseSnList":["2023031402"], "keySnList": [{ "keySn": "0007899478" }], @@ -4875,9 +5046,10 @@ infos:{}//数组对象,同发送的 指令样例： ```json -{ - "baseId": 3, +{ "fun": "writeKeyMessage", + "baseId": 3, + "baseSn":"2023031402", "infos": { "keySn": "0007899478", "state": "OK" @@ -4915,6 +5087,7 @@ params:{} { "fun": "writeKeypadFreeTitle", "baseId": 1, + "baseSnList":["2023031402"], "params": { "title": "请认真听讲" }, @@ -4939,6 +5112,7 @@ infos:{}// { "fun": "writeKeypadFreeTitle", "baseId": 0, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -4960,7 +5134,7 @@ params：{}//数组对象,字段不填则保留上次值。 | **Json字段** | **字段含义** | **赋值及含义** | | --- | --- | --- | -| keySn| 键盘Sn| 空则为所有在线键盘，其他数组值无效| +| keySn| 键盘Sn| 不能为空| | scoreMode| 分数模式|1:清除
2:字符显示(默认值)
3:五角星显示
4:爱心显示[S6有效]| | scoreValue| 分数值|scoreMode == 1,此处无效.
scoreMode == 2,8个字符长度.
scoreMode == 3,0~6，2个分数表示1个五角星，最多3个.
scoreMode == 4,0~6，2个分数表示1个爱心，最多3个 [S6有效]| |tipText|提示文本| 最多8个汉字（16个字符）,键盘第二行显示| @@ -4973,6 +5147,7 @@ params：{}//数组对象,字段不填则保留上次值。 { "fun": "writeKeypadCustomInfo", "baseId": 1, + "baseSnList":["2023031402"], "params": [{ "keySn": "1479824643", "scoreMode": "2", @@ -5003,6 +5178,7 @@ infos:{}//数组对象 { "fun": "writeKeypadCustomInfo", "baseId": 0, + "baseSn":"2023031402", "infos": [{ "keySn": "1479824643", "state": "OK" @@ -5011,25 +5187,6 @@ infos:{}//数组对象 } ``` -所有键盘 - -fun: "writeKeypadCustomInfo" //写键盘的用户信息 -baseId:0 //接收到指令的基站ID -infos:{"state":"OK"}//返回状态,成功为OK - - -指令样例： - -```json -{ - "fun": "writeKeypadCustomInfo", - "baseId": 0, - "infos": { - "state": "OK" - }, - "packetTag": "1" -} -``` 支持设备说明 @@ -5050,7 +5207,7 @@ params：{}//数组对象,字段不填则保留上次值。 | **Json字段** | **字段含义** | **赋值及含义** | | --- | --- | --- | -|keySn|键盘SN|空则为所有在线键盘，其他数组值无效| +|keySn|键盘SN|不能为空| |userName|姓名|最多24个汉字（48个字符）,键盘左上角显示| 指令样例： @@ -5059,6 +5216,7 @@ params：{}//数组对象,字段不填则保留上次值。 { "fun": "writeKeypadUserName", "baseId": 1, + "baseSnList":["2023031402"], "params": [{ "keySn": "1479824643", "userName": "张三" @@ -5086,6 +5244,7 @@ infos:{}//数组对象 { "fun": "writeKeypadUserName", "baseId": 0, + "baseSn":"2023031402", "infos": { "keySn": "1479824643", "state": "OK" @@ -5107,6 +5266,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "writeKeypadUserName", "baseId": 0, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -5140,6 +5300,7 @@ params：{}//数组对象,字段不填则保留上次值。 { "fun": "writeOneKeypadUserName", "baseId": 0, + "baseSnList":["2023031402"], "params": [{ "keySn": "1479824643", "value": "张三" @@ -5166,6 +5327,7 @@ infos:{}//数组对象 { "fun": "oneKeypadUserName", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1479824643", "value": "张三" @@ -5204,6 +5366,7 @@ infos:{} //数组对象 { "fun": "keypadOnLine", "baseId": 0, + "baseSn":"2023031402", "infos": [{ "baseId": "1", "keySn": "1837454011", @@ -5228,7 +5391,7 @@ infos:{} //数组对象 ### 主动获取在线信息 -应用程序在需要时，也可主动获取所有在线键盘信息。 +应用程序在需要时，也可主动获取所有基站在线键盘信息。 注意：请不要在开启投票业务时使用。
@@ -5244,7 +5407,6 @@ params:{ ```json { "fun": "getKeypadOnLine", - "baseId": 0, "params": { "times": 2 }, diff --git a/通讯协议-SDK应用部分[内部].md b/通讯协议-SDK应用部分[内部].md index 9548f2b..b0bd028 100644 --- a/通讯协议-SDK应用部分[内部].md +++ b/通讯协议-SDK应用部分[内部].md @@ -8,7 +8,7 @@ WSCmdApp协议接口说明
-Ver5.1.3 +Ver5.1.5


@@ -46,6 +46,7 @@ Ver5.1.3 |5.1.1| 2023年10月09日|陈定敏|1. 初始版| |5.1.2| 2023年11月07日|陈定敏|1. 增加配对模式设置接口| |5.1.3| 2023年11月15日|陈定敏|1. 更新语音题接口参数| +|5.1.5| 2023年12月28日|陈定敏|1. 增加Json指令支持基站id和基站SN两种模式|
@@ -77,7 +78,8 @@ heartBeatOnOf:心跳判定开关，此参数配合协议文档中的“心跳” 当参数配置为1: WSCmdApp会配合的回复对应参数，进入心跳检测程序。 heartbeat: 心跳间隔时长 范围：10-60 单位秒 当heartBeatOnOff配置为1，并且WebSocket运行模式为客户端时，进入心跳检测程序后，在单位时间没有收到心跳指令，WebSocket客户端会重启，重新连接服务器。 - +language：切换WSCmdApp使用的语言，0:简体中文 1:英文 +jsonBase：切换Json指令中使用基站ID还是基站SN， 0:基站ID生效，基站SN无效，1:基站SN生效，基站ID无效。 # 设计目的 @@ -91,12 +93,15 @@ heartbeat: 心跳间隔时长 范围：10-60 单位秒 应用程序和WSCmdApp之间采用Json数据通信，通信的基本格式如下： +关于baseId和baseSnList的使用说明：二者使用切换可以在config.ini 文件的关键字jsonBase中切换，0:基站ID生效[baseId的值有效]，基站SN无效，1:基站SN生效[baseSnList的值有效]，基站ID无效，baseSnList是字符串数字类型,可以传递一个基站SN也可以传递多个基站SN。 + 下发：应用程序 -> WSCmdApp ```json { fun: "" // 功能定义 baseId: 1 // 基站id,数字类型 + baseSnList:["2023031402"] //基站SN列表，字符串数组 params： {} //参数对象/数组 packetTag: "" //数据包标签字符串 } @@ -104,7 +109,8 @@ heartbeat: 心跳间隔时长 范围：10-60 单位秒 fun 为功能对应的名称 如："readBaseStationID" 读取基站的id,"startChoices" //开始选择题, "stopChoices" //停止选择题. -baseId：基站ID，用来区分基站标志,0代表所有基站，1代表1号基站。 +baseId：基站ID，用来区分基站标志,0代表所有基站，1代表1号基站。[此参数请和config.ini 文件的关键字jsonBase的值配合使用] +baseSnList：基站SN列表，用来区分基站标志。[此参数请和config.ini 文件的关键字jsonBase的值配合使用] params：参数，功能相对于的参数，可以是数组或字段。 packerTag:这个是扩展字段，内容需要应用程序管理，功能相应的反馈指令packerTag位置会反馈相同字符串，方便应用程序跟踪记录。 @@ -114,6 +120,7 @@ packerTag:这个是扩展字段，内容需要应用程序管理，功能相应 { fun: "" //功能定义 baseId: 1 //基站id,数字类型 + baseSn:"2023031402" //基站SN infos: {} //信息对象/数组 packetTag: "" // 数据包标签字符串。 } @@ -121,6 +128,7 @@ packerTag:这个是扩展字段，内容需要应用程序管理，功能相应 fun： 功能对应的名称,如:"BaseStationID"读取基站id, " answerChoices" //选择题键盘反馈值. baseId: 基站ID，用来区分基站标志；0特殊代表所有基站，1代表1号基站。 +baseSn: 基站SN，用来区分基站标志。 infos: WSCmdApp反馈给APP层的数据。具体详见具体功能定义。 packetTag:这个是扩展字段，内容需要应用程序管理，反馈接收到的字符串。 @@ -156,12 +164,15 @@ WSCmdApp端被设置为Websocket 客户端模式时， WSCmdApp将自动根据 应用程序和WSCmdApp之间采用Json数据通信，通信的基本格式如下： + + 下发：应用程序 ->WSCmdApp ```json { fun: "" // 功能定义 baseId: 1 // 基站id,数字类型 + baseSnList:["2023031402"] //基站SN列表，字符串数组 params： {} //参数对象/数组 packetTag: "" //数据包标签字符串 } @@ -169,7 +180,9 @@ WSCmdApp端被设置为Websocket 客户端模式时， WSCmdApp将自动根据 fun：为功能定义，下发命令，要下发的命令函数 -baseId：基站ID，数字类型，如果不指定具体基站ID，可以传0或者不传该Key值。如果要指定多个基站ID，则需要多次下发该命令，切换不同的基站ID进行发送。 +baseId：基站ID，数字类型，如果不指定具体基站ID，可以传0或者不传该Key值。如果要指定多个基站ID，则需要多次下发该命令，切换不同的基站ID进行发送。[此参数请和config.ini 文件的关键字jsonBase的值配合使用] + +baseSnList：基站SN列表，字符串数组。可以传递一个基站SN也可以传递多个基站SN。[此参数请和config.ini 文件的关键字jsonBase的值配合使用] params：参数，可以为对象或者数组，用于伴随命令下发的数据附属包，详见具体功能定义。 @@ -182,6 +195,7 @@ packerTag: { fun: "" //功能定义 baseId: 1 //基站id,数字类型 + baseSn:"2023031402" //基站SN infos: {} //信息对象/数组 packetTag: "" // 数据包标签字符串，用于区别当前指令与其他指令。WSCmdApp发送给应用程序的用自增数字标记。WSCmdApp回复应用程序的，直接回填WSCmdApp收到的标签。 } @@ -189,6 +203,7 @@ packerTag: fun：同下发描述. baseId:同下发描述. +baseSn：同下发描述. infos:WSCmdApp反馈给应用程序层的数据。具体详见具体功能定义。 packetTag:数据标签字符串，反馈功能函数的状态为应用程序附带的数据包，如果WSCmdApp主动发送数据，是一组自增数据。 @@ -241,15 +256,12 @@ packetTag:"1"//数据包标签 读取在线基站状态 发送： fun: "readConnectBase" //连接基站 -baseId:0 //基站ID -params：{} //为空 packetTag:"1" // 指令样例： ```json { "fun": "readConnectBase", - "baseId": 0, "packetTag": "1" } ``` @@ -258,6 +270,7 @@ packetTag:"1" // fun: "connectBase" //连接基站 baseId:1 //基站ID +baseSn:"2023031402" //基站SN infos: {"state":"OK"} //OK连接成功 packetTag:"1" //收到的packetTag @@ -266,6 +279,7 @@ packetTag:"1" //收到的packetTag { "fun": "connectBase", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -279,6 +293,7 @@ packetTag:"1" //收到的packetTag fun: "connectBase" //连接基站 baseId:1 //基站ID +baseSn:"2023031402" //基站SN infos: {"state":"OK"} //OK连接成功 packetTag:"1" //收到的packetTag @@ -287,6 +302,7 @@ packetTag:"1" //收到的packetTag { "fun": "connectBase", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -310,6 +326,7 @@ packetTag:"1" { "fun": "disconnectBase", "baseId": 1, + "baseSn":"2023031402", "packetTag": "1" } ``` @@ -329,6 +346,7 @@ params:{} //无该值 { "fun": "resetBase", "baseId": 1, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -401,6 +419,7 @@ infos:{}//数组对象 {     "fun": "startBindKeypad", "baseId": 1, + "baseSnList":["2023031402"], "infos": [{             "keySn": "1837454011", "state": "OK"         @@ -425,24 +444,11 @@ params:{} //为空 {     "fun": "startBindKeypad", "baseId": 1, + "baseSnList":["2023031402"], "packetTag": "1" } ``` -停止作答 - -指令样例： - -```json -{        - "keySnList": [{             - "keySn": "1837454011"         - }, {             - "keySn": "1837454012"         - }] -} -``` - 键盘的接收状态返回 fun: "stopXXKeypad" //停止XX作答键盘(XX是停止作答对应具体名称) @@ -455,6 +461,7 @@ infos:{}//数组对象 { "fun": "stopBindKeypad", "baseId": 1, + "baseSn":"2023031402", "infos": [{ "keySn": "1837454011", "state": "OK" @@ -476,6 +483,7 @@ params：{} //为空 { "fun": "stopBindKeypad", "baseId": 1, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -508,6 +516,7 @@ params：{} { "fun": "startBind", "baseId": 0, + "baseSnList":["2023031402"], "params": { "bindMode": "1", "lessMode": "0", @@ -541,6 +550,7 @@ infos:{} { "fun": "answerBind", "baseId": 1, + "baseSn":"2023031402", "infos": { "time": "2.42", "keySn": "1479824643", @@ -563,6 +573,7 @@ params:{} //默认空 { "fun": "stopBind", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -620,6 +631,7 @@ params：{} { "fun": "startChoices", "baseId": 0, + "baseSnList":["2023031402"], "params": { "optionsMode": "1", "secrecyMode": "0", @@ -644,6 +656,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "startChoices", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -662,9 +675,10 @@ infos: {} |Json字段|字段含义|赋值及含义| |---|---|---| -| time|答题时间|单位秒| +|time|答题时间|单位秒| |keySn|键盘Sn|| |keyValue|键值|键盘提交的值| +|keyBattery|电池状态|S6键盘电压值（V）
T2键盘电量值（%）| 指令样例： @@ -672,6 +686,7 @@ infos: {} { "fun": "answerChoices", "baseId": 1, + "baseSn":"2023031402", "infos": { "time": "2.42", "keySn": "1479824643", @@ -693,6 +708,7 @@ params:{} //默认空 { "fun": "stopChoices", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -709,6 +725,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "stopChoices", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -747,6 +764,7 @@ params：{} { "fun": "startTrueFalse", "baseId": 0, + "baseSnList":["2023031402"], "params": { "optionsMode": "1", "secrecyMode": "0", @@ -768,6 +786,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "startTrueFalse", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -796,6 +815,7 @@ infos: {} { "fun": "answerTrueFalse", "baseId": 1, + "baseSn":"2023031402", "infos": { "time": "2.42", "keySn": "1479824643", @@ -818,6 +838,7 @@ params:{} //默认空 { "fun": "stopTrueFalse", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -834,6 +855,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "stopTrueFalse", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -874,6 +896,7 @@ params：{} { "fun": "startMulQuestions", "baseId": 0, + "baseSnList":["2023031402"], "params": { "questionType": "0", "secrecyMode": "0", @@ -898,6 +921,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "startMulQuestions", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -925,6 +949,7 @@ infos: {} { "fun": "answerMulQuestions", "baseId": 1, + "baseSn":"2023031402", "infos": { "time": "2.42", "keySn": "1479824643", @@ -947,6 +972,7 @@ params:{} //默认空 { "fun": "stopMulQuestions", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -963,6 +989,7 @@ infos:{"state":"OK"} //返回状态,成功为OK { "fun": "stopMulQuestions", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -1003,6 +1030,7 @@ params：{} { "fun": "startVoice", "baseId": 0, + "baseSnList":["2023031402"], "params": { "recordingMode": "0", "submitTimes": "0", @@ -1031,6 +1059,7 @@ params：{} { "fun": "startVoice", "baseId": 0, + "baseSnList":["2023031402"], "params": { "recordingMode": "0", "submitTimes": "0", @@ -1056,6 +1085,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "startVoice", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -1086,6 +1116,7 @@ infos: {} { "fun": "answerVoiceFile", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1479749926", "filePath": "D:\voice\3_1479749926_196_2023-08-21 16-09-02 530.Mp3" @@ -1121,6 +1152,7 @@ infos: {} { "fun": "answerVoiceStream", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1479824643", "voiceId": "1", @@ -1153,6 +1185,7 @@ params:{} //默认空， { "fun": "stopVoice", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -1169,6 +1202,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "stopVoice", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -1204,6 +1238,7 @@ infos:{} // { "fun": "voicePacketLossInfo", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1837454011", "voiceId": "1", @@ -1243,6 +1278,7 @@ params：{} { "fun": "startRushAnswer", "baseId": 0, + "baseSnList":["2023031402"], "params": { "rushAnswerMode": "0", "modifyMode": "1" @@ -1263,6 +1299,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "startRushAnswer", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -1290,6 +1327,7 @@ infos: {} { "fun": "answerRushAnswer", "baseId": 1, + "baseSn":"2023031402", "infos": { "time": "1.42", "keySn": "1479824643", @@ -1311,6 +1349,7 @@ params:{} //默认空 { "fun": "stopRushAnswer", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -1327,6 +1366,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "stopRushAnswer", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -1368,6 +1408,7 @@ params：{} { "fun": "startNumber", "baseId": 0, + "baseSnList":["2023031402"], "params": { "secrecyMode": "0", "modifyMode": "1", @@ -1392,6 +1433,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "startNumber", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -1420,6 +1462,7 @@ infos: {} { "fun": "answerNumber", "baseId": 1, + "baseSn":"2023031402", "infos": { "time": "2.42", "keySn": "1479824643", @@ -1442,6 +1485,7 @@ params:{} //默认空 { "fun": "stopNumber", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -1458,6 +1502,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "stopNumber", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -1496,6 +1541,7 @@ params：{} { "fun": "startKeyPadTest", "baseId": 0, + "baseSnList":["2023031402"], "params": { "mode": "1", "keyTime": "0", @@ -1529,6 +1575,7 @@ infos: {} { "fun": "answerKeyPadTest", "baseId": 1, + "baseSn":"2023031402", "infos": { "time": "2.42", "keySn": "1479824643", @@ -1554,6 +1601,7 @@ params:{} //默认空 { "fun": "stopKeyPadTest", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -1570,6 +1618,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "stopKeyPadTest", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -1619,6 +1668,7 @@ params：{} { "fun": "startKeyPadMultipleQuestionsTest", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 0, @@ -1647,6 +1697,7 @@ params：{} { "fun": "startKeyPadMultipleQuestionsTest", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 0, @@ -1679,6 +1730,7 @@ params：{} { "fun": "startKeyPadMultipleQuestionsTest", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 0, @@ -1715,6 +1767,7 @@ params：{} { "fun": "startKeyPadMultipleQuestionsTest", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 1, @@ -1742,6 +1795,7 @@ params：{} { "fun": "startKeyPadMultipleQuestionsTest", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 2, @@ -1775,6 +1829,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "keyPadMultipleQuestionsTest", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -1811,6 +1866,7 @@ params：{} { "fun": "startKeyPadMultipleQuestionsCourse", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 0, @@ -1857,6 +1913,7 @@ params：{} { "fun": "startKeyPadMultipleQuestionsCourse", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 0, @@ -1889,6 +1946,7 @@ params：{} { "fun": "startKeyPadMultipleQuestionsCourse", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 1, @@ -1921,6 +1979,7 @@ params：{} { "fun": "startKeyPadMultipleQuestionsCourse", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 2, @@ -1959,6 +2018,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "keyPadMultipleQuestionsCourse", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -1989,6 +2049,7 @@ params：{} { "fun": "startKeyPadMultipleQuestionsSubjective", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "questions": [{ @@ -2024,6 +2085,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "KeyPadMultipleQuestionsSubjective", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -2057,6 +2119,7 @@ infos: {} { "fun": "answerKeyPadMultipleQuestions", "baseId": 1, + "baseSn":"2023031402", "infos": { "time": "5.42", "keySn": "1479824643", @@ -2081,8 +2144,8 @@ params:{} //默认空 ```json { "fun": "stopKeyPadMultipleQuestions", - "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -2101,6 +2164,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "stopKeyPadMultipleQuestions", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -2123,8 +2187,8 @@ params:{} //默认空 ```json { "fun": "pauseKeyPadMultipleQuestions", - "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -2144,6 +2208,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "pauseKeyPadMultipleQuestions", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -2183,6 +2248,7 @@ params：{} { "fun": "continueKeyPadMultipleQuestionsTest", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 0, @@ -2210,6 +2276,7 @@ params：{} { "fun": "continueKeyPadMultipleQuestionsTest", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 0, @@ -2241,6 +2308,7 @@ params：{} { "fun": "continueKeyPadMultipleQuestionsTest", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 0, @@ -2276,6 +2344,7 @@ params：{} { "fun": "continueKeyPadMultipleQuestionsTest", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 1, @@ -2303,6 +2372,7 @@ params：{} { "fun": "continueKeyPadMultipleQuestionsTest", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 2, @@ -2336,6 +2406,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "keyPadMultipleQuestionsTest", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -2372,6 +2443,7 @@ params：{} { "fun": "continueKeyPadMultipleQuestionsCourse", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 0, @@ -2420,6 +2492,7 @@ params：{} { "fun": "continueKeyPadMultipleQuestionsCourse", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 0, @@ -2452,6 +2525,7 @@ params：{} { "fun": "continueKeyPadMultipleQuestionsCourse", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 1, @@ -2484,6 +2558,7 @@ params：{} { "fun": "continueKeyPadMultipleQuestionsCourse", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "displayMode": 2, @@ -2522,6 +2597,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "keyPadMultipleQuestionsCourse", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -2552,6 +2628,7 @@ params：{} { "fun": "continueKeyPadMultipleQuestionsSubjective", "baseId": 0, + "baseSnList":["2023031402"], "params": { "examNo": 1, "questions": [{ @@ -2587,6 +2664,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "keyPadMultipleQuestionsSubjective", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -2617,6 +2695,7 @@ params:{} // { "fun": "copyKeyPadMultipleQuestions", "baseId": 1, + "baseSnList":["2023031402"], "params": { "keySn": "0007831203", "questions": [{ @@ -2645,6 +2724,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "copyKeyPadMultipleQuestions", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -2673,6 +2753,7 @@ params:{} //默认空 { "fun": "okKeyPadMultipleQuestions", "baseId": 0, + "baseSnList":["2023031402"], "params": [{ "id": "1", "questionType": "1", @@ -2698,6 +2779,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "okKeyPadMultipleQuestions", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -2735,6 +2817,7 @@ params：{} { "fun": "startTextAnswer", "baseId": 0, + "baseSnList":["2023031402"], "params": { "optionsMode": "1", "modifyMode": "1", @@ -2756,6 +2839,7 @@ infos:{"state":"OK"} //返回状态,成功为OK { "fun": "startTextAnswer", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -2783,6 +2867,7 @@ infos: {} { "fun": "answerTextAnswer", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1479824643", "keyValue": "abcdef" @@ -2802,6 +2887,8 @@ params:{} //默认空 ```json { "fun": "stopTextAnswer", + "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -2817,6 +2904,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "stopTextAnswer", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -2846,6 +2934,7 @@ params：{} { "fun": "startFreeQuestion", "baseId": 0, + "baseSnList":["2023031402"], "params": {}, "packetTag": "1" } @@ -2863,6 +2952,7 @@ infos:{"state":"OK"} //返回状态,成功为OK { "fun": "startFreeQuestion", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -2893,6 +2983,7 @@ infos: {} { "fun": "answerChoices", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1479824643", "keyValue": "ABC" @@ -2917,6 +3008,7 @@ infos: {} { "fun": "answerTrueFalse", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1479824643", "keyValue": "1" @@ -2940,6 +3032,7 @@ infos: {} { "fun": "answerNumber", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1479824643", "keyValue": "99.99" @@ -2961,6 +3054,8 @@ params:{} //默认空 ```json { "fun": "stopFreeQuestion", + "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -2976,6 +3071,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "stopFreeQuestion", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -2995,6 +3091,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "startKeyPadCustomQuestions", "baseId": 0, + "baseSnList":["2023031402"], "params": { "titleTable": ["数字表决1", "数字表决2", "数字表决3"], "optionTable": [ @@ -3141,6 +3238,7 @@ params：{} { "fun": "startKeyPadCustomQuestions", "baseId": 0, + "baseSnList":["2023031402"], "params": { "titleTable": ["单选题", "数字表决"], "optionTable": [ @@ -3224,8 +3322,9 @@ infos:{"state":"OK"}//返回状态,成功为OK ```json { - "baseId": 1, "fun": "startKeyPadCustomQuestions", + "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -3256,6 +3355,7 @@ infos: {} { "fun": "answerKeyPadCustomQuestions", "baseId": 1, + "baseSn":"2023031402", "infos": { "time": "5.42", "keySn": "1479824643", @@ -3280,6 +3380,7 @@ params:{} //默认空 { "fun": "stopKeyPadCustomQuestions", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -3296,6 +3397,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "stopKeyPadCustomQuestions", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -3376,6 +3478,7 @@ params：{} { "fun": "startKeyPadDigitalElections", "baseId": 0, + "baseSnList":["2023031402"], "params": { "titleTable": ["数字选举1", "数字选举2", "数字选举3"], "optionTable": [ @@ -3439,8 +3542,9 @@ infos:{"state":"OK"}//返回状态,成功为OK ```json { - "baseId": 1, "fun": "startKeyPadCustomQuestions", + "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -3471,6 +3575,7 @@ infos: {} { "fun": "answerKeyPadCustomQuestions", "baseId": 1, + "baseSn":"2023031402", "infos": { "time": "5.42", "keySn": "1479824643", @@ -3495,6 +3600,7 @@ params:{} //默认空 { "fun": "stopKeyPadCustomQuestions", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -3511,6 +3617,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "stopKeyPadCustomQuestions", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -3555,6 +3662,7 @@ params:{}// { "fun": "writeNFCInfo", "baseId": 1, + "baseSnList":["2023031402"], "params": { "userName": "张三", "matchCode": "22120007" @@ -3574,6 +3682,7 @@ infos:{"value":"OK"}//返回状态,成功为OK { "fun": "writeNFCInfo", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "OK" }, @@ -3606,6 +3715,7 @@ infos:{} { "fun": "NFCInfo", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1479824643", "state": "4", @@ -3638,6 +3748,7 @@ params:{}// { "fun": "writeNFCEmpty", "baseId": 1, + "baseSnList":["2023031402"], "params": {}, "packetTag": "1" } @@ -3653,6 +3764,7 @@ infos:{"value":"OK"}//返回状态,成功为OK { "fun": "writeNFCEmpty", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "OK" }, @@ -3688,6 +3800,7 @@ params：{}//可不填 { "fun": "readBaseStationID", "baseId": 2, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -3706,6 +3819,7 @@ infos:{"value":"2"}//返回基站ID { "fun": "baseStationID", "baseId": 2, + "baseSn":"2023031402", "infos": { "pathAdd": "12345", "value": "2" @@ -3737,6 +3851,7 @@ params：{}//可不填 { "fun": "readBaseStationChannel", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -3760,6 +3875,7 @@ params：{"value":"1"}//1~12 （频点） { "fun": "writeBaseStationChannel", "baseId": 1, + "baseSnList":["2023031402"], "params": { "value": "3", "values": ["3", "6", "9", "12"] @@ -3782,6 +3898,7 @@ infos:{"value":"3"}//返回基站频点值 { "fun": "baseStationChannel", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "3", "values": ["3", "6", "9", "12"] @@ -3814,6 +3931,7 @@ params：{}//可不填 { "fun": "readKeyboardLoginMenu", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -3832,6 +3950,7 @@ params：{"value":"1"}//0~1 （0不允许登录；1允许登录） { "fun": "writeKeyboardLoginMenu", "baseId": 1, + "baseSnList":["2023031402"], "params": { "value": "1" }, @@ -3854,6 +3973,7 @@ infos:{"value":"1"}//返回键盘登录菜单显示值 { "fun": "baseStationKeyboardLoginMenu", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "1" }, @@ -3887,6 +4007,7 @@ params：{}//可不填 { "fun": "readBaseStationModel", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -3906,6 +4027,7 @@ infos:{"value":"218"}//返回基站型号 { "fun": "baseStationModel", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "218" }, @@ -3947,6 +4069,7 @@ params：{}//可不填 { "fun": "readBaseStationSVersion", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -3966,6 +4089,7 @@ infos:{"value":"V2.0.2"}//返回基站软件版本 { "fun": "baseStationSVersion", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "V2.0.2" }, @@ -3998,6 +4122,7 @@ params：{}//可不填 { "fun": "readBaseStationSN", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -4017,6 +4142,7 @@ infos:{"value":"FFFFFFFFFF"}//返回基站序列号 { "fun": "baseStationSN", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "FFFFFFFFFF" }, @@ -4049,6 +4175,7 @@ params：{}//可不填 { "fun": "readBaseStationTitle", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -4068,6 +4195,7 @@ params：{"value":" A2021"}//基站名称，最长12字节 { "fun": "writeBaseStationTitle", "baseId": 1, + "baseSnList":["2023031402"], "params": { "value": "A2021" }, @@ -4090,6 +4218,7 @@ infos:{"value":"A2021"}//返回基站名称 { "fun": "baseStationTitle", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "A2021" }, @@ -4117,6 +4246,7 @@ params：{}//可不填 { "fun": "readPairMode", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -4150,6 +4280,7 @@ params：{"value":"4"}//1~9 { "fun": "writePairMode", "baseId": 1, + "baseSnList":["2023031402"], "params": { "value": "4" }, @@ -4168,6 +4299,7 @@ infos:{"value":"4"}//返回基站配对模式值 { "fun": "pairMode", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "4" }, @@ -4209,6 +4341,7 @@ params：{}//可不填 { "fun": "readBaseStationPairMode", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -4232,6 +4365,7 @@ params：{"value":"1"}// { "fun": "writeBaseStationPairMode", "baseId": 1, + "baseSnList":["2023031402"], "params": { "value": "1" }, @@ -4250,6 +4384,7 @@ infos:{"value":"1"}//返回基站配对模式值 { "fun": "baseStationPairMode", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "1" }, @@ -4281,6 +4416,7 @@ params：{}//可不填 { "fun": "readBaseStationMatchCode", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -4300,6 +4436,7 @@ infos:{"value":"21072333"}//返回基站配对码 { "fun": "baseStationMatchCode", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "21072333" }, @@ -4332,6 +4469,7 @@ packetTag:"0"//数据包标签 { "fun": "baseStationChannelInterference", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "5" }, @@ -4364,6 +4502,7 @@ params：{}//可不填 { "fun": "readBaseStationCapacity", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -4380,9 +4519,10 @@ infos:{"keypadNumber":"60","lock":"1"}//返回基站键盘容量值 指令样例： ```json -{ - "baseId": 2, +{ "fun": "baseStationCapacity", + "baseId": 2, + "baseSn":"2023031402", "infos": { "keypadNumber": "60", "lock": "1" @@ -4414,6 +4554,7 @@ params：{} { "fun": "startQuickMatch", "baseId": 1, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -4431,6 +4572,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "startQuickMatch", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -4452,6 +4594,7 @@ params:{} //默认空 { "fun": "stopQuickMatch", "baseId": 1, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -4469,6 +4612,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "stopQuickMatch", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -4501,6 +4645,7 @@ params：{}//可不填 { "fun": "readKeyboardLoginPW", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -4519,6 +4664,7 @@ params：{"value":"0"}//0~9999 （0不用核对） { "fun": "writeKeyboardLoginPW", "baseId": 1, + "baseSnList":["2023031402"], "params": { "value": "0" }, @@ -4541,6 +4687,7 @@ infos:{"value":"1"}//返回键盘登录密码值 { "fun": "baseStationKeyboardLoginPW", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "0" }, @@ -4572,6 +4719,7 @@ params：{}//可不填 { "fun": "readBaseStationNameHidden", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -4594,6 +4742,7 @@ params：{"value":"0"}//0~1 （0隐藏，1不隐藏） { "fun": "writeBaseStationNameHidden", "baseId": 1, + "baseSnList":["2023031402"], "params": { "value": "0" }, @@ -4616,6 +4765,7 @@ infos:{"value":"1"}//返回基站名称隐藏值 （0隐藏，1不隐藏） { "fun": "baseStationNameHidden", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "0" }, @@ -4646,6 +4796,7 @@ params：{}//可不填 { "fun": "readBaseStationTcpIp", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -4665,6 +4816,7 @@ params： { "fun": "writeBaseStationTcpIp", "baseId": 1, + "baseSnList":["2023031402"], "params": { "mac": "FF:FF:FF:FF:FF:FF", "ip": "192.168.10.10", @@ -4691,6 +4843,7 @@ infos:{"value":"1"}//返回基站TcpIp { "fun": "baseStationTcpIp", "baseId": 1, + "baseSn":"2023031402", "infos": { "ip": "192.168.10.10", "mac": "FF:FF:FF:FF:FF:FF", @@ -4723,6 +4876,7 @@ baseId: 0// { "fun": "readWhiteList", "baseId": 0, + "baseSnList":["2023031402"], "params": {}, "packetTag": "1" } @@ -4745,6 +4899,7 @@ infos:{}// { "fun": "whiteList", "baseId": 1, + "baseSn":"2023031402", "infos": [{ "keySn": "2111120140", "state": "0" @@ -4783,6 +4938,7 @@ keySnList：[]//键盘SN数组最多200键盘SN { "fun": "writeWhiteList", "baseId": 0, + "baseSnList":["2023031402"], "keySnList": [{ "keySn": "2111120140" }, @@ -4816,6 +4972,7 @@ infos:{}// { "fun": "whiteList", "baseId": 1, + "baseSn":"2023031402", "infos": [{ "keySn": "2111120140", "state": "OK" @@ -4859,6 +5016,7 @@ params:{} //数组对象，指定键盘需填 { "fun": "lockKeypad", "baseId": 1, + "baseSnList":["2023031402"], "keySnList": [{ "keySn": "2111120140" }, @@ -4879,6 +5037,7 @@ params:{} //数组对象，指定键盘需填 { "fun": "lockKeypad", "baseId": 1, + "baseSn":"2023031402", "infos": [{ "keySn": "1837454011", "state": "OK" @@ -4916,6 +5075,7 @@ params:{} //数组对象，指定键盘需填 { "fun": "unlockKeypad", "baseId": 1, + "baseSnList":["2023031402"], "keySnList": [{ "keySn": "2111120140" }, @@ -4936,6 +5096,7 @@ params:{} //数组对象，指定键盘需填 { "fun": "unlockKeypad", "baseId": 1, + "baseSn":"2023031402", "infos": [{ "keySn": "2111120140", "state": "OK" @@ -4970,6 +5131,7 @@ keySnList:[ "keySn":"2111120140"] //列表不能为空 { "fun": "addWhiteList", "baseId": 1, + "baseSnList":["2023031402"], "keySnList": [{ "keySn": "2111120140" }], @@ -4991,6 +5153,7 @@ infos:{}// { "fun": "whiteList", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1837454012", "state": "OK" @@ -5018,6 +5181,7 @@ keySnList:[ "keySn":"2111120140"] //列表不能为空 { "fun": "delWhiteList", "baseId": 0, + "baseSnList":["2023031402"], "keySnList": [{ "keySn": "2111120140" }], @@ -5039,6 +5203,7 @@ infos:{}// { "fun": "delWhiteList", "baseId": 1, + "baseSn":"2023031402", "packetTag": "1", "infos": { "keySn": "1837454012", @@ -5066,6 +5231,7 @@ params:{} //无 { "fun": "clearWhiteList", "baseId": 1, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -5082,6 +5248,7 @@ infos:{}// { "fun": "clearWhiteList", "baseId": 1, + "baseSn":"2023031402", "packetTag": "1", "infos": { "state": "OK" @@ -5112,6 +5279,7 @@ params：{"value":0}// { "fun": "readKeypadAutoPowerOffLevel", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -5128,6 +5296,7 @@ params：{"value":"0"}// { "fun": "writeKeypadAutoPowerOffLevel", "baseId": 1, + "baseSnList":["2023031402"], "params": { "value": "0" }, @@ -5146,6 +5315,7 @@ infos:{"value":"0"}//返回键盘关机时间等级 { "fun": "keypadAutoPowerOffLevel", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "0" }, @@ -5170,6 +5340,7 @@ params：{}//可不填 { "fun": "readBaseStationBaseConfig", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -5193,6 +5364,7 @@ params：{}// { "fun": "writeBaseStationBaseConfig", "baseId": 1, + "baseSnList":["2023031402"], "params": { "bootVibraton": "1", "voteVibraton": "1", @@ -5214,6 +5386,7 @@ infos:{ }//返回基站 { "fun": "baseStationBaseConfig", "baseId": 1, + "baseSn":"2023031402", "infos": { "bootVibraton": "1", "voteVibraton": "1", @@ -5240,6 +5413,7 @@ params：{}//可不填 { "fun":"readBaseStationAES", "baseId":0, + "baseSnList":["2023031402"], "packetTag":"1" } ``` @@ -5260,6 +5434,7 @@ params：{"value":"0"}// { "fun":"writeBaseStationAES", "baseId":1, + "baseSnList":["2023031402"], "packetTag":"1" } ``` @@ -5275,6 +5450,7 @@ infos:{"value":"1"}//返回基站AES { "fun": "baseStationAES", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "0" }, @@ -5299,6 +5475,7 @@ params：{}// { "fun": "copyBaseStationAES", "baseId": 0, + "baseSnList":["2023031402"], "params": { "destBaseID": "2", "sourceBaseID": "1" @@ -5318,6 +5495,7 @@ infos:{"value":"OK"}//返回状态 { "fun": "baseStationAES", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "OK" }, @@ -5370,6 +5548,7 @@ params：{} // { "fun": "writeKeypadDevice", "baseId": 1, + "baseSnList":["2023031402"], "params": { "ledTimes": "3", "ledOnTime": "1", @@ -5400,6 +5579,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "writeKeypadDevice", "baseId": 0, + "baseSn":"2023031402", "infos": { "keySn": "0000000000", "state": "OK" @@ -5413,6 +5593,8 @@ infos:{"state":"OK"}//返回状态,成功为OK ```json { "fun": "writeKeypadDevice", + "baseId": 0, + "baseSnList":["2023031402"], "keySnList": [{ "keySn": "0007899478" }], @@ -5443,9 +5625,10 @@ infos:{}//数组对象,同发送的 指令样例： ```json -{ - "baseId": 3, +{ "fun": "writeKeypadDevice", + "baseId": 3, + "baseSn":"2023031402", "infos": { "keySn": "0007899478", "state": "OK" @@ -5474,6 +5657,7 @@ params：{}//读取时不需要 { "fun": "readKeypadFeedbackMode", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -5496,6 +5680,7 @@ params：{"mode":"1", "value":"4"}// { "fun": "writeKeypadFeedbackMode", "baseId": 0, + "baseSnList":["2023031402"], "params": { "mode": "1", "value": "4" @@ -5521,6 +5706,7 @@ infos:{ "mode":"1", "value":"4"}//返回键盘反馈模式参数值 { "fun": "keypadFeedbackMode", "baseId": 1, + "baseSn":"2023031402", "infos": { "mode": "1", "value": "4" @@ -5549,8 +5735,9 @@ infos:{ "keySn":"2307269906", "keyValue":"A"}//返回键盘反馈模式参数值 ```json { - "baseId": 1, "fun": "immediateFeedback", + "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "2307269906", "keyValue": "A" @@ -5584,6 +5771,7 @@ infos:{ "keySn":"1479824643"}//返回键盘反馈模式参数值 { "fun": "keyboardOnlineOne", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1479824643" }, @@ -5616,6 +5804,7 @@ infos:{ "hModel": "67","keySn":"1479824643","keyValue":"0","ver":"1.0.0","volt": { "fun": "KeyboardHeartbeat", "baseId": 1, + "baseSn":"2023031402", "infos": { "hModel": "67", "keySn": "1479824643", @@ -5648,6 +5837,7 @@ params：{}// { "fun": "remoteKeyShutdown", "baseId": 1, + "baseSnList":["2023031402"], "params": [{ "keySn": "1837454011" }], @@ -5666,6 +5856,7 @@ infos:{"keySn":"1837454011","state":"OK"}//遥控键盘关机 { "fun": "remoteKeyShutdown", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1837454011", "state": "OK" @@ -5701,6 +5892,7 @@ params：{"value"} // { "fun": "writeKeyboardPauseSleep", "baseId": 0, + "baseSnList":["2023031402"], "params": { "value": "0" }, @@ -5722,6 +5914,7 @@ infos:{"value":"0"}//10秒 { "fun": "writeKeyboardPauseSleep", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "0" }, @@ -5755,6 +5948,7 @@ params：{} // 数组对象,对象中的默认值为空字符串 { "fun": "writeKeyMessage", "baseId": 0, + "baseSnList":["2023031402"], "params": { "txt": "最新消息" }, @@ -5773,6 +5967,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "writeKeyMessage", "baseId": 0, + "baseSn":"2023031402", "infos": { "keySn": "0000000000", "state": "OK" @@ -5786,6 +5981,8 @@ infos:{"state":"OK"}//返回状态,成功为OK ```json { "fun": "writeKeyMessage", + "baseId": 0, + "baseSnList":["2023031402"], "keySnList": [{ "keySn": "0007899478" }], @@ -5805,9 +6002,10 @@ infos:{}//数组对象,同发送的 指令样例： ```json -{ - "baseId": 3, +{ "fun": "writeKeyMessage", + "baseId": 3, + "baseSn":"2023031402", "infos": { "keySn": "0007899478", "state": "OK" @@ -5834,8 +6032,9 @@ params：{}//可不填 指令样例： ```json { - "fun": "readBaseStationLanguage", + "fun": "readBaseStationLanguage", "baseId": 0, + "baseSnList":["2023031402"], "packetTag": "1" } ``` @@ -5859,6 +6058,7 @@ params：{"value":"0"}// { "fun": "writeBaseStationLanguage", "baseId": 1, + "baseSnList":["2023031402"], "params": { "value": "0" }, @@ -5883,6 +6083,7 @@ infos:{"value":"1"}//返回基站语言值 { "fun": "baseStationLanguage", "baseId": 1, + "baseSn":"2023031402", "infos": { "value": "0" }, @@ -5912,6 +6113,8 @@ params：{} // 数组对象,对象中的默认值为空字符串 ```json { "fun": "writeKeyFSN", + "baseId": 3, + "baseSnList":["2023031402"], "params": { "keySnList": [{ "keySnOld": "0007899478", @@ -5936,9 +6139,10 @@ infos:{}//数组对象,同发送的 指令样例： ```json -{ - "baseId": 3, +{ "fun": "writeKeyFSN", + "baseId": 3, + "baseSn":"2023031402", "infos": { "keySn": "0007899478", "state": "OK" @@ -5974,6 +6178,7 @@ params:{} { "fun": "writeKeypadFreeTitle", "baseId": 1, + "baseSnList":["2023031402"], "params": { "title": "请认真听讲" }, @@ -5998,6 +6203,7 @@ infos:{}// { "fun": "writeKeypadFreeTitle", "baseId": 0, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -6019,7 +6225,7 @@ params：{}//数组对象,字段不填则保留上次值。 | **Json字段** | **字段含义** | **赋值及含义** | | --- | --- | --- | -| keySn| 键盘Sn| 空则为所有在线键盘，其他数组值无效| +| keySn| 键盘Sn| 不能为空| | scoreMode| 分数模式|1:清除
2:字符显示(默认值)
3:五角星显示
4:爱心显示[S6有效]| | scoreValue| 分数值|scoreMode == 1,此处无效.
scoreMode == 2,8个字符长度.
scoreMode == 3,0~6，2个分数表示1个五角星，最多3个.
scoreMode == 4,0~6，2个分数表示1个爱心，最多3个 [S6有效]| |tipText|提示文本| 最多8个汉字（16个字符）,键盘第二行显示| @@ -6032,6 +6238,7 @@ params：{}//数组对象,字段不填则保留上次值。 { "fun": "writeKeypadCustomInfo", "baseId": 1, + "baseSnList":["2023031402"], "params": [{ "keySn": "1479824643", "scoreMode": "2", @@ -6062,6 +6269,7 @@ infos:{}//数组对象 { "fun": "writeKeypadCustomInfo", "baseId": 0, + "baseSn":"2023031402", "infos": [{ "keySn": "1479824643", "state": "OK" @@ -6070,25 +6278,6 @@ infos:{}//数组对象 } ``` -所有键盘 - -fun: "writeKeypadCustomInfo" //写键盘的用户信息 -baseId:0 //接收到指令的基站ID -infos:{"state":"OK"}//返回状态,成功为OK - - -指令样例： - -```json -{ - "fun": "writeKeypadCustomInfo", - "baseId": 0, - "infos": { - "state": "OK" - }, - "packetTag": "1" -} -``` 支持设备说明 @@ -6109,7 +6298,7 @@ params：{}//数组对象,字段不填则保留上次值。 | **Json字段** | **字段含义** | **赋值及含义** | | --- | --- | --- | -|keySn|键盘SN|空则为所有在线键盘，其他数组值无效| +|keySn|键盘SN|不能为空| |userName|姓名|最多24个汉字（48个字符）,键盘左上角显示| 指令样例： @@ -6118,6 +6307,7 @@ params：{}//数组对象,字段不填则保留上次值。 { "fun": "writeKeypadUserName", "baseId": 1, + "baseSnList":["2023031402"], "params": [{ "keySn": "1479824643", "userName": "张三" @@ -6145,6 +6335,7 @@ infos:{}//数组对象 { "fun": "writeKeypadUserName", "baseId": 0, + "baseSn":"2023031402", "infos": { "keySn": "1479824643", "state": "OK" @@ -6166,6 +6357,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "writeKeypadUserName", "baseId": 0, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -6199,6 +6391,7 @@ params：{}//数组对象,字段不填则保留上次值。 { "fun": "writeOneKeypadUserName", "baseId": 0, + "baseSnList":["2023031402"], "params": [{ "keySn": "1479824643", "value": "张三" @@ -6225,6 +6418,7 @@ infos:{}//数组对象 { "fun": "oneKeypadUserName", "baseId": 1, + "baseSn":"2023031402", "infos": { "keySn": "1479824643", "value": "张三" @@ -6259,6 +6453,7 @@ params：{} { "fun": "writeKeypadFunPromptPreset", "baseId": 0, + "baseSnList":["2023031402"], "params": { "mode": "0", "type": "3", @@ -6288,6 +6483,7 @@ infos:{"state":"OK"}//返回状态,成功为OK { "fun": "writeKeypadFunPromptPreset", "baseId": 1, + "baseSn":"2023031402", "infos": { "state": "OK" }, @@ -6326,6 +6522,7 @@ infos:{} //数组对象 { "fun": "keypadOnLine", "baseId": 0, + "baseSn":"2023031402", "infos": [{ "baseId": "1", "keySn": "1837454011", @@ -6350,7 +6547,7 @@ infos:{} //数组对象 ### 主动获取在线信息 -应用程序在需要时，也可主动获取所有在线键盘信息。 +应用程序在需要时，也可主动获取所有基站在线键盘信息。 注意：请不要在开启投票业务时使用。
@@ -6366,7 +6563,6 @@ params:{ ```json { "fun": "getKeypadOnLine", - "baseId": 0, "params": { "times": 2 }, -- libgit2 0.21.4