Commit 1626a5cb5a4ca118ace9071296d9d441ebf02be9
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:{\"state\":\"OK\"}//返回状态,成功为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 | #### 开始测试 | ... | ... |