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,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:{\"state\":\"OK\"}//返回状态,成功为OK | @@ -1456,130 +1419,111 @@ infos:{\"state\":\"OK\"}//返回状态,成功为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 | #### 开始测试 |