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,168 +1287,131 @@ infos:{"state":"OK"}//返回状态,成功为OK
1287 1287
1288 发送: 1288 发送:
1289 1289
1290 -fun: \"startNumber\" //开始数字题  
1291 - 1290 +fun: "startNumber" //开始数字题
1292 params:{} 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 infos: {} 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 params:{} //默认空 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,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 params:{} 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 infos: {} 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 params:{} //默认空 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 #### 开始测试