Commit 1626a5cb5a4ca118ace9071296d9d441ebf02be9

Authored by DMchen
1 parent bb7caf40

1.SDK应用部分 更新了 基站的连接、断开和复位、签到设备、选择题、判断题、多题快答、语音题、抢答题、数字题和键盘测试,这些接口。

Showing 1 changed file with 146 additions and 202 deletions
通讯协议-SDK应用部分.md
... ... @@ -1287,168 +1287,131 @@ infos:{"state":"OK"}//返回状态,成功为OK
1287 1287  
1288 1288 发送:
1289 1289  
1290   -fun: \"startNumber\" //开始数字题
1291   -
  1290 +fun: "startNumber" //开始数字题
1292 1291 params:{}
1293 1292  
1294   -+----------------+--------------+-------------------------------------+
1295   -| Json字段 | 字段含义 | 赋值及含义 |
1296   -+----------------+--------------+-------------------------------------+
1297   -| secrecyMode | 保密模式 | 0-不保密(默认值) |
1298   -| | | |
1299   -| | | 1-保密 |
1300   -+----------------+--------------+-------------------------------------+
1301   -| modifyMode | 修改模式 | 0-不可修改 |
1302   -| | | |
1303   -| | | 1-可以修改(默认值) |
1304   -+----------------+--------------+-------------------------------------+
1305   -| aswOption | 按键模式 | 0-无规则 (S6最多16位,T2最多14位) |
1306   -| | | |
1307   -| | | 1-预留 |
1308   -| | | |
1309   -| | | 2-预留 |
1310   -| | | |
1311   -| | | 3-带小数位上下限(T2不支持) |
1312   -+----------------+--------------+-------------------------------------+
1313   -| digits | 小数位数 | 0. 没有小数点 |
1314   -| | | |
1315   -| | | 1. 一位小数点 |
1316   -| | | |
1317   -| | | 2. 二位小数点 |
1318   -+----------------+--------------+-------------------------------------+
1319   -| numMin | 下限 | 0-655.35 |
1320   -+----------------+--------------+-------------------------------------+
1321   -| numMax | 上限 | 0-655.35 |
1322   -+----------------+--------------+-------------------------------------+
1323   -| tipTitle | 提示标题 | 16个字节 |
1324   -+----------------+--------------+-------------------------------------+
1325   -
1326   -指令样例:
1327   -
1328   -{\
1329   -    \"fun\":\"startNumber\",
1330   -
1331   - \"baseId\":0,\
1332   -    \"params\":{\
1333   -         \"secrecyMode\":\"0\",\
1334   -         \"modifyMode\":\"1\",
1335   -
1336   -\"aswOption\":\"0\",
  1293 +|Json字段|字段含义|赋值及含义|
  1294 +|---|---|---|
  1295 +|secrecyMode|保密模式|0-不保密(默认值)<br>1-保密|
  1296 +|modifyMode|修改模式|0-不可修改<br>1-可以修改(默认值)|
  1297 +|aswOption|按键模式|0-无规则 (S6最多16位,T2最多14位)<br>1-预留<br>2-预留<br>3-带小数位上下限(T2不支持)|
  1298 +|digits|小数位数|0.没有小数点<br>1.一位小数点<br>2.二位小数点|
  1299 +|numMin|下限|0-655.35|
  1300 +|numMax|上限|0-655.35|
  1301 +|tipTitle|提示标题|16个字节|
1337 1302  
1338   -\"digits\":\"0\",
1339 1303  
1340   -\"numMin\":\"0\",
1341 1304  
1342   -\"numMax\":\"0\"\
1343   -    },\
1344   -    \"packetTag\":\"1\"\
  1305 +指令样例:
  1306 +```json
  1307 +{
  1308 + "fun": "startNumber",
  1309 + "baseId": 0,
  1310 + "params": {
  1311 + "secrecyMode": "0",
  1312 + "modifyMode": "1",
  1313 + "aswOption": "0",
  1314 + "digits": "0",
  1315 + "numMin": "0",
  1316 + "numMax": "0"
  1317 + },
  1318 + "packetTag": "1"
1345 1319 }
  1320 +```
1346 1321  
1347 1322 接收:
1348 1323  
1349   -fun: \"startNumber\" //开始数字题
1350   -
1351   -baseId: \"1\"//接收到指令的基站ID
1352   -
1353   -infos:{\"state\":\"OK\"}//返回状态,成功为OK
  1324 +fun: "startNumber" //开始数字题
  1325 +baseId: "1"//接收到指令的基站ID
  1326 +infos:{"state":"OK"}//返回状态,成功为OK
1354 1327  
1355 1328 指令样例:
1356 1329  
1357   -{\
1358   -    \"fun\":\"startNumber\",
1359   -
1360   -\"baseId\":1,\
1361   -  \"infos\":{\
1362   -       \"state\":\"OK\"\
1363   -    },
1364   -
1365   -\"packetTag\":\"1\"\
  1330 +```json
  1331 +{
  1332 + "fun": "startNumber",
  1333 + "baseId": 1,
  1334 + "infos": {
  1335 + "state": "OK"
  1336 + },
  1337 + "packetTag": "1"
1366 1338 }
  1339 +```
1367 1340  
1368 1341 #### 接收作答
1369 1342  
1370 1343 接收:
1371 1344  
1372   -fun: \"answerNumber\" //数字题作答返回
1373   -
1374   -baseId: \"1\"//接收到指令的基站ID
1375   -
  1345 +fun: "answerNumber" //数字题作答返回
  1346 +baseId: "1"//接收到指令的基站ID
1376 1347 infos: {}
1377 1348  
1378   - ----------------- --------------- --------------------------------------
1379   - Json字段 字段含义 赋值及含义
1380   -
1381   - time 答题时间 单位秒
1382   -
1383   - keySn 键盘Sn
  1349 +|Json字段|字段含义|赋值及含义|
  1350 +|---|---|---|
  1351 +|time|答题时间|单位秒|
  1352 +|keySn|键盘Sn||
  1353 +|keyValue|键值|键盘提交的值|
1384 1354  
1385   - keyValue 键值 键盘提交的值
1386   - ----------------- --------------- --------------------------------------
1387 1355  
1388 1356 指令样例:
1389 1357  
1390   -{\
1391   -    \"fun\":\"answerNumber\",\
1392   -    \"baseId\":1,\
1393   -    \"infos\":{\
1394   -        \"time\":\"2.42\",\
1395   -        \"keySn\":\"1479824643\",\
1396   -        \"keyValue\":\"12\"\
1397   -    },
1398   -
1399   - \"packetTag\":\"1\"\
  1358 +```json
  1359 +{
  1360 + "fun": "answerNumber",
  1361 + "baseId": 1,
  1362 + "infos": {
  1363 + "time": "2.42",
  1364 + "keySn": "1479824643",
  1365 + "keyValue": "12"
  1366 + },
  1367 + "packetTag": "1"
1400 1368 }
  1369 +```
1401 1370  
1402 1371 #### 停止作答
1403 1372  
1404 1373 发送:
1405 1374  
1406   -fun: \"stopNumber\" //停止数字题
1407   -
  1375 +fun: "stopNumber" //停止数字题
1408 1376 params:{} //默认空
1409 1377  
1410 1378 指令样例:
1411 1379  
1412   -{\
1413   -    \"fun\":\"stopNumber\",
1414   -
1415   - \"baseId\":0,\
1416   -    \"packetTag\":\"1\"\
  1380 +```json
  1381 +{
  1382 + "fun": "stopNumber",
  1383 + "baseId": 0,
  1384 + "packetTag": "1"
1417 1385 }
  1386 +```
1418 1387  
1419 1388 接收:
1420 1389  
1421   -fun: \"stopNumber\" //停止数字题
1422   -
1423   -baseId: \"1\"//收到的基站ID
1424   -
1425   -infos:{\"state\":\"OK\"}//返回状态,成功为OK
  1390 +fun: "stopNumber" //停止数字题
  1391 +baseId: "1"//收到的基站ID
  1392 +infos:{"state":"OK"}//返回状态,成功为OK
1426 1393  
1427 1394 指令样例:
1428 1395  
1429   -{\
1430   -    \"fun\":\"stopNumber\",\
1431   -    \"baseId\":1,\
1432   -    \"infos\":{\
1433   -          \"state\":\"OK\"\
1434   -    },\
1435   -    \"packetTag\":\"1\"\
  1396 +```json
  1397 +{
  1398 + "fun": "stopNumber",
  1399 + "baseId": 1,
  1400 + "infos": {
  1401 + "state": "OK"
  1402 + },
  1403 + "packetTag": "1"
1436 1404 }
  1405 +```
1437 1406  
1438 1407 #### 支持设备说明
1439 1408  
1440   -+--------------------+--------------+---------------------------------+
1441   -| 基站+键盘 | 支持/不支持 | 备注 |
1442   -+--------------------+--------------+---------------------------------+
1443   -| B100-2.4G+S6 | 支持 | 按键模式(0-无规则 最多16位) |
1444   -+--------------------+--------------+---------------------------------+
1445   -| B200-2.4G+S6 | 支持 | 按键模式(0-无规则 最多16位) |
1446   -+--------------------+--------------+---------------------------------+
1447   -| B200-5.8G+T2 | 支持 | 按键模式(0-无规则 最多14位) |
1448   -| | | |
1449   -| | | 按键模 |
1450   -| | | 式(3-带小数位上下限)(不支持) |
1451   -+--------------------+--------------+---------------------------------+
  1409 +|基站+键盘|支持/不支持|备注|
  1410 +|---|---|---|
  1411 +|B100-2.4G+S6|支持|按键模式(0-无规则 最多16位)|
  1412 +|B200-2.4G+S6|支持|按键模式(0-无规则 最多16位)|
  1413 +|B200-5.8G+T2|支持|按键模式(0-无规则 最多14位)<br>按键模式 (3-带小数位上下限)(不支持)|
  1414 +
1452 1415  
1453 1416 ### 键盘测试
1454 1417  
... ... @@ -1456,130 +1419,111 @@ infos:{\&quot;state\&quot;:\&quot;OK\&quot;}//返回状态,成功为OK
1456 1419  
1457 1420 发送:
1458 1421  
1459   -fun: \"startKeyPadTest\" //开始键盘
1460   -
  1422 +fun: "startKeyPadTest" //开始键盘
1461 1423 params:{}
1462 1424  
1463   -+----------------+--------------+-------------------------------------+
1464   -| Json字段 | 字段含义 | 赋值及含义 |
1465   -+----------------+--------------+-------------------------------------+
1466   -| mode | 测试模式 | 1-报告状态 |
1467   -| | | |
1468   -| | | 2-按键模拟 |
1469   -+----------------+--------------+-------------------------------------+
1470   -| keyTime | 启动时间 | 0-60 单位秒 0马上执行 默认为0 |
1471   -+----------------+--------------+-------------------------------------+
1472   -| gapTime | 间隔时间 | 0-60 单位秒 0无效 默认为0 |
1473   -+----------------+--------------+-------------------------------------+
1474   -
1475   -指令样例:
  1425 +|Json字段|字段含义|赋值及含义|
  1426 +|---|---|---|
  1427 +|mode|测试模式|1-报告状态<br>2-按键模拟|
  1428 +|keyTime|启动时间|0-60 单位秒 0马上执行 默认为0|
  1429 +|gapTime|间隔时间|0-60 单位秒 0无效 默认为0|
1476 1430  
1477   -{\
1478   -    \"fun\":\"startKeyPadTest\",
1479 1431  
1480   -  \"baseId\":0,\
1481   -    \"params\":{\
1482   -        \"mode\":\"1\",\
1483   -        \"keyTime\":\"0\",
  1432 +指令样例:
1484 1433  
1485   -\"gapTime\":\"0\"\
1486   -    },\
1487   -    \"packetTag\":\"1\"\
  1434 +```json
  1435 +{
  1436 + "fun": "startKeyPadTest",
  1437 + "baseId": 0,
  1438 + "params": {
  1439 + "mode": "1",
  1440 + "keyTime": "0",
  1441 + "gapTime": "0"
  1442 + },
  1443 + "packetTag": "1"
1488 1444 }
  1445 +```
1489 1446  
1490 1447 #### 接收作答
1491 1448  
1492 1449 接收:
1493 1450  
1494   -fun: \"answerKeyPadTest\" //按键测试返回
1495   -
1496   -baseId: \"1\"//接收到指令的基站ID
1497   -
  1451 +fun: "answerKeyPadTest" //按键测试返回
  1452 +baseId: "1"//接收到指令的基站ID
1498 1453 infos: {}
1499 1454  
1500   - ----------------- --------------- --------------------------------------
1501   - Json字段 字段含义 赋值及含义
1502   -
1503   - Time 答题时间 单位秒
1504   -
1505   - keySn 键盘Sn
1506   -
1507   - hModel 键盘硬件型号
1508   -
1509   - keyValue 键值
1510   -
1511   - Ver 键盘软件版本
  1455 +|Json字段|字段含义|赋值及含义|
  1456 +|---|---|---|
  1457 +|Time|答题时间|单位秒|
  1458 +|keySn|键盘Sn||
  1459 +|hModel|键盘硬件型号||
  1460 +|keyValue|键盘键值||
  1461 +|ver|键盘软件版本||
  1462 +|volt|键盘电池电量|T2百分比值,S6无效|
1512 1463  
1513   - Volt 键盘电池电量 T2百分比值,S6无效
1514   - ----------------- --------------- --------------------------------------
1515 1464  
1516 1465 指令样例:
1517 1466  
1518   -{\
1519   -    \"fun\":\"answerKeyPadTest\",\
1520   -    \"baseId\":1,\
1521   -    \"infos\":{\
1522   -        \"time\":\"2.42\",
1523   -
1524   -  \"hModel\":\"67\",
1525   -
1526   - \"keyValue\":\"0\",
1527   -
1528   -  \"ver\":\"1.0.0\",\
1529   -        \"keySn\":\"1479824643\",\
1530   -        \"volt\":\"12\"\
1531   -    },
1532   -
1533   - \"packetTag\":\"1\"\
  1467 +```json
  1468 +{
  1469 + "fun": "answerKeyPadTest",
  1470 + "baseId": 1,
  1471 + "infos": {
  1472 + "time": "2.42",
  1473 + "keySn": "1479824643",
  1474 + "hModel": "67",
  1475 + "keyValue": "0",
  1476 + "ver": "1.0.0",
  1477 + "volt": "12"
  1478 + },
  1479 + "packetTag": "1"
1534 1480 }
  1481 +```
1535 1482  
1536 1483 #### 停止作答
1537 1484  
1538 1485 发送:
1539 1486  
1540   -fun: \"stopKeyPadTest\" //停止键盘测试
1541   -
  1487 +fun: "stopKeyPadTest" //停止键盘测试
1542 1488 params:{} //默认空
1543 1489  
1544 1490 指令样例:
1545 1491  
1546   -{\
1547   -    \"fun\":\"stopKeyPadTest\",
1548   -
1549   -\"baseId\":0,\
1550   -    \"packetTag\":\"1\"\
  1492 +```json
  1493 +{
  1494 + "fun": "stopKeyPadTest",
  1495 + "baseId": 0,
  1496 + "packetTag": "1"
1551 1497 }
  1498 +```
1552 1499  
1553 1500 接收:
1554 1501  
1555   -fun: \"stopKeyPadTest\" //停止键盘测试
1556   -
1557   -baseId: \"1\"//收到的基站ID
1558   -
1559   -infos:{\"state\":\"OK\"}//返回状态,成功为OK
  1502 +fun: "stopKeyPadTest" //停止键盘测试
  1503 +baseId: "1"//收到的基站ID
  1504 +infos:{"state":"OK"}//返回状态,成功为OK
1560 1505  
1561 1506 指令样例:
1562 1507  
1563   -{\
1564   -    \"fun\":\"stopKeyPadTest\",\
1565   -    \"baseId\":1,\
1566   -    \"infos\":{\
1567   -          \"state\":\"OK\"\
1568   -    },\
1569   -    \"packetTag\":\"1\"\
  1508 +```json
  1509 +{
  1510 + "fun": "stopKeyPadTest",
  1511 + "baseId": 1,
  1512 + "infos": {
  1513 + "state": "OK"
  1514 + },
  1515 + "packetTag": "1"
1570 1516 }
  1517 +```
1571 1518  
1572 1519 #### 支持设备说明
1573 1520  
1574   - ----------------------- ----------------------- -----------------------
1575   - 基站+键盘 支持/不支持 备注
1576   -
1577   - B100-2.4G+S6 支持 键盘电池电量参数无效
1578   -
1579   - B200-2.4G+S6 支持 键盘电池电量参数无效
  1521 +|基站+键盘|支持/不支持|备注|
  1522 +|---|---|---|
  1523 +|B100-2.4G+S6|支持|键盘电池电量参数无效|
  1524 +|B200-2.4G+S6|支持|键盘电池电量参数无效|
  1525 +|B200-5.8G+T2|支持||
1580 1526  
1581   - B200-5.8G+T2 支持
1582   - ----------------------- ----------------------- -----------------------
1583 1527  
1584 1528 ### 多题题型
1585 1529 #### 开始测试
... ...