From 1626a5cb5a4ca118ace9071296d9d441ebf02be9 Mon Sep 17 00:00:00 2001 From: DMchen Date: Tue, 26 Sep 2023 12:00:48 +0800 Subject: [PATCH] 1.SDK应用部分 更新了 基站的连接、断开和复位、签到设备、选择题、判断题、多题快答、语音题、抢答题、数字题和键盘测试，这些接口。 --- 通讯协议-SDK应用部分.md | 348 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 1 file changed, 146 insertions(+), 202 deletions(-) diff --git a/通讯协议-SDK应用部分.md b/通讯协议-SDK应用部分.md index 5863f2c..3f06ab9 100644 --- a/通讯协议-SDK应用部分.md +++ b/通讯协议-SDK应用部分.md @@ -1287,168 +1287,131 @@ infos:{"state":"OK"}//返回状态,成功为OK 发送： -fun: \"startNumber\" //开始数字题 - +fun: "startNumber" //开始数字题 params：{} -+----------------+--------------+-------------------------------------+ -| Json字段 | 字段含义 | 赋值及含义 | -+----------------+--------------+-------------------------------------+ -| secrecyMode | 保密模式 | 0-不保密(默认值) | -| | | | -| | | 1-保密 | -+----------------+--------------+-------------------------------------+ -| modifyMode | 修改模式 | 0-不可修改 | -| | | | -| | | 1-可以修改(默认值) | -+----------------+--------------+-------------------------------------+ -| aswOption | 按键模式 | 0-无规则 （S6最多16位，T2最多14位） | -| | | | -| | | 1-预留 | -| | | | -| | | 2-预留 | -| | | | -| | | 3-带小数位上下限（T2不支持） | -+----------------+--------------+-------------------------------------+ -| digits | 小数位数 | 0. 没有小数点 | -| | | | -| | | 1. 一位小数点 | -| | | | -| | | 2. 二位小数点 | -+----------------+--------------+-------------------------------------+ -| numMin | 下限 | 0-655.35 | -+----------------+--------------+-------------------------------------+ -| numMax | 上限 | 0-655.35 | -+----------------+--------------+-------------------------------------+ -| tipTitle | 提示标题 | 16个字节 | -+----------------+--------------+-------------------------------------+ - -指令样例： - -{\ -    \"fun\":\"startNumber\", - - \"baseId\":0,\ -    \"params\":{\ -         \"secrecyMode\":\"0\",\ -         \"modifyMode\":\"1\", - -\"aswOption\":\"0\", +|Json字段|字段含义|赋值及含义| +|---|---|---| +|secrecyMode|保密模式|0-不保密(默认值)
1-保密| +|modifyMode|修改模式|0-不可修改
1-可以修改(默认值)| +|aswOption|按键模式|0-无规则 （S6最多16位，T2最多14位）
1-预留
2-预留
3-带小数位上下限（T2不支持）| +|digits|小数位数|0.没有小数点
1.一位小数点
2.二位小数点| +|numMin|下限|0-655.35| +|numMax|上限|0-655.35| +|tipTitle|提示标题|16个字节| -\"digits\":\"0\", -\"numMin\":\"0\", -\"numMax\":\"0\"\ -    },\ -    \"packetTag\":\"1\"\ +指令样例： +```json +{ + "fun": "startNumber", + "baseId": 0, + "params": { + "secrecyMode": "0", + "modifyMode": "1", + "aswOption": "0", + "digits": "0", + "numMin": "0", + "numMax": "0" + }, + "packetTag": "1" } +``` 接收： -fun: \"startNumber\" //开始数字题 - -baseId: \"1\"//接收到指令的基站ID - -infos:{\"state\":\"OK\"}//返回状态,成功为OK +fun: "startNumber" //开始数字题 +baseId: "1"//接收到指令的基站ID +infos:{"state":"OK"}//返回状态,成功为OK 指令样例： -{\ -    \"fun\":\"startNumber\", - -\"baseId\":1,\ -  \"infos\":{\ -       \"state\":\"OK\"\ -    }, - -\"packetTag\":\"1\"\ +```json +{ + "fun": "startNumber", + "baseId": 1, + "infos": { + "state": "OK" + }, + "packetTag": "1" } +``` #### 接收作答 接收： -fun: \"answerNumber\" //数字题作答返回 - -baseId: \"1\"//接收到指令的基站ID - +fun: "answerNumber" //数字题作答返回 +baseId: "1"//接收到指令的基站ID infos: {} - ----------------- --------------- -------------------------------------- - Json字段 字段含义 赋值及含义 - - time 答题时间 单位秒 - - keySn 键盘Sn +|Json字段|字段含义|赋值及含义| +|---|---|---| +|time|答题时间|单位秒| +|keySn|键盘Sn|| +|keyValue|键值|键盘提交的值| - keyValue 键值 键盘提交的值 - ----------------- --------------- -------------------------------------- 指令样例： -{\ -    \"fun\":\"answerNumber\",\ -    \"baseId\":1,\ -    \"infos\":{\ -        \"time\":\"2.42\",\ -        \"keySn\":\"1479824643\",\ -        \"keyValue\":\"12\"\ -    }, - - \"packetTag\":\"1\"\ +```json +{ + "fun": "answerNumber", + "baseId": 1, + "infos": { + "time": "2.42", + "keySn": "1479824643", + "keyValue": "12" + }, + "packetTag": "1" } +``` #### 停止作答 发送： -fun: \"stopNumber\" //停止数字题 - +fun: "stopNumber" //停止数字题 params:{} //默认空 指令样例： -{\ -    \"fun\":\"stopNumber\", - - \"baseId\":0,\ -    \"packetTag\":\"1\"\ +```json +{ + "fun": "stopNumber", + "baseId": 0, + "packetTag": "1" } +``` 接收： -fun: \"stopNumber\" //停止数字题 - -baseId: \"1\"//收到的基站ID - -infos:{\"state\":\"OK\"}//返回状态,成功为OK +fun: "stopNumber" //停止数字题 +baseId: "1"//收到的基站ID +infos:{"state":"OK"}//返回状态,成功为OK 指令样例： -{\ -    \"fun\":\"stopNumber\",\ -    \"baseId\":1,\ -    \"infos\":{\ -          \"state\":\"OK\"\ -    },\ -    \"packetTag\":\"1\"\ +```json +{ + "fun": "stopNumber", + "baseId": 1, + "infos": { + "state": "OK" + }, + "packetTag": "1" } +``` #### 支持设备说明 -+--------------------+--------------+---------------------------------+ -| 基站+键盘 | 支持/不支持 | 备注 | -+--------------------+--------------+---------------------------------+ -| B100-2.4G+S6 | 支持 | 按键模式（0-无规则 最多16位） | -+--------------------+--------------+---------------------------------+ -| B200-2.4G+S6 | 支持 | 按键模式（0-无规则 最多16位） | -+--------------------+--------------+---------------------------------+ -| B200-5.8G+T2 | 支持 | 按键模式（0-无规则 最多14位） | -| | | | -| | | 按键模 | -| | | 式(3-带小数位上下限)（不支持） | -+--------------------+--------------+---------------------------------+ +|基站+键盘|支持/不支持|备注| +|---|---|---| +|B100-2.4G+S6|支持|按键模式（0-无规则 最多16位）| +|B200-2.4G+S6|支持|按键模式（0-无规则 最多16位）| +|B200-5.8G+T2|支持|按键模式（0-无规则 最多14位）
按键模式 (3-带小数位上下限)（不支持）| + ### 键盘测试 @@ -1456,130 +1419,111 @@ infos:{\"state\":\"OK\"}//返回状态,成功为OK 发送： -fun: \"startKeyPadTest\" //开始键盘 - +fun: "startKeyPadTest" //开始键盘 params：{} -+----------------+--------------+-------------------------------------+ -| Json字段 | 字段含义 | 赋值及含义 | -+----------------+--------------+-------------------------------------+ -| mode | 测试模式 | 1-报告状态 | -| | | | -| | | 2-按键模拟 | -+----------------+--------------+-------------------------------------+ -| keyTime | 启动时间 | 0-60 单位秒 0马上执行 默认为0 | -+----------------+--------------+-------------------------------------+ -| gapTime | 间隔时间 | 0-60 单位秒 0无效 默认为0 | -+----------------+--------------+-------------------------------------+ - -指令样例： +|Json字段|字段含义|赋值及含义| +|---|---|---| +|mode|测试模式|1-报告状态
2-按键模拟| +|keyTime|启动时间|0-60 单位秒 0马上执行 默认为0| +|gapTime|间隔时间|0-60 单位秒 0无效 默认为0| -{\ -    \"fun\":\"startKeyPadTest\", -  \"baseId\":0,\ -    \"params\":{\ -        \"mode\":\"1\",\ -        \"keyTime\":\"0\", +指令样例： -\"gapTime\":\"0\"\ -    },\ -    \"packetTag\":\"1\"\ +```json +{ + "fun": "startKeyPadTest", + "baseId": 0, + "params": { + "mode": "1", + "keyTime": "0", + "gapTime": "0" + }, + "packetTag": "1" } +``` #### 接收作答 接收： -fun: \"answerKeyPadTest\" //按键测试返回 - -baseId: \"1\"//接收到指令的基站ID - +fun: "answerKeyPadTest" //按键测试返回 +baseId: "1"//接收到指令的基站ID infos: {} - ----------------- --------------- -------------------------------------- - Json字段 字段含义 赋值及含义 - - Time 答题时间 单位秒 - - keySn 键盘Sn - - hModel 键盘硬件型号 - - keyValue 键值 - - Ver 键盘软件版本 +|Json字段|字段含义|赋值及含义| +|---|---|---| +|Time|答题时间|单位秒| +|keySn|键盘Sn|| +|hModel|键盘硬件型号|| +|keyValue|键盘键值|| +|ver|键盘软件版本|| +|volt|键盘电池电量|T2百分比值，S6无效| - Volt 键盘电池电量 T2百分比值，S6无效 - ----------------- --------------- -------------------------------------- 指令样例： -{\ -    \"fun\":\"answerKeyPadTest\",\ -    \"baseId\":1,\ -    \"infos\":{\ -        \"time\":\"2.42\", - -  \"hModel\":\"67\", - - \"keyValue\":\"0\", - -  \"ver\":\"1.0.0\",\ -        \"keySn\":\"1479824643\",\ -        \"volt\":\"12\"\ -    }, - - \"packetTag\":\"1\"\ +```json +{ + "fun": "answerKeyPadTest", + "baseId": 1, + "infos": { + "time": "2.42", + "keySn": "1479824643", + "hModel": "67", + "keyValue": "0", + "ver": "1.0.0", + "volt": "12" + }, + "packetTag": "1" } +``` #### 停止作答 发送： -fun: \"stopKeyPadTest\" //停止键盘测试 - +fun: "stopKeyPadTest" //停止键盘测试 params:{} //默认空 指令样例： -{\ -    \"fun\":\"stopKeyPadTest\", - -\"baseId\":0,\ -    \"packetTag\":\"1\"\ +```json +{ + "fun": "stopKeyPadTest", + "baseId": 0, + "packetTag": "1" } +``` 接收： -fun: \"stopKeyPadTest\" //停止键盘测试 - -baseId: \"1\"//收到的基站ID - -infos:{\"state\":\"OK\"}//返回状态,成功为OK +fun: "stopKeyPadTest" //停止键盘测试 +baseId: "1"//收到的基站ID +infos:{"state":"OK"}//返回状态,成功为OK 指令样例： -{\ -    \"fun\":\"stopKeyPadTest\",\ -    \"baseId\":1,\ -    \"infos\":{\ -          \"state\":\"OK\"\ -    },\ -    \"packetTag\":\"1\"\ +```json +{ + "fun": "stopKeyPadTest", + "baseId": 1, + "infos": { + "state": "OK" + }, + "packetTag": "1" } +``` #### 支持设备说明 - ----------------------- ----------------------- ----------------------- - 基站+键盘 支持/不支持 备注 - - B100-2.4G+S6 支持 键盘电池电量参数无效 - - B200-2.4G+S6 支持 键盘电池电量参数无效 +|基站+键盘|支持/不支持|备注| +|---|---|---| +|B100-2.4G+S6|支持|键盘电池电量参数无效| +|B200-2.4G+S6|支持|键盘电池电量参数无效| +|B200-5.8G+T2|支持|| - B200-5.8G+T2 支持 - ----------------------- ----------------------- ----------------------- ### 多题题型 #### 开始测试 -- libgit2 0.21.4