From 5f377e7e490471372f9c9b9cfb116731b55e5ddb Mon Sep 17 00:00:00 2001 From: DMchen Date: Mon, 25 Sep 2023 16:18:54 +0800 Subject: [PATCH] 1.SDK应用部分 多题型接口更新。 --- 通讯协议-SDK应用部分.md | 1126 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 1 file changed, 765 insertions(+), 361 deletions(-) diff --git a/通讯协议-SDK应用部分.md b/通讯协议-SDK应用部分.md index 3b01024..c989dda 100644 --- a/通讯协议-SDK应用部分.md +++ b/通讯协议-SDK应用部分.md @@ -1745,11 +1745,13 @@ infos:{\"state\":\"OK\"}//返回状态,成功为OK ### 多题题型 #### 开始测试 -##### 一级题型接口[无科目] + + +##### 一级题型接口[有科目 + 题/Q开头] 发送: -fun: "startKeyPadMultipleQuestionsLevel1" //开始多题题型 +fun: "startKeyPadMultipleQuestionsLevel1Course" //开始多题题型 params:{} | **Json字段** | **字段含义** | **赋值及含义** | @@ -1763,29 +1765,34 @@ params:{} | **Json字段** | **字段含义** | **赋值及含义** | | --- | --- | --- | | questionLevel1Symbol | 一级题号 | 1-200 | +| course | 科目 | 1:语文
2:数学
3:英语
4:政治
5:历史
6:地理
7:生物
8:物理
9:化学 | | questionType | 题目类型 | 1:单选
2:多选(排序)
3:数字
4:判断 | -| option | 选项数目 | 当questionType = 2 有效。
此项缺省时 默认4;
范围:1-10。| +| option | 选项数目 | 当questionType = 1 有效。
当questionType = 2 有效。
此项缺省时 默认4;
范围:1-10。| 指令样例: ```json { - "fun": "startKeyPadMultipleQuestionsLevel1", + "fun": "startKeyPadMultipleQuestionsLevel1Course", "baseId": 0, "params": { "examNo": 1, "displayMode": 1, "questions": [{ "questionLevel1Symbol": "1", + "course": "1", "questionType": "1" }, { "questionLevel1Symbol": "2", + "course": "1", "questionType": "2", "option": "5" }, { "questionLevel1Symbol": "3", + "course": "1", "questionType": "3" }, { "questionLevel1Symbol": "4", + "course": "1", "questionType": "4" }] }, @@ -1795,7 +1802,7 @@ params:{} 接收: -fun: "startKeyPadMultipleQuestionsLevel1" // +fun: "KeyPadMultipleQuestionsLevel1Course" // baseId: "1"//收到的基站ID infos:{"state":"OK"}//返回状态,成功为OK @@ -1803,7 +1810,7 @@ infos:{"state":"OK"}//返回状态,成功为OK ```json { - "fun": "startKeyPadMultipleQuestionsLevel1", + "fun": "KeyPadMultipleQuestionsLevel1Course", "baseId": 1, "infos": { "state": "OK" @@ -1816,49 +1823,54 @@ infos:{"state":"OK"}//返回状态,成功为OK 发送: -fun: "startKeyPadMultipleQuestionsLevel1Course" //开始多题题型 +fun: "startKeyPadMultipleQuestionsLevel2Course" //开始多题题型 params:{} | **Json字段** | **字段含义** | **赋值及含义** | | --- | --- | --- | | examNo | 测验编号 | 1-9999 | -| displayMode | 题号显示模式 | 1: 显示“Q”开头
2: 显示“题”开头| | questions | 题目详情 | 数组[最大200个单元] | 题目详情数组参数说明 | **Json字段** | **字段含义** | **赋值及含义** | | --- | --- | --- | -| questionLevel1Symbol | 一级题号 | 1-200 | +| questionLevel1Symbol | 一级题号 | 0 | +| questionLevel2Symbol | 二级题号 | 1-200 | | course | 科目 | 1:语文
2:数学
3:英语
4:政治
5:历史
6:地理
7:生物
8:物理
9化学 | | questionType | 题目类型 | 1:单选
2:多选(排序)
3:数字
4:判断 | -| option | 选项数目 | 当questionType = 2 有效。
此项缺省时 optional 项值代替;
范围:1-optional。| +| option | 选项数目 | 当questionType = 1 有效。
当questionType = 2 有效。
此项缺省时 默认4;
范围:1-10。| -指令样例: ```json { - "fun": "startKeyPadMultipleQuestionsLevel1Course", + "fun": "startKeyPadMultipleQuestionsLevel2Course", "baseId": 0, "params": { "examNo": 1, - "displayMode": 1, "questions": [{ - "questionLevel1Symbol": "1", + "questionLevel1Symbol": "0", + "questionLevel2Symbol": "1", "course": "1", - "questionType": "1" + "questionType": "1", + "option": "4" }, { - "questionLevel1Symbol": "2", - "course": "1", + "questionLevel1Symbol": "0", + "questionLevel2Symbol": "2", + "course": "2", "questionType": "2", - "option": "5" + "option": "4" }, { - "questionLevel1Symbol": "3", - "course": "1", - "questionType": "3" + "questionLevel1Symbol": "0", + "questionLevel2Symbol": "3", + "course": "3", + "questionType": "3", + "option": "4" }, { - "questionLevel1Symbol": "4", - "course": "1", - "questionType": "4" + "questionLevel1Symbol": "0", + "questionLevel2Symbol": "4", + "course": "4", + "questionType": "4", + "option": "4" }] }, "packetTag": "59" @@ -1867,7 +1879,7 @@ params:{} 接收: -fun: "startKeyPadMultipleQuestionsLevel1Course" // +fun: "KeyPadMultipleQuestionsLevel2Course" // baseId: "1"//收到的基站ID infos:{"state":"OK"}//返回状态,成功为OK @@ -1875,7 +1887,7 @@ infos:{"state":"OK"}//返回状态,成功为OK ```json { - "fun": "startKeyPadMultipleQuestionsLevel1Course", + "fun": "KeyPadMultipleQuestionsLevel2Course", "baseId": 1, "infos": { "state": "OK" @@ -1884,19 +1896,17 @@ infos:{"state":"OK"}//返回状态,成功为OK } ``` -##### 三级题型接口[无科目] +##### 二级题型接口[有科目] 发送: -fun: "startKeyPadMultipleQuestionsLevel3" //开始多题题型 +fun: "startKeyPadMultipleQuestionsLevel2Course" //开始多题题型 params:{} | **Json字段** | **字段含义** | **赋值及含义** | | --- | --- | --- | | examNo | 测验编号 | 1-9999 | -| Total | 题目数量 | 1-200 | -| optional | 选项数目 |1-10 默认4 | -| questions | 题目详情 | 数组 | +| questions | 题目详情 | 数组[最大200个单元] | 题目详情数组参数说明 @@ -1904,37 +1914,40 @@ params:{} | --- | --- | --- | | questionLevel1Symbol | 一级题号 | 1-99 | | questionLevel2Symbol | 二级题号 | 1-99 | -| questionLevel3Symbol | 三级题号 | 1-99 | +| course | 科目 | 1:语文
2:数学
3:英语
4:政治
5:历史
6:地理
7:生物
8:物理
9化学 | | questionType | 题目类型 | 1:单选
2:多选(排序)
3:数字
4:判断 | -| option | 选项数目 | 当questionType = 2 有效。
此项缺省时 optional 项值代替;
范围:1-optional。| +| option | 选项数目 | 当questionType = 1 有效。
当questionType = 2 有效。
此项缺省时 默认4;
范围:1-10。| ```json { - "fun": "startKeyPadMultipleQuestionsLevel3", + "fun": "startKeyPadMultipleQuestionsLevel2Course", "baseId": 0, "params": { "examNo": 1, "questions": [{ "questionLevel1Symbol": "1", "questionLevel2Symbol": "1", - "questionLevel3Symbol": "1", - "questionType": "1" + "course": "1", + "questionType": "1", + "option": "4" }, { "questionLevel1Symbol": "1", "questionLevel2Symbol": "2", - "questionLevel3Symbol": "3", + "course": "2", "questionType": "2", - "option": "5" + "option": "4" }, { "questionLevel1Symbol": "1", - "questionLevel2Symbol": "2", - "questionLevel3Symbol": "4", - "questionType": "3" + "questionLevel2Symbol": "3", + "course": "3", + "questionType": "3", + "option": "4" }, { "questionLevel1Symbol": "1", - "questionLevel2Symbol": "2", - "questionLevel3Symbol": "5", - "questionType": "4" + "questionLevel2Symbol": "4", + "course": "4", + "questionType": "4", + "option": "4" }] }, "packetTag": "59" @@ -1943,7 +1956,7 @@ params:{} 接收: -fun: "startKeyPadMultipleQuestionsLevel3" // +fun: "KeyPadMultipleQuestionsLevel2Course" // baseId: "1"//收到的基站ID infos:{"state":"OK"}//返回状态,成功为OK @@ -1951,7 +1964,7 @@ infos:{"state":"OK"}//返回状态,成功为OK ```json { - "fun": "startKeyPadMultipleQuestionsLevel3", + "fun": "KeyPadMultipleQuestionsLevel2Course", "baseId": 1, "infos": { "state": "OK" @@ -1960,58 +1973,48 @@ infos:{"state":"OK"}//返回状态,成功为OK } ``` -##### 二级题型接口[有科目] +##### 一级题型接口[无科目 + 题/Q开头] 发送: -fun: "startKeyPadMultipleQuestionsLevel2Course" //开始多题题型 +fun: "startKeyPadMultipleQuestionsLevel1" //开始多题题型 params:{} | **Json字段** | **字段含义** | **赋值及含义** | | --- | --- | --- | | examNo | 测验编号 | 1-9999 | -| questions | 题目详情 | 数组 | +| displayMode | 题号显示模式 | 1: 显示“Q”开头
2: 显示“题”开头| +| questions | 题目详情 | 数组[最大200个单元] | 题目详情数组参数说明 | **Json字段** | **字段含义** | **赋值及含义** | | --- | --- | --- | -| questionLevel1Symbol | 一级题号 | 1-99 | -| questionLevel2Symbol | 二级题号 | 1-99 | -| course | 科目 | 1:语文
2:数学
3:英语
4:政治
5:历史
6:地理
7:生物
8:物理
9化学 | +| questionLevel1Symbol | 一级题号 | 1-200 | | questionType | 题目类型 | 1:单选
2:多选(排序)
3:数字
4:判断 | -| option | 选项数目 | 当questionType = 2 有效。
此项缺省时 optional 项值代替;
范围:1-optional。| +| option | 选项数目 | 当questionType = 1 有效。
当questionType = 2 有效。
此项缺省时 默认4;
范围:1-10。| +指令样例: ```json { - "fun": "startKeyPadMultipleQuestionsLevel2Course", + "fun": "startKeyPadMultipleQuestionsLevel1", "baseId": 0, "params": { "examNo": 1, + "displayMode": 1, "questions": [{ "questionLevel1Symbol": "1", - "questionLevel2Symbol": "1", - "course": "1", - "questionType": "1", - "option": "4" + "questionType": "1" }, { - "questionLevel1Symbol": "1", - "questionLevel2Symbol": "2", - "course": "2", + "questionLevel1Symbol": "2", "questionType": "2", - "option": "4" + "option": "5" }, { - "questionLevel1Symbol": "1", - "questionLevel2Symbol": "3", - "course": "3", - "questionType": "3", - "option": "4" + "questionLevel1Symbol": "3", + "questionType": "3" }, { - "questionLevel1Symbol": "1", - "questionLevel2Symbol": "4", - "course": "4", - "questionType": "4", - "option": "4" + "questionLevel1Symbol": "4", + "questionType": "4" }] }, "packetTag": "59" @@ -2020,7 +2023,7 @@ params:{} 接收: -fun: "startKeyPadMultipleQuestionsLevel2Course" // +fun: "KeyPadMultipleQuestionsLevel1" // baseId: "1"//收到的基站ID infos:{"state":"OK"}//返回状态,成功为OK @@ -2028,7 +2031,7 @@ infos:{"state":"OK"}//返回状态,成功为OK ```json { - "fun": "startKeyPadMultipleQuestionsLevel2Course", + "fun": "KeyPadMultipleQuestionsLevel1", "baseId": 1, "infos": { "state": "OK" @@ -2037,46 +2040,55 @@ infos:{"state":"OK"}//返回状态,成功为OK } ``` -##### 主观题接口 +##### 一级题型接口[无科目] + 发送: -fun: "startKeyPadMultipleQuestionsSubjective" //开始多题题型 +fun: "startKeyPadMultipleQuestionsLevel3" //开始多题题型 params:{} | **Json字段** | **字段含义** | **赋值及含义** | | --- | --- | --- | | examNo | 测验编号 | 1-9999 | -| questions | 题目详情 | 数组 | +| questions | 题目详情 | 数组[最大200个单元] | 题目详情数组参数说明 | **Json字段** | **字段含义** | **赋值及含义** | | --- | --- | --- | -| questionLevel1Symbol | 一级题号 | 1-200 | -| toplimit | 数字上限 | 1-100 | -| decimal | 小数位数 | 0:无效小数
1:一位小数
2:二位小数 [默认是2]
此项缺省时默认是0。| +| questionLevel1Symbol | 一级题号 | 0 | +| questionLevel2Symbol | 二级题号 | 0 | +| questionLevel3Symbol | 三级题号 | 1-99 | +| questionType | 题目类型 | 1:单选
2:多选(排序)
3:数字
4:判断 | +| option | 选项数目 |当questionType = 1 有效。
当questionType = 2 有效。
此项缺省时 默认4;
范围:1-10。| ```json { - "fun": "startKeyPadMultipleQuestionsSubjective", + "fun": "startKeyPadMultipleQuestionsLevel3", "baseId": 0, "params": { "examNo": 1, "questions": [{ - "questionLevel1Symbol": "1", - "toplimit": "100", - "decimal": "0" + "questionLevel1Symbol": "0", + "questionLevel2Symbol": "0", + "questionLevel3Symbol": "1", + "questionType": "1" }, { - "questionLevel1Symbol": "2", - "toplimit": "100", - "decimal": "1" + "questionLevel1Symbol": "0", + "questionLevel2Symbol": "0", + "questionLevel3Symbol": "3", + "questionType": "2", + "option": "5" }, { - "questionLevel1Symbol": "3", - "toplimit": "100", - "decimal": "2" + "questionLevel1Symbol": "0", + "questionLevel2Symbol": "0", + "questionLevel3Symbol": "4", + "questionType": "3" }, { - "questionLevel1Symbol": "4", - "toplimit": "100" + "questionLevel1Symbol": "0", + "questionLevel2Symbol": "0", + "questionLevel3Symbol": "5", + "questionType": "4" }] }, "packetTag": "59" @@ -2085,7 +2097,7 @@ params:{} 接收: -fun: "startKeyPadMultipleQuestionsSubjective" // +fun: "KeyPadMultipleQuestionsLevel3" // baseId: "1"//收到的基站ID infos:{"state":"OK"}//返回状态,成功为OK @@ -2093,7 +2105,7 @@ infos:{"state":"OK"}//返回状态,成功为OK ```json { - "fun": "startKeyPadMultipleQuestionsSubjective", + "fun": "KeyPadMultipleQuestionsLevel3", "baseId": 1, "infos": { "state": "OK" @@ -2102,169 +2114,597 @@ infos:{"state":"OK"}//返回状态,成功为OK } ``` +##### 二级题型接口[无科目] +发送: -#### 接收作答 - -接收: - -fun: "answerKeyPadMultipleQuestions" //多题题型返回 - -baseId: "1" //接收到指令的基站ID - -infos: {} +fun: "startKeyPadMultipleQuestionsLevel3" //开始多题题型 +params:{} | **Json字段** | **字段含义** | **赋值及含义** | | --- | --- | --- | -| Time | 答题时间 | [time/5=实际时间] 单位秒,20分钟内有效 | -| keySn | 键盘Sn | | -| Seq | 题序号 | | -| keyValue | 键值 |键盘提交的值 | - - - -指令样例: -```json -{ - "fun": "answerKeyPadMultipleQuestions", - "baseId": 1, - "infos": { - "time": "5.42", - "keySn": "1479824643", - "seq": "1", - "keyValue": "12" - }, - - "packetTag": "1" -} -``` - -#### 退出作答 - -发送: - -fun: "stopKeyPadMultipleQuestions" //停止多题题型 +| examNo | 测验编号 | 1-9999 | +| questions | 题目详情 | 数组[最大200个单元] | -params:{} //默认空 +题目详情数组参数说明 -指令样例: +| **Json字段** | **字段含义** | **赋值及含义** | +| --- | --- | --- | +| questionLevel1Symbol | 一级题号 | 0 | +| questionLevel2Symbol | 二级题号 | 1-99 | +| questionLevel3Symbol | 三级题号 | 1-99 | +| questionType | 题目类型 | 1:单选
2:多选(排序)
3:数字
4:判断 | +| option | 选项数目 |当questionType = 1 有效。
当questionType = 2 有效。
此项缺省时 默认4;
范围:1-10。| ```json { - "fun": "stopKeyPadMultipleQuestions", - + "fun": "startKeyPadMultipleQuestionsLevel3", "baseId": 0, - "packetTag": "1" + "params": { + "examNo": 1, + "questions": [{ + "questionLevel1Symbol": "0", + "questionLevel2Symbol": "1", + "questionLevel3Symbol": "1", + "questionType": "1" + }, { + "questionLevel1Symbol": "0", + "questionLevel2Symbol": "2", + "questionLevel3Symbol": "3", + "questionType": "2", + "option": "5" + }, { + "questionLevel1Symbol": "0", + "questionLevel2Symbol": "2", + "questionLevel3Symbol": "4", + "questionType": "3" + }, { + "questionLevel1Symbol": "0", + "questionLevel2Symbol": "2", + "questionLevel3Symbol": "5", + "questionType": "4" + }] + }, + "packetTag": "59" } ``` 接收: -fun: "stopKeyPadMultipleQuestions" //停止键盘测试 - +fun: "KeyPadMultipleQuestionsLevel3" // baseId: "1"//收到的基站ID - infos:{"state":"OK"}//返回状态,成功为OK 指令样例: ```json { - "fun": "stopKeyPadMultipleQuestions", + "fun": "KeyPadMultipleQuestionsLevel3", "baseId": 1, "infos": { "state": "OK" }, - "packetTag": "1" + "packetTag": "59" } ``` -#### 暂停作答 +##### 三级题型接口[无科目] 发送: -fun: "pauseKeyPadMultipleQuestions" //暂停多提题性 +fun: "startKeyPadMultipleQuestionsLevel3" //开始多题题型 +params:{} -baseId: "1"//收到的基站ID +| **Json字段** | **字段含义** | **赋值及含义** | +| --- | --- | --- | +| examNo | 测验编号 | 1-9999 | +| questions | 题目详情 | 数组[最大200个单元] | -params:{} //默认空 +题目详情数组参数说明 -指令样例: +| **Json字段** | **字段含义** | **赋值及含义** | +| --- | --- | --- | +| questionLevel1Symbol | 一级题号 | 1-99 | +| questionLevel2Symbol | 二级题号 | 1-99 | +| questionLevel3Symbol | 三级题号 | 1-99 | +| questionType | 题目类型 | 1:单选
2:多选(排序)
3:数字
4:判断 | +| option | 选项数目 |当questionType = 1 有效。
当questionType = 2 有效。
此项缺省时 默认4;
范围:1-10。| ```json { - "fun": "pauseKeyPadMultipleQuestions", - + "fun": "startKeyPadMultipleQuestionsLevel3", + "baseId": 0, + "params": { + "examNo": 1, + "questions": [{ + "questionLevel1Symbol": "1", + "questionLevel2Symbol": "1", + "questionLevel3Symbol": "1", + "questionType": "1" + }, { + "questionLevel1Symbol": "1", + "questionLevel2Symbol": "2", + "questionLevel3Symbol": "3", + "questionType": "2", + "option": "5" + }, { + "questionLevel1Symbol": "1", + "questionLevel2Symbol": "2", + "questionLevel3Symbol": "4", + "questionType": "3" + }, { + "questionLevel1Symbol": "1", + "questionLevel2Symbol": "2", + "questionLevel3Symbol": "5", + "questionType": "4" + }] + }, + "packetTag": "59" +} +``` + +接收: + +fun: "KeyPadMultipleQuestionsLevel3" // +baseId: "1"//收到的基站ID +infos:{"state":"OK"}//返回状态,成功为OK + +指令样例: + +```json +{ + "fun": "KeyPadMultipleQuestionsLevel3", + "baseId": 1, + "infos": { + "state": "OK" + }, + "packetTag": "59" +} +``` + + +##### 主观题接口 +发送: + +fun: "startKeyPadMultipleQuestionsSubjective" //开始多题题型 +params:{} + +| **Json字段** | **字段含义** | **赋值及含义** | +| --- | --- | --- | +| examNo | 测验编号 | 1-9999 | +| questions | 题目详情 | 数组[最大200个单元] | + +题目详情数组参数说明 + +| **Json字段** | **字段含义** | **赋值及含义** | +| --- | --- | --- | +| questionLevel1Symbol | 一级题号 | 1-200 | +| toplimit | 数字上限 | 1-100 | +| decimal | 小数位数 | 0:无效小数
1:一位小数
2:二位小数 [默认是2]
此项缺省时默认是0。| + +```json +{ + "fun": "startKeyPadMultipleQuestionsSubjective", + "baseId": 0, + "params": { + "examNo": 1, + "questions": [{ + "questionLevel1Symbol": "1", + "toplimit": "100", + "decimal": "0" + }, { + "questionLevel1Symbol": "2", + "toplimit": "100", + "decimal": "1" + }, { + "questionLevel1Symbol": "3", + "toplimit": "100", + "decimal": "2" + }, { + "questionLevel1Symbol": "4", + "toplimit": "100" + }] + }, + "packetTag": "59" +} +``` + +接收: + +fun: "KeyPadMultipleQuestionsSubjective" // +baseId: "1"//收到的基站ID +infos:{"state":"OK"}//返回状态,成功为OK + +指令样例: + +```json +{ + "fun": "KeyPadMultipleQuestionsSubjective", + "baseId": 1, + "infos": { + "state": "OK" + }, + "packetTag": "59" +} +``` + + + +#### 接收作答 + +接收: + +fun: "answerKeyPadMultipleQuestions" //多题题型返回 + +baseId: "1" //接收到指令的基站ID + +infos: {} + +| **Json字段** | **字段含义** | **赋值及含义** | +| --- | --- | --- | +| Time | 答题时间 | [time/5=实际时间] 单位秒,20分钟内有效 | +| keySn | 键盘Sn | | +| Seq | 题序号 | | +| keyValue | 键值 |键盘提交的值 | + + + +指令样例: +```json +{ + "fun": "answerKeyPadMultipleQuestions", + "baseId": 1, + "infos": { + "time": "5.42", + "keySn": "1479824643", + "seq": "1", + "keyValue": "12" + }, + + "packetTag": "1" +} +``` + +#### 退出作答 + +发送: + +fun: "stopKeyPadMultipleQuestions" //停止多题题型 + +params:{} //默认空 + +指令样例: + +```json +{ + "fun": "stopKeyPadMultipleQuestions", + + "baseId": 0, + "packetTag": "1" +} +``` + +接收: + +fun: "stopKeyPadMultipleQuestions" //停止键盘测试 + +baseId: "1"//收到的基站ID + +infos:{"state":"OK"}//返回状态,成功为OK + +指令样例: + +```json +{ + "fun": "stopKeyPadMultipleQuestions", + "baseId": 1, + "infos": { + "state": "OK" + }, + "packetTag": "1" +} +``` + +#### 暂停作答 + +发送: + +fun: "pauseKeyPadMultipleQuestions" //暂停多提题性 + +baseId: "1"//收到的基站ID + +params:{} //默认空 + +指令样例: + +```json +{ + "fun": "pauseKeyPadMultipleQuestions", + "baseId": 0, "packetTag": "1" } ``` - + +接收: + +fun: "pauseKeyPadMultipleQuestions" //暂停键盘测试 + +baseId: "1"//收到的基站ID + +infos:{"state":"OK"}//返回状态,成功为OK + +指令样例: + +```json +{ + "fun": "pauseKeyPadMultipleQuestions", + "baseId": 1, + "infos": { + "state": "OK" + }, + "packetTag": "1" +} +``` + +#### 继续测试 + + +##### 一级题型接口[有科目 + 题/Q开头] + +发送: + +fun: "continueKeyPadMultipleQuestionsLevel1Course" //开始多题题型 +params:{} + +| **Json字段** | **字段含义** | **赋值及含义** | +| --- | --- | --- | +| examNo | 测验编号 | 1-9999 | +| displayMode | 题号显示模式 | 1: 显示“Q”开头
2: 显示“题”开头| +| questions | 题目详情 | 数组[最大200个单元] | + +题目详情数组参数说明 + +| **Json字段** | **字段含义** | **赋值及含义** | +| --- | --- | --- | +| questionLevel1Symbol | 一级题号 | 1-200 | +| course | 科目 | 1:语文
2:数学
3:英语
4:政治
5:历史
6:地理
7:生物
8:物理
9化学 | +| questionType | 题目类型 | 1:单选
2:多选(排序)
3:数字
4:判断 | +| option | 选项数目 | 当questionType = 1 有效。
当questionType = 2 有效。
此项缺省时 默认4;
范围:1-10。| + +指令样例: +```json +{ + "fun": "continueKeyPadMultipleQuestionsLevel1Course", + "baseId": 0, + "params": { + "examNo": 1, + "displayMode": 1, + "questions": [{ + "questionLevel1Symbol": "1", + "course": "1", + "questionType": "1" + }, { + "questionLevel1Symbol": "2", + "course": "1", + "questionType": "2", + "option": "5" + }, { + "questionLevel1Symbol": "3", + "course": "1", + "questionType": "3" + }, { + "questionLevel1Symbol": "4", + "course": "1", + "questionType": "4" + }] + }, + "packetTag": "59" +} +``` + +接收: + +fun: "KeyPadMultipleQuestionsLevel1Course" // +baseId: "1"//收到的基站ID +infos:{"state":"OK"}//返回状态,成功为OK + +指令样例: + +```json +{ + "fun": "KeyPadMultipleQuestionsLevel1Course", + "baseId": 1, + "infos": { + "state": "OK" + }, + "packetTag": "59" +} +``` + +##### 一级题型接口[有科目] + +发送: + +fun: "continueKeyPadMultipleQuestionsLevel2Course" //开始多题题型 +params:{} + +| **Json字段** | **字段含义** | **赋值及含义** | +| --- | --- | --- | +| examNo | 测验编号 | 1-9999 | +| questions | 题目详情 | 数组[最大200个单元] | + +题目详情数组参数说明 + +| **Json字段** | **字段含义** | **赋值及含义** | +| --- | --- | --- | +| questionLevel1Symbol | 一级题号 | 0 | +| questionLevel2Symbol | 二级题号 | 1-99 | +| course | 科目 | 1:语文
2:数学
3:英语
4:政治
5:历史
6:地理
7:生物
8:物理
9化学 | +| questionType | 题目类型 | 1:单选
2:多选(排序)
3:数字
4:判断 | +| option | 选项数目 | 当questionType = 1 有效。
当questionType = 2 有效。
此项缺省时 默认4;
范围:1-10。| + +```json +{ + "fun": "continueKeyPadMultipleQuestionsLevel2Course", + "baseId": 0, + "params": { + "examNo": 1, + "questions": [{ + "questionLevel1Symbol": "0", + "questionLevel2Symbol": "1", + "course": "1", + "questionType": "1", + "option": "4" + }, { + "questionLevel1Symbol": "0", + "questionLevel2Symbol": "2", + "course": "2", + "questionType": "2", + "option": "4" + }, { + "questionLevel1Symbol": "0", + "questionLevel2Symbol": "3", + "course": "3", + "questionType": "3", + "option": "4" + }, { + "questionLevel1Symbol": "0", + "questionLevel2Symbol": "4", + "course": "4", + "questionType": "4", + "option": "4" + }] + }, + "packetTag": "59" +} +``` + +接收: + +fun: "KeyPadMultipleQuestionsLevel2Course" // +baseId: "1"//收到的基站ID +infos:{"state":"OK"}//返回状态,成功为OK + +指令样例: + +```json +{ + "fun": "KeyPadMultipleQuestionsLevel2Course", + "baseId": 1, + "infos": { + "state": "OK" + }, + "packetTag": "59" +} +``` + +##### 二级题型接口[有科目] + +发送: + +fun: "continueKeyPadMultipleQuestionsLevel2Course" //开始多题题型 +params:{} + +| **Json字段** | **字段含义** | **赋值及含义** | +| --- | --- | --- | +| examNo | 测验编号 | 1-9999 | +| questions | 题目详情 | 数组[最大200个单元] | + +题目详情数组参数说明 + +| **Json字段** | **字段含义** | **赋值及含义** | +| --- | --- | --- | +| questionLevel1Symbol | 一级题号 | 1-99 | +| questionLevel2Symbol | 二级题号 | 1-99 | +| course | 科目 | 1:语文
2:数学
3:英语
4:政治
5:历史
6:地理
7:生物
8:物理
9化学 | +| questionType | 题目类型 | 1:单选
2:多选(排序)
3:数字
4:判断 | +| option | 选项数目 | 当questionType = 1 有效。
当questionType = 2 有效。
此项缺省时 默认4;
范围:1-10。| + +```json +{ + "fun": "continueKeyPadMultipleQuestionsLevel2Course", + "baseId": 0, + "params": { + "examNo": 1, + "questions": [{ + "questionLevel1Symbol": "1", + "questionLevel2Symbol": "1", + "course": "1", + "questionType": "1", + "option": "4" + }, { + "questionLevel1Symbol": "1", + "questionLevel2Symbol": "2", + "course": "2", + "questionType": "2", + "option": "4" + }, { + "questionLevel1Symbol": "1", + "questionLevel2Symbol": "3", + "course": "3", + "questionType": "3", + "option": "4" + }, { + "questionLevel1Symbol": "1", + "questionLevel2Symbol": "4", + "course": "4", + "questionType": "4", + "option": "4" + }] + }, + "packetTag": "59" +} +``` + 接收: -fun: "pauseKeyPadMultipleQuestions" //暂停键盘测试 - +fun: "KeyPadMultipleQuestionsLevel2Course" // baseId: "1"//收到的基站ID - infos:{"state":"OK"}//返回状态,成功为OK 指令样例: ```json { - "fun": "pauseKeyPadMultipleQuestions", + "fun": "KeyPadMultipleQuestionsLevel2Course", "baseId": 1, "infos": { "state": "OK" }, - "packetTag": "1" + "packetTag": "59" } ``` -#### 继续测试 +##### 一级题型接口[无科目 + 题/Q开头] 发送: -fun: "continueKeyPadMultipleQuestions" //继续多题题型 +fun: "continueKeyPadMultipleQuestionsLevel1" //开始多题题型 params:{} -其中 displayMode 题号显示模式 有7中模式,分别对应7中显示题型的方式,用户可以根据需要自行选择 - -| **Json字段** | **字段含义** | **赋值及含义** | -| --- | --- | --- | -| displayMode | 题号显示模式 | 1: 在线测验 键盘一级题型 显示“Q”开头
2: 在线测验 键盘一级题型 显示“题”开头
3: 在线测验 键盘三级题型编号显示
4: 主观题得分输入
5: 在线作业 键盘一级题型 显示“Q”开头
6: 在线作业 键盘一级题型 显示“题”开头
7: 在线作业 键盘二级题型编号显示 | - -下面是7中模式的具体实现指令示例。 -
- -##### 在线测验 键盘一级题型 显示“Q”开头 指令说明 - | **Json字段** | **字段含义** | **赋值及含义** | | --- | --- | --- | | examNo | 测验编号 | 1-9999 | -| Total | 题目数量 | 1-200 | -| optional | 选项数目 |1-10 默认4 | -| displayMode | 题号显示模式 | 1: 在线测验 键盘一级题型 显示“Q”开头 | -| questions | 题目详情 | 数组 | +| displayMode | 题号显示模式 | 1: 显示“Q”开头
2: 显示“题”开头| +| questions | 题目详情 | 数组[最大200个单元] | 题目详情数组参数说明 | **Json字段** | **字段含义** | **赋值及含义** | | --- | --- | --- | -| questionLevel1Symbol | 一级题号 | 1-99 | +| questionLevel1Symbol | 一级题号 | 1-200 | | questionType | 题目类型 | 1:单选
2:多选(排序)
3:数字
4:判断 | -| option | 选项数目 | 默认是0
当questionType = 2 有效。
此项缺省时 optional 项值代替。| +| option | 选项数目 | 当questionType = 1 有效。
当questionType = 2 有效。
此项缺省时 默认4;
范围:1-10。| 指令样例: ```json { - "fun": "continueKeyPadMultipleQuestions", + "fun": "continueKeyPadMultipleQuestionsLevel1", "baseId": 0, "params": { - "examNo": 33, - "total": 4, - "optional": 4, + "examNo": 1, "displayMode": 1, "questions": [{ "questionLevel1Symbol": "1", @@ -2285,45 +2725,73 @@ params:{} } ``` -##### 在线测验 键盘一级题型 显示“题”开头 指令说明 +接收: + +fun: "KeyPadMultipleQuestionsLevel1" // +baseId: "1"//收到的基站ID +infos:{"state":"OK"}//返回状态,成功为OK + +指令样例: + +```json +{ + "fun": "KeyPadMultipleQuestionsLevel1", + "baseId": 1, + "infos": { + "state": "OK" + }, + "packetTag": "59" +} +``` + +##### 一级题型接口[无科目] + +发送: + +fun: "continueKeyPadMultipleQuestionsLevel3" //开始多题题型 +params:{} | **Json字段** | **字段含义** | **赋值及含义** | | --- | --- | --- | | examNo | 测验编号 | 1-9999 | -| Total | 题目数量 | 1-200 | -| optional | 选项数目 |1-10 默认4 | -| displayMode | 题号显示模式 | 2: 在线测验 键盘一级题型 显示“题”开头 | -| questions | 题目详情 | 数组 | +| questions | 题目详情 | 数组[最大200个单元] | 题目详情数组参数说明 | **Json字段** | **字段含义** | **赋值及含义** | | --- | --- | --- | -| questionLevel1Symbol | 一级题号 | 1-99 | +| questionLevel1Symbol | 一级题号 | 0 | +| questionLevel2Symbol | 二级题号 | 0 | +| questionLevel3Symbol | 三级题号 | 1-99 | | questionType | 题目类型 | 1:单选
2:多选(排序)
3:数字
4:判断 | -| option | 选项数目 | 默认是0
当questionType = 2 有效。
此项缺省时 optional 项值代替。| +| option | 选项数目 | 当questionType = 1 有效。
当questionType = 2 有效。
此项缺省时 默认4;
范围:1-10。| ```json { - "fun": "continueKeyPadMultipleQuestions", + "fun": "continueKeyPadMultipleQuestionsLevel3", "baseId": 0, "params": { - "examNo": 33, - "total": 4, - "optional": 4, - "displayMode": 2, + "examNo": 1, "questions": [{ - "questionLevel1Symbol": "1", + "questionLevel1Symbol": "0", + "questionLevel2Symbol": "0", + "questionLevel3Symbol": "1", "questionType": "1" }, { - "questionLevel1Symbol": "2", + "questionLevel1Symbol": "0", + "questionLevel2Symbol": "0", + "questionLevel3Symbol": "3", "questionType": "2", "option": "5" }, { - "questionLevel1Symbol": "3", + "questionLevel1Symbol": "0", + "questionLevel2Symbol": "0", + "questionLevel3Symbol": "4", "questionType": "3" }, { - "questionLevel1Symbol": "4", + "questionLevel1Symbol": "0", + "questionLevel2Symbol": "0", + "questionLevel3Symbol": "5", "questionType": "4" }] }, @@ -2331,53 +2799,71 @@ params:{} } ``` -##### 在线测验 键盘三级题型编号显示 指令说明 +接收: + +fun: "KeyPadMultipleQuestionsLevel3" // +baseId: "1"//收到的基站ID +infos:{"state":"OK"}//返回状态,成功为OK + +指令样例: + +```json +{ + "fun": "KeyPadMultipleQuestionsLevel3", + "baseId": 1, + "infos": { + "state": "OK" + }, + "packetTag": "59" +} +``` + +##### 二级题型接口[无科目] + +发送: + +fun: "continueKeyPadMultipleQuestionsLevel3" //开始多题题型 +params:{} | **Json字段** | **字段含义** | **赋值及含义** | | --- | --- | --- | | examNo | 测验编号 | 1-9999 | -| Total | 题目数量 | 1-200 | -| optional | 选项数目 |1-10 默认4 | -| displayMode | 题号显示模式 | 3: 在线测验 键盘三级题型编号显示 | -| questions | 题目详情 | 数组 | +| questions | 题目详情 | 数组[最大200个单元] | 题目详情数组参数说明 | **Json字段** | **字段含义** | **赋值及含义** | | --- | --- | --- | -| questionLevel1Symbol | 一级题号 | 1-99 | +| questionLevel1Symbol | 一级题号 | 0 | | questionLevel2Symbol | 二级题号 | 1-99 | | questionLevel3Symbol | 三级题号 | 1-99 | | questionType | 题目类型 | 1:单选
2:多选(排序)
3:数字
4:判断 | -| option | 选项数目 | 默认是0
当questionType = 2 有效。
此项缺省时 optional 项值代替。| +| option | 选项数目 | 当questionType = 1 有效。
当questionType = 2 有效。
此项缺省时 默认4;
范围:1-10。| ```json { - "fun": "continueKeyPadMultipleQuestions", + "fun": "continueKeyPadMultipleQuestionsLevel3", "baseId": 0, "params": { - "examNo": 33, - "total": 4, - "optional": 4, - "displayMode": 3, + "examNo": 1, "questions": [{ - "questionLevel1Symbol": "1", + "questionLevel1Symbol": "0", "questionLevel2Symbol": "1", "questionLevel3Symbol": "1", "questionType": "1" }, { - "questionLevel1Symbol": "1", + "questionLevel1Symbol": "0", "questionLevel2Symbol": "2", "questionLevel3Symbol": "3", "questionType": "2", "option": "5" }, { - "questionLevel1Symbol": "1", + "questionLevel1Symbol": "0", "questionLevel2Symbol": "2", "questionLevel3Symbol": "4", "questionType": "3" }, { - "questionLevel1Symbol": "1", + "questionLevel1Symbol": "0", "questionLevel2Symbol": "2", "questionLevel3Symbol": "5", "questionType": "4" @@ -2387,221 +2873,139 @@ params:{} } ``` -##### 主观题得分输入 指令说明 - -| **Json字段** | **字段含义** | **赋值及含义** | -| --- | --- | --- | -| examNo | 测验编号 | 1-9999 | -| Total | 题目数量 | 1-200 | -| optional | 选项数目 |1-10 默认4 | -| displayMode | 题号显示模式 | 4:主观题得分输入 | -| questions | 题目详情 | 数组 | +接收: -题目详情数组参数说明 +fun: "KeyPadMultipleQuestionsLevel3" // +baseId: "1"//收到的基站ID +infos:{"state":"OK"}//返回状态,成功为OK -| **Json字段** | **字段含义** | **赋值及含义** | -| --- | --- | --- | -| questionLevel1Symbol | 一级题号 | 1-99 | -| toplimit | 数字上限 | 1-100 | -| questionType | 题目类型 | 3:数字 | -| decimal | 小数位数 | 0:无效小数
1:一位小数
2:二位小数 [默认是2]
此项缺省时默认是0。| +指令样例: ```json { - "fun": "continueKeyPadMultipleQuestions", - "baseId": 0, - "params": { - "examNo": 33, - "total": 4, - "optional": 4, - "displayMode": 4, - "questions": [{ - "questionLevel1Symbol": "1", - "toplimit": "100", - "questionType": "3", - "decimal": "0" - }, { - "questionLevel1Symbol": "2", - "toplimit": "100", - "questionType": "3", - "decimal": "1" - }, { - "questionLevel1Symbol": "3", - "toplimit": "100", - "questionType": "3", - "decimal": "2" - }, { - "questionLevel1Symbol": "4", - "toplimit": "100", - "questionType": "3", - }] + "fun": "KeyPadMultipleQuestionsLevel3", + "baseId": 1, + "infos": { + "state": "OK" }, "packetTag": "59" } ``` -##### 在线作业 键盘一级题型 显示“Q”开头 指令说明 +##### 三级题型接口[无科目] + +发送: + +fun: "continueKeyPadMultipleQuestionsLevel3" //开始多题题型 +params:{} | **Json字段** | **字段含义** | **赋值及含义** | | --- | --- | --- | | examNo | 测验编号 | 1-9999 | -| Total | 题目数量 | 1-200 | -| optional | 选项数目 |1-10 默认4 | -| displayMode | 题号显示模式 | 5:在线作业 键盘一级题型 显示“Q”开头 | -| questions | 题目详情 | 数组 | +| questions | 题目详情 | 数组[最大200个单元] | 题目详情数组参数说明 | **Json字段** | **字段含义** | **赋值及含义** | | --- | --- | --- | | questionLevel1Symbol | 一级题号 | 1-99 | -| course | 科目 | 1:语文
2:数学
3:英语
4:政治
5:历史
6:地理
7:生物
8:物理
9:化学 | +| questionLevel2Symbol | 二级题号 | 1-99 | +| questionLevel3Symbol | 三级题号 | 1-99 | | questionType | 题目类型 | 1:单选
2:多选(排序)
3:数字
4:判断 | -| option | 选项数目 | 默认是0
当questionType = 2 有效。
此项缺省时 optional 项值代替。| +| option | 选项数目 | 当questionType = 1 有效。
当questionType = 2 有效。
此项缺省时 默认4;
范围:1-10。| ```json { - "fun": "continueKeyPadMultipleQuestions", + "fun": "continueKeyPadMultipleQuestionsLevel3", "baseId": 0, "params": { - "examNo": 33, - "total": 4, - "optional": 4, - "displayMode": 5, + "examNo": 1, "questions": [{ "questionLevel1Symbol": "1", - "course": "1", - "questionType": "1", - "option": "4" + "questionLevel2Symbol": "1", + "questionLevel3Symbol": "1", + "questionType": "1" }, { - "questionLevel1Symbol": "2", - "course": "2", + "questionLevel1Symbol": "1", + "questionLevel2Symbol": "2", + "questionLevel3Symbol": "3", "questionType": "2", - "option": "4" + "option": "5" }, { - "questionLevel1Symbol": "3", - "course": "3", - "questionType": "3", - "option": "4" + "questionLevel1Symbol": "1", + "questionLevel2Symbol": "2", + "questionLevel3Symbol": "4", + "questionType": "3" }, { - "questionLevel1Symbol": "4", - "course": "4", - "questionType": "4", - "option": "4" + "questionLevel1Symbol": "1", + "questionLevel2Symbol": "2", + "questionLevel3Symbol": "5", + "questionType": "4" }] }, "packetTag": "59" } ``` -##### 在线作业 键盘一级题型 显示“题”开头 指令说明 - -| **Json字段** | **字段含义** | **赋值及含义** | -| --- | --- | --- | -| examNo | 测验编号 | 1-9999 | -| Total | 题目数量 | 1-200 | -| optional | 选项数目 |1-10 默认4 | -| displayMode | 题号显示模式 | 6:在线作业 键盘一级题型 显示“题”开头 | -| questions | 题目详情 | 数组 | +接收: -题目详情数组参数说明 +fun: "KeyPadMultipleQuestionsLevel3" // +baseId: "1"//收到的基站ID +infos:{"state":"OK"}//返回状态,成功为OK -| **Json字段** | **字段含义** | **赋值及含义** | -| --- | --- | --- | -| questionLevel1Symbol | 一级题号 | 1-99 | -| course | 科目 | 1:语文
2:数学
3:英语
4:政治
5:历史
6:地理
7:生物
8:物理
9:化学 | -| questionType | 题目类型 | 1:单选
2:多选(排序)
3:数字
4:判断 | -| option | 选项数目 | 默认是0
当questionType = 2 有效。
此项缺省时 optional 项值代替。| +指令样例: ```json { - "fun": "continueKeyPadMultipleQuestions", - "baseId": 0, - "params": { - "examNo": 33, - "total": 4, - "optional": 4, - "displayMode": 6, - "questions": [{ - "questionLevel1Symbol": "1", - "course": "1", - "questionType": "1", - "option": "4" - }, { - "questionLevel1Symbol": "2", - "course": "2", - "questionType": "2", - "option": "4" - }, { - "questionLevel1Symbol": "3", - "course": "3", - "questionType": "3", - "option": "4" - }, { - "questionLevel1Symbol": "4", - "course": "4", - "questionType": "4", - "option": "4" - }] + "fun": "KeyPadMultipleQuestionsLevel3", + "baseId": 1, + "infos": { + "state": "OK" }, "packetTag": "59" } ``` -##### 在线作业 键盘二级题型编号显示 指令说明 +##### 主观题接口 +发送: + +fun: "continueKeyPadMultipleQuestionsSubjective" //开始多题题型 +params:{} | **Json字段** | **字段含义** | **赋值及含义** | | --- | --- | --- | | examNo | 测验编号 | 1-9999 | -| Total | 题目数量 | 1-200 | -| optional | 选项数目 |1-10 默认4 | -| displayMode | 题号显示模式 | 6:在线作业 键盘一级题型 显示“题”开头 | -| questions | 题目详情 | 数组 | +| questions | 题目详情 | 数组[最大200个单元] | 题目详情数组参数说明 | **Json字段** | **字段含义** | **赋值及含义** | | --- | --- | --- | -| questionLevel1Symbol | 一级题号 | 1-99 | -| questionLevel2Symbol | 二级题号 | 1-99 | -| course | 科目 | 1:语文
2:数学
3:英语
4:政治
5:历史
6:地理
7:生物
8:物理
9:化学 | -| questionType | 题目类型 | 1:单选
2:多选(排序)
3:数字
4:判断 | -| option | 选项数目 | 默认是0
当questionType = 2 有效。
此项缺省时 optional 项值代替。| - +| questionLevel1Symbol | 一级题号 | 1-200 | +| toplimit | 数字上限 | 1-100 | +| decimal | 小数位数 | 0:无效小数
1:一位小数
2:二位小数 [默认是2]
此项缺省时默认是0。| ```json { - "fun": "continueKeyPadMultipleQuestions", + "fun": "continueKeyPadMultipleQuestionsSubjective", "baseId": 0, "params": { - "examNo": 33, - "total": 4, - "optional": 4, - "displayMode": 6, + "examNo": 1, "questions": [{ "questionLevel1Symbol": "1", - "questionLevel2Symbol": "1", - "course": "1", - "questionType": "1", - "option": "4" + "toplimit": "100", + "decimal": "0" }, { - "questionLevel1Symbol": "1", - "questionLevel2Symbol": "2", - "course": "2", - "questionType": "2", - "option": "4" + "questionLevel1Symbol": "2", + "toplimit": "100", + "decimal": "1" }, { - "questionLevel1Symbol": "1", - "questionLevel2Symbol": "3", - "course": "3", - "questionType": "3", - "option": "4" + "questionLevel1Symbol": "3", + "toplimit": "100", + "decimal": "2" }, { - "questionLevel1Symbol": "1", - "questionLevel2Symbol": "4", - "course": "4", - "questionType": "4", - "option": "4" + "questionLevel1Symbol": "4", + "toplimit": "100" }] }, "packetTag": "59" @@ -2610,16 +3014,16 @@ params:{} 接收: -fun: "startKeyPadMultipleQuestions" //开始多题题型 -baseId: "1"//接收到指令的基站ID +fun: "KeyPadMultipleQuestionsSubjective" // +baseId: "1"//收到的基站ID infos:{"state":"OK"}//返回状态,成功为OK - 指令样例: + ```json { + "fun": "KeyPadMultipleQuestionsSubjective", "baseId": 1, - "fun": "startKeyPadMultipleQuestions", "infos": { "state": "OK" }, -- libgit2 0.21.4