1.SDK应用部分更新多题型接口。

DMchen
1 parent f213f5fc
Showing 1 changed file with 58 additions and 175 deletions
通讯协议-SDK应用部分.md
@@ -1744,32 +1744,20 @@ infos:{\&quot;state\&quot;:\&quot;OK\&quot;}//返回状态,成功为OK
   ----------------------- ----------------------- -----------------------
  
 ### 多题题型
-
 #### 开始测试
+##### 一级无科目接口
  
 发送：
  
-fun: "startKeyPadMultipleQuestions" //开始多题题型
-
+fun: "startKeyPadMultipleQuestionsLevel1" //开始多题题型
 params：{}
  
-其中 displayMode 题号显示模式 有7中模式，分别对应7中显示题型的方式，用户可以根据需要自行选择
-
-| **Json字段** | **字段含义** | **赋值及含义** |
-| --- | --- | --- |
-| displayMode | 题号显示模式 | 1: 在线测验 键盘一级题型 显示“Q”开头 <br>2: 在线测验 键盘一级题型 显示“题”开头 <br>3: 在线测验 键盘三级题型编号显示 <br>4: 主观题得分输入 <br>5: 在线作业 键盘一级题型 显示“Q”开头 <br>6: 在线作业 键盘一级题型 显示“题”开头 <br>7: 在线作业 键盘二级题型编号显示 |
-
-下面是7中模式的具体实现指令示例。
-<br>
-
-##### 在线测验 键盘一级题型 显示“Q”开头 指令说明
-
 | **Json字段** | **字段含义** | **赋值及含义** |
 | --- | --- | --- |
 | examNo | 测验编号 | 1-9999 |
 | Total | 题目数量 | 1-200 |
 | optional | 选项数目 |1-10 默认4  |
-| displayMode | 题号显示模式 | 1: 在线测验 键盘一级题型 显示“Q”开头 |
+| displayMode | 题号显示模式 | 1:  显示“Q”开头<br>2: 显示“题”开头|
 | questions | 题目详情 | 数组 |
  
 题目详情数组参数说明
@@ -1783,7 +1771,7 @@ params：{}
 指令样例：
 ```json
 {
-	"fun": "startKeyPadMultipleQuestions",
+	"fun": "startKeyPadMultipleQuestionsLevel1",
 	"baseId": 0,
 	"params": {
 		"examNo": 33,
@@ -1809,14 +1797,19 @@ params：{}
 }
 ```
  
-##### 在线测验 键盘一级题型 显示“题”开头 指令说明
+##### 一级有科目接口
+
+发送：
+
+fun: "startKeyPadMultipleQuestionsLevel1Course" //开始多题题型
+params：{}
  
 | **Json字段** | **字段含义** | **赋值及含义** |
 | --- | --- | --- |
 | examNo | 测验编号 | 1-9999 |
 | Total | 题目数量 | 1-200 |
 | optional | 选项数目 |1-10 默认4  |
-| displayMode | 题号显示模式 | 2: 在线测验 键盘一级题型 显示“题”开头 |
+| displayMode | 题号显示模式 | 1:  显示“Q”开头<br>2: 显示“题”开头|
 | questions | 题目详情 | 数组 |
  
 题目详情数组参数说明
@@ -1824,30 +1817,36 @@ params：{}
 | **Json字段** | **字段含义** | **赋值及含义** |
 | --- | --- | --- |
 | questionLevel1Symbol | 一级题号 | 1-99 |
+| course | 科目 | 1:语文<br>2:数学<br>3:英语<br>4:政治<br>5:历史<br>6:地理<br>7:生物<br>8:物理<br>9化学 |
 | questionType | 题目类型 | 1:单选<br>2:多选（排序）<br>3:数字<br>4:判断 |
 | option | 选项数目 | 默认是0<br>当questionType = 2 有效。<br>此项缺省时  optional 项值代替。|
  
+指令样例：
 ```json
 {
-	"fun": "startKeyPadMultipleQuestions",
+	"fun": "startKeyPadMultipleQuestionsLevel1Course",
 	"baseId": 0,
 	"params": {
 		"examNo": 33,
 		"total": 4,
 		"optional": 4,
-		"displayMode": 2,
+		"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"
 		}]
 	},
@@ -1855,14 +1854,18 @@ params：{}
 }
 ```
  
-##### 在线测验 键盘三级题型编号显示 指令说明
+##### 三级无科目接口
+
+发送：
+
+fun: "startKeyPadMultipleQuestionsLevel3" //开始多题题型
+params：{}
  
 | **Json字段** | **字段含义** | **赋值及含义** |
 | --- | --- | --- |
 | examNo | 测验编号 | 1-9999 |
 | Total | 题目数量 | 1-200 |
 | optional | 选项数目 |1-10 默认4  |
-| displayMode | 题号显示模式 | 3: 在线测验 键盘三级题型编号显示 |
 | questions | 题目详情 | 数组 |
  
 题目详情数组参数说明
@@ -1911,67 +1914,18 @@ params：{}
 }
 ```
  
-##### 主观题得分输入 指令说明
-
-| **Json字段** | **字段含义** | **赋值及含义** |
-| --- | --- | --- |
-| examNo | 测验编号 | 1-9999 |
-| Total | 题目数量 | 1-200 |
-| optional | 选项数目 |1-10 默认4  |
-| displayMode | 题号显示模式 | 4：主观题得分输入 |
-| questions | 题目详情 | 数组 |
-
-题目详情数组参数说明
-
-| **Json字段** | **字段含义** | **赋值及含义** |
-| --- | --- | --- |
-| questionLevel1Symbol | 一级题号 | 1-99 |
-| toplimit | 数字上限 | 1-100 |
-| questionType | 题目类型 | 3:数字 |
-| decimal | 小数位数 | 0:无效小数<br>1:一位小数<br>2:二位小数 [默认是2]<br>此项缺省时默认是0。|
+##### 二级有科目接口
  
-```json
-{
-	"fun": "startKeyPadMultipleQuestions",
-	"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",	
-		}]
-	},
-	"packetTag": "59"
-}
-```
+发送：
  
-##### 在线作业 键盘一级题型 显示“Q”开头 指令说明
+fun: "startKeyPadMultipleQuestionsLevel2Course" //开始多题题型
+params：{}
  
 | **Json字段** | **字段含义** | **赋值及含义** |
 | --- | --- | --- |
 | examNo | 测验编号 | 1-9999 |
 | Total | 题目数量 | 1-200 |
 | optional | 选项数目 |1-10 默认4  |
-| displayMode | 题号显示模式 | 5：在线作业 键盘一级题型 显示“Q”开头 |
 | questions | 题目详情 | 数组 |
  
 题目详情数组参数说明
@@ -1979,36 +1933,40 @@ params：{}
 | **Json字段** | **字段含义** | **赋值及含义** |
 | --- | --- | --- |
 | questionLevel1Symbol | 一级题号 | 1-99 |
+| questionLevel2Symbol | 二级题号 | 1-99 |
 | course | 科目 | 1:语文<br>2:数学<br>3:英语<br>4:政治<br>5:历史<br>6:地理<br>7:生物<br>8:物理<br>9化学 |
 | questionType | 题目类型 | 1:单选<br>2:多选（排序）<br>3:数字<br>4:判断 |
 | option | 选项数目 | 默认是0<br>当questionType = 2 有效。<br>此项缺省时  optional 项值代替。|
  
 ```json
 {
-	"fun": "startKeyPadMultipleQuestions",
+	"fun": "startKeyPadMultipleQuestionsLevel2Course",
 	"baseId": 0,
 	"params": {
 		"examNo": 33,
 		"total": 4,
 		"optional": 4,
-		"displayMode": 5,
 		"questions": [{
 			"questionLevel1Symbol": "1",
+			"questionLevel2Symbol": "1",
 			"course": "1",
 			"questionType": "1",
 			"option": "4"
 		}, {
-			"questionLevel1Symbol": "2",
+			"questionLevel1Symbol": "1",
+			"questionLevel2Symbol": "2",
 			"course": "2",
 			"questionType": "2",
 			"option": "4"
 		}, {
-			"questionLevel1Symbol": "3",
+			"questionLevel1Symbol": "1",
+			"questionLevel2Symbol": "3",
 			"course": "3",
 			"questionType": "3",
 			"option": "4"
 		}, {
-			"questionLevel1Symbol": "4",
+			"questionLevel1Symbol": "1",
+			"questionLevel2Symbol": "4",
 			"course": "4",
 			"questionType": "4",
 			"option": "4"
@@ -2018,14 +1976,17 @@ params：{}
 }
 ```
  
-##### 在线作业 键盘一级题型 显示“题”开头 指令说明
+##### 主观题接口
+发送：
+
+fun: "startKeyPadMultipleQuestionsSubjective" //开始多题题型
+params：{}
  
 | **Json字段** | **字段含义** | **赋值及含义** |
 | --- | --- | --- |
 | examNo | 测验编号 | 1-9999 |
 | Total | 题目数量 | 1-200 |
 | optional | 选项数目 |1-10 默认4  |
-| displayMode | 题号显示模式 | 6：在线作业 键盘一级题型 显示“题”开头 |
 | questions | 题目详情 | 数组 |
  
 题目详情数组参数说明
@@ -2033,123 +1994,45 @@ params：{}
 | **Json字段** | **字段含义** | **赋值及含义** |
 | --- | --- | --- |
 | questionLevel1Symbol | 一级题号 | 1-99 |
-| course | 科目 | 1:语文<br>2:数学<br>3:英语<br>4:政治<br>5:历史<br>6:地理<br>7:生物<br>8:物理<br>9化学 |
-| questionType | 题目类型 | 1:单选<br>2:多选（排序）<br>3:数字<br>4:判断 |
-| option | 选项数目 | 默认是0<br>当questionType = 2 有效。<br>此项缺省时  optional 项值代替。|
+| toplimit | 数字上限 | 1-100 |
+| questionType | 题目类型 | 3:数字 |
+| decimal | 小数位数 | 0:无效小数<br>1:一位小数<br>2:二位小数 [默认是2]<br>此项缺省时默认是0。|
  
 ```json
 {
-	"fun": "startKeyPadMultipleQuestions",
+	"fun": "startKeyPadMultipleQuestionsSubjective",
 	"baseId": 0,
 	"params": {
 		"examNo": 33,
 		"total": 4,
 		"optional": 4,
-		"displayMode": 6,
+		"displayMode": 4,
 		"questions": [{
 			"questionLevel1Symbol": "1",
-			"course": "1",
-			"questionType": "1",
-			"option": "4"
+			"toplimit": "100",
+			"questionType": "3",
+			"decimal": "0"
 		}, {
 			"questionLevel1Symbol": "2",
-			"course": "2",
-			"questionType": "2",
-			"option": "4"
+			"toplimit": "100",
+			"questionType": "3",
+			"decimal": "1"
 		}, {
 			"questionLevel1Symbol": "3",
-			"course": "3",
+			"toplimit": "100",
 			"questionType": "3",
-			"option": "4"
+			"decimal": "2"
 		}, {
 			"questionLevel1Symbol": "4",
-			"course": "4",
-			"questionType": "4",
-			"option": "4"
-		}]
-	},
-	"packetTag": "59"
-}
-```
-
-##### 在线作业 键盘二级题型编号显示 指令说明
-
-| **Json字段** | **字段含义** | **赋值及含义** |
-| --- | --- | --- |
-| examNo | 测验编号 | 1-9999 |
-| Total | 题目数量 | 1-200 |
-| optional | 选项数目 |1-10 默认4  |
-| displayMode | 题号显示模式 | 6：在线作业 键盘一级题型 显示“题”开头 |
-| questions | 题目详情 | 数组 |
-
-题目详情数组参数说明
-
-| **Json字段** | **字段含义** | **赋值及含义** |
-| --- | --- | --- |
-| questionLevel1Symbol | 一级题号 | 1-99 |
-| questionLevel2Symbol | 二级题号 | 1-99 |
-| course | 科目 | 1:语文<br>2:数学<br>3:英语<br>4:政治<br>5:历史<br>6:地理<br>7:生物<br>8:物理<br>9化学 |
-| questionType | 题目类型 | 1:单选<br>2:多选（排序）<br>3:数字<br>4:判断 |
-| option | 选项数目 | 默认是0<br>当questionType = 2 有效。<br>此项缺省时  optional 项值代替。|
-
-
-```json
-{
-	"fun": "startKeyPadMultipleQuestions",
-	"baseId": 0,
-	"params": {
-		"examNo": 33,
-		"total": 4,
-		"optional": 4,
-		"displayMode": 6,
-		"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"
+			"toplimit": "100",
+			"questionType": "3",	
 		}]
 	},
 	"packetTag": "59"
 }
 ```
  
-接收：
  
-fun: "startKeyPadMultipleQuestions" //开始多题题型
-baseId: "1"//接收到指令的基站ID
-infos:{"state":"OK"}//返回状态,成功为OK
-
-
-指令样例：
-```json
-{
-	"baseId": 1,
-	"fun": "startKeyPadMultipleQuestions",
-	"infos": {
-		"state": "OK"
-	},
-	"packetTag": "59"
-}
-```
  
 #### 接收作答