李外 / Protocol

Commit 6bdf30bd1aef80ca8cf68d13a2e7007d40a5f6b8

Authored by DMchen
1 parent eb1166f1

1.SDK_DLL部分[内部] 启动业务增加样例。 

2.SDK应用部分[内部] 开始签到部分参数位置调整。
Inline Side-by-side
Showing 3 changed files with 730 additions and 121 deletions
img/image7.png 0 → 100644
View file @6bdf30b

7.41 KB
通讯协议-SDK_DLL部分[内部].md
  View file @6bdf30b
... ... @@ -302,29 +302,29 @@ HDParamCallBack 回调接口反馈数据解析：
302 302  
303 303 | **参数名称** | **参数说明** | **范围** | **备注** |
304 304 | --- | --- | --- | --- |
305   -|int Moed1|签到模式| 1:指定键签到 <br> 2:PIN码签到(默认值)||
306   -|int Moed2|修改模式|0:不可修改 <br>1:可以修改(默认值)||
307   -|int Moed3|迫选模式|0:(默认值）||
308   -|int Moed4|选项数目|10:(默认值）||
309   -|int Moed5|可选项数|1≤N≤14 (指定位数才需要设置)||
  305 +|int bindMode|签到模式| 1:指定键签到 <br> 2:PIN码签到(默认值)||
  306 +|int modifyMode|修改模式|0:不可修改 <br>1:可以修改(默认值)||
  307 +|int lessMode|迫选模式|0:(默认值）||
  308 +|int options|选项数目|10:(默认值）||
  309 +|int optionalN|可选位数|1≤N≤14 ||
310 310 |int KeyValue|指定按键键值|0:未指定[OK键签到] <br>1:1 <br>2:2 <br> 3:3 <br> 4:4 <br> 5:5 <br> 6:6 <br> 7:7 <br> 8:8 <br> 9:9 <br> 10:0 <br> 11:上键 <br> 12:下键 <br> 13:OK <br> 14:ESC <br> 15: Menu ||
311 311  
312 312 接口代码：
313 313 ```C++
314 314 extern"C" __declspec(dllexport) bool Start_Sign_in_Event(
315   - int Moed1 = 1,
316   - int Moed2 = 0,
317   - int Moed3 = 0,
318   - int Moed4 = 0,
319   - int Moed5 = 0,
320   - int KeyValue=0); //开始签到功能
321   -```
322   -#### 启动样例：
323   -目的：PIN签到模式，可以修改，可选项数6
  315 + int bindMode,
  316 + int modifyMode,
  317 + int lessMode,
  318 + int options,
  319 + int optionalN,
  320 + int KeyValue); //开始签到功能
  321 +```
  322 +#### 样例：
  323 +样例目的：PIN签到模式，可以修改，可选位数4位
324 324 ##### 启动功能部分：
325 325 ```C++
326 326 Set_Custom_Title(0, 3, "TXT"); //设置自定义标题
327   -Start_Sign_in_Event(2, 0, 0, 0, 6, 0); //开启pin模式签到
  327 +Start_Sign_in_Event(2, 0, 0, 0, 4, 0); //开启pin模式签到
328 328 ```
329 329 HDParamCallBack 回调接口反馈数据解析：
330 330  
... ... @@ -368,11 +368,11 @@ HDParamCallBack 回调接口反馈数据解析：
368 368 | --- | --- | --- | --- |
369 369 |UCHAR iBaseID|基站ID|0~32||
370 370 |ULONG KeySN|指定键盘SN|||
371   -|int Moed1|签到模式| 1:指定键签到 <br> 2:PIN码签到(默认值)||
372   -|int Moed2|修改模式|0:不可修改 <br>1:可以修改(默认值)||
373   -|int Moed3|迫选模式|0:(默认值）||
374   -|int Moed4|选项数目|10:(默认值）||
375   -|int Moed5|可选项数|1≤N≤14 (指定位数才需要设置)||
  371 +|int bindMode|签到模式| 1:指定键签到 <br> 2:PIN码签到(默认值)||
  372 +|int modifyMode|修改模式|0:不可修改 <br>1:可以修改(默认值)||
  373 +|int lessMode|迫选模式|0:(默认值）||
  374 +|int options|选项数目|10:(默认值）||
  375 +|int optionalN|可选位数|1≤N≤14 ||
376 376 |int KeyValue|指定按键键值|0:未指定[OK键签到] <br>1:1 <br>2:2 <br> 3:3 <br> 4:4 <br> 5:5 <br> 6:6 <br> 7:7 <br> 8:8 <br> 9:9 <br> 10:0 <br> 11:上键 <br> 12:下键 <br> 13:OK <br> 14:ESC <br> 15: Menu ||
377 377 |UCHAR Txt_Len|提示标题长度|1~16字节||
378 378 |const char* Txt|提示标题|字符串||
... ... @@ -382,22 +382,22 @@ HDParamCallBack 回调接口反馈数据解析：
382 382 extern"C" __declspec(dllexport) bool Start_Sign_in_Event_SN(
383 383 UCHAR iBaseID,
384 384 ULONG KeySN,
385   - int Moed1,
386   - int Moed2,
387   - int Moed3,
388   - int Moed4,
389   - int Moed5,
  385 + int bindMode,
  386 + int modifyMode,
  387 + int lessMode,
  388 + int options,
  389 + int optionalN,
390 390 int KeyValue,
391 391 UCHAR Txt_Len,
392 392 const char* Txt); //开始签到功能
393 393 ```
394 394  
395   -#### 启动样例：
396   -目的：PIN签到模式，可以修改，可选项数6
  395 +#### 样例：
  396 +样例目的：PIN签到模式，可以修改，可选项数6
397 397 ##### 启动功能部分：
398 398 ```C++
399 399 //指定键盘开启pin模式签到，带自定义标题
400   -Start_Sign_in_Event_SN(0,1837454011,2, 0, 0, 0, 6, 0, 3, "TXT");
  400 +Start_Sign_in_Event_SN(0,1837454011,2, 0, 0, 0, 4, 0, 3, "TXT");
401 401 ```
402 402 HDParamCallBack 回调接口反馈数据解析：
403 403  
... ... @@ -416,14 +416,14 @@ KeyEventCallBack 回调接口反馈数据解析：
416 416 |UCHAR iBaseID|基站ID|1||
417 417 |unsigned long long keySn|键盘SN|1837454011||
418 418 |float Time|反馈时间[秒]|0.5||
419   -|int mode|回调反馈数据模式|1||
  419 +|int mode|回调反馈数据模式|4||
420 420 |int RxMode|预留|0||
421 421 |const char* sInfo|回调反馈数据|"0,1001,0,0"|"预留,按键值,预留,预留"|
422 422  
423 423  
424 424 ##### 退出功能部分：
425 425 ```C++
426   -ExitEvent(1); //带签到模式切换到空闲模式
  426 +ExitEvent(1); //
427 427 ```
428 428 HDParamCallBack 回调接口反馈数据解析：
429 429  
... ... @@ -431,19 +431,19 @@ HDParamCallBack 回调接口反馈数据解析：
431 431 | --- | --- | --- | --- |
432 432 |int iBaseID|基站ID|1||
433 433 |int mode|模式|0||
434   -|const char* sInfo|参数字符串|"1,OK"|1：签到绑定带参数切换空闲模式成功|
435   -
  434 +|const char* sInfo|参数字符串|"41,OK"|1：签到模式切换空闲模式成功|
436 435  
437   -## 数字题功能[广播]
  436 +## 数字题
  437 +### 数字题功能[广播]
438 438 函数名称：Start_Number_Event
439 439 功能：数字题功能[广播]
440 440 说明：把SDK管理的所有基站的在线键盘设置为数字功能模式
441 441  
442 442 | **参数名称** | **参数说明** | **范围** | **备注** |
443 443 |---|---|---|---|
444   -|secrecyMode|保密模式|0:不保密(默认值)<br>1:保密||
445   -|modifyMode|修改模式|0:不可修改<br>1:可以修改(默认值)|
446 444 |aswOption|按键模式|0:无规则 （S6最多16位，T2最多14位）<br>1:预留<br>2:预留<br>3:带小数位上下限（T2不支持）|
  445 +|modifyMode|修改模式|0:不可修改<br>1:可以修改(默认值)|
  446 +|secrecyMode|保密模式|0:不保密(默认值)<br>1:保密||
447 447 |digits|小数位数|0:没有小数点<br>1:一位小数点<br>2:二位小数点|
448 448 |numMin|下限|aswOption=3<br>digits=0 范围：0~65535 <br> digits=1 范围：0~6553 <br> digits=2 范围：0~655|
449 449 |numMax|上限|aswOption=3<br>digits=0 范围：0~65535 <br> digits=1 范围：0~6553 <br> digits=2 范围：0~655|
... ... @@ -451,15 +451,56 @@ HDParamCallBack 回调接口反馈数据解析：
451 451 接口代码：
452 452 ```C++
453 453 extern"C" __declspec(dllexport) bool Start_Number_Event(
454   - int Moed1 = 1,
455   - int Moed2 = 0,
456   - int Moed3 = 0,
457   - int digits = 0,
458   - USHORT numMax = 0,
459   - USHORT numMin = 0); //
  454 + int aswOption,
  455 + int modifyMode,
  456 + int secrecyMode,
  457 + int digits,
  458 + USHORT numMax,
  459 + USHORT numMin); //
460 460 ```
461 461  
462   -## 数字题功能[指定键盘SN]
  462 +#### 样例：
  463 +样例目的：启动数字题，可以修改结果，两位小数，上限：655，下限：0
  464 +##### 启动功能部分：
  465 +```C++
  466 +Set_Custom_Title(0, 3, "TXT"); //设置自定义标题
  467 +Start_Number_Event(0, 0, 0, 2, 655, 0); //开启启动数字题
  468 +```
  469 +HDParamCallBack 回调接口反馈数据解析：
  470 +
  471 +| **参数名称** | **参数说明** | **解析** | **备注** |
  472 +| --- | --- | --- | --- |
  473 +|int iBaseID|基站ID|1||
  474 +|int mode|模式|916|数字题模式|
  475 +|const char* sInfo|参数字符串|"OK"|成功|
  476 +
  477 +##### 接收按键数据部分：
  478 +
  479 +KeyEventCallBack 回调接口反馈数据解析：
  480 +
  481 +| **参数名称** | **参数说明** | **数据值** | **备注** |
  482 +| --- | --- | --- | --- |
  483 +|UCHAR iBaseID|基站ID|1||
  484 +|unsigned long long keySn|键盘SN|1837454011||
  485 +|float Time|反馈时间[秒]|0.5||
  486 +|int mode|回调反馈数据模式|4||
  487 +|int RxMode|预留|0||
  488 +|const char* sInfo|回调反馈数据|"0,99.99,0,0"|"预留,按键值,预留,预留"|
  489 +
  490 +##### 退出功能部分：
  491 +```C++
  492 +ExitEvent(4); //带数字题模式切换到空闲模式
  493 +```
  494 +HDParamCallBack 回调接口反馈数据解析：
  495 +
  496 +| **参数名称** | **参数说明** | **解析** | **备注** |
  497 +| --- | --- | --- | --- |
  498 +|int iBaseID|基站ID|1||
  499 +|int mode|模式|0||
  500 +|const char* sInfo|参数字符串|"4,OK"|4：带数字题模式切换到空闲模式成功|
  501 +
  502 +
  503 +### 数字题功能[指定键盘SN]
463 504 函数名称：Start_Number_Event_SN
464 505 功能：数字题功能[指定键盘SN]
465 506 说明：把SDK管理的指定在线键盘设置为数字题功能模式
... ... @@ -492,7 +533,47 @@ extern&quot;C&quot; __declspec(dllexport) bool Start_Number_Event_SN(
492 533 const char* Txt); //
493 534 ```
494 535  
495   -## 判断题功能[广播]
  536 +#### 样例：
  537 +样例目的：启动数字题，可以修改结果，两位小数，上限：655，下限：0
  538 +##### 启动功能部分：
  539 +```C++
  540 +Start_Number_Event_SN(0,1837454011,0, 0, 0, 2, 655, 0, 3, "TXT"); //开启启动数字题
  541 +```
  542 +VoteEventCallBack 回调接口反馈数据解析：
  543 +
  544 +| **参数名称** | **参数说明** | **解析** | **备注** |
  545 +| --- | --- | --- | --- |
  546 +|int iBaseID|基站ID|1||
  547 +|int mode|模式|301:S6<br>302:T2||
  548 +|const char* sInfo|参数字符串|S6:"投票模式,键盘SN,结果,预留,预留" <br>T2:"投票模式,键盘SN,结果"||
  549 +
  550 +##### 接收按键数据部分：
  551 +
  552 +KeyEventCallBack 回调接口反馈数据解析：
  553 +
  554 +| **参数名称** | **参数说明** | **数据值** | **备注** |
  555 +| --- | --- | --- | --- |
  556 +|UCHAR iBaseID|基站ID|1||
  557 +|unsigned long long keySn|键盘SN|1837454011||
  558 +|float Time|反馈时间[秒]|0.5||
  559 +|int mode|回调反馈数据模式|1||
  560 +|int RxMode|预留|0||
  561 +|const char* sInfo|回调反馈数据|"0,99.99,0,0"|"预留,按键值,预留,预留"|
  562 +
  563 +##### 退出功能部分：
  564 +```C++
  565 +ExitEvent(4); //带数字题模式切换到空闲模式
  566 +```
  567 +HDParamCallBack 回调接口反馈数据解析：
  568 +
  569 +| **参数名称** | **参数说明** | **解析** | **备注** |
  570 +| --- | --- | --- | --- |
  571 +|int iBaseID|基站ID|1||
  572 +|int mode|模式|0||
  573 +|const char* sInfo|参数字符串|"4,OK"|4：带数字题模式切换到空闲模式成功|
  574 +
  575 +## 判断题
  576 +### 判断题功能[广播]
496 577 函数名称：Start_TrueFalse_Event
497 578 功能：判断题功能[广播]
498 579 说明：把SDK管理的所有基站的在线键盘设置为判断题功能模式
... ... @@ -500,8 +581,9 @@ extern&quot;C&quot; __declspec(dllexport) bool Start_Number_Event_SN(
500 581 | **参数名称** | **参数说明** | **范围** | **备注** |
501 582 |---|---|---|---|
502 583 | optionsMode | 选项类别 | 1:True/False 对/错 </br>2:Yes/No 是/否</br> 3:√/×|
503   -| secrecyMode | 保密模式 | 0:不保密(默认值) </br> 1:保密|
504 584 | modifyMode | 修改模式 | 0:不可修改</br>1:可以修改(默认值)|
  585 +| secrecyMode | 保密模式 | 0:不保密(默认值) </br> 1:保密|
  586 +
505 587  
506 588  
507 589 接口代码：
... ... @@ -512,7 +594,48 @@ extern&quot;C&quot; __declspec(dllexport) bool Start_TrueFalse_Event(
512 594 int Moed3 = 0);
513 595 ```
514 596  
515   -## 判断题功能[指定键盘SN]
  597 +#### 样例：
  598 +样例目的：启动判断题，可以修改结果
  599 +##### 启动功能部分：
  600 +```C++
  601 +Set_Custom_Title(0, 3, "TXT"); //设置自定义标题
  602 +Start_TrueFalse_Event(1, 1, 0); //开启启动判断题
  603 +```
  604 +HDParamCallBack 回调接口反馈数据解析：
  605 +
  606 +| **参数名称** | **参数说明** | **解析** | **备注** |
  607 +| --- | --- | --- | --- |
  608 +|int iBaseID|基站ID|1||
  609 +|int mode|模式|912|判断题模式|
  610 +|const char* sInfo|参数字符串|"OK"|成功|
  611 +
  612 +##### 接收按键数据部分：
  613 +
  614 +KeyEventCallBack 回调接口反馈数据解析：
  615 +
  616 +| **参数名称** | **参数说明** | **数据值** | **备注** |
  617 +| --- | --- | --- | --- |
  618 +|UCHAR iBaseID|基站ID|1||
  619 +|unsigned long long keySn|键盘SN|1837454011||
  620 +|float Time|反馈时间[秒]|0.5||
  621 +|int mode|回调反馈数据模式|5||
  622 +|int RxMode|预留|0||
  623 +|const char* sInfo|回调反馈数据|"0,1,0,0"|"预留,按键值,预留,预留"|
  624 +
  625 +##### 退出功能部分：
  626 +```C++
  627 +ExitEvent(5); //带判断题模式切换到空闲模式
  628 +```
  629 +HDParamCallBack 回调接口反馈数据解析：
  630 +
  631 +| **参数名称** | **参数说明** | **解析** | **备注** |
  632 +| --- | --- | --- | --- |
  633 +|int iBaseID|基站ID|1||
  634 +|int mode|模式|0||
  635 +|const char* sInfo|参数字符串|"5,OK"|5：带判断题模式切换到空闲模式成功|
  636 +
  637 +
  638 +### 判断题功能[指定键盘SN]
516 639 函数名称：Start_TrueFalse_Event_SN
517 640 功能：判断题功能[指定键盘SN]
518 641 说明：把SDK管理的指定在线键盘设置为判断题功能模式
... ... @@ -522,24 +645,65 @@ extern&quot;C&quot; __declspec(dllexport) bool Start_TrueFalse_Event(
522 645 |UCHAR iBaseID|基站ID|0~32||
523 646 |ULONG KeySN|指定键盘SN|||
524 647 | optionsMode | 选项类别 | 1:True/False 对/错 </br>2:Yes/No 是/否</br> 3:√/×|
525   -| secrecyMode | 保密模式 | 0:不保密(默认值) </br> 1:保密|
526 648 | modifyMode | 修改模式 | 0:不可修改</br>1:可以修改(默认值)|
  649 +| secrecyMode | 保密模式 | 0:不保密(默认值) </br> 1:保密|
527 650 |UCHAR Txt_Len|提示标题长度|1~16字节||
528 651 |Txt|提示标题|字符串，长度最多不超过16个字节|
529 652  
530 653 接口代码：
531 654 ```C++
532   -extern"C" __declspec(dllexport) bool T2_Start_TrueFalse_Event(
  655 +extern"C" __declspec(dllexport) bool Start_TrueFalse_Event_SN(
533 656 UCHAR iBaseID,
534 657 ULONG KeySN,
535   - int Moed1,
536   - int Moed2,
537   - int Moed3,
  658 + int optionsMode,
  659 + int modifyMode,
  660 + int secrecyMode,
538 661 UCHAR Txt_Len,
539 662 const char* Txt); //
540 663 ```
541 664  
542   -## 选择题功能[广播]
  665 +#### 样例：
  666 +样例目的：启动判断题，可以修改结果
  667 +##### 启动功能部分：
  668 +```C++
  669 +Start_TrueFalse_Event_SN(0,1837454011,1, 1, 0, 3, "TXT"); //开启启动判断题
  670 +```
  671 +VoteEventCallBack 回调接口反馈数据解析：
  672 +
  673 +| **参数名称** | **参数说明** | **解析** | **备注** |
  674 +| --- | --- | --- | --- |
  675 +|int iBaseID|基站ID|1||
  676 +|int mode|模式|301:S6<br>302:T2||
  677 +|const char* sInfo|参数字符串|S6:"投票模式,键盘SN,结果,预留,预留" <br>T2:"投票模式,键盘SN,结果"||
  678 +
  679 +##### 接收按键数据部分：
  680 +
  681 +KeyEventCallBack 回调接口反馈数据解析：
  682 +
  683 +| **参数名称** | **参数说明** | **数据值** | **备注** |
  684 +| --- | --- | --- | --- |
  685 +|UCHAR iBaseID|基站ID|1||
  686 +|unsigned long long keySn|键盘SN|1837454011||
  687 +|float Time|反馈时间[秒]|0.5||
  688 +|int mode|回调反馈数据模式|5||
  689 +|int RxMode|预留|0||
  690 +|const char* sInfo|回调反馈数据|"0,1,0,0"|"预留,按键值,预留,预留"|
  691 +
  692 +##### 退出功能部分：
  693 +```C++
  694 +ExitEvent(5); //带判断题模式切换到空闲模式
  695 +```
  696 +HDParamCallBack 回调接口反馈数据解析：
  697 +
  698 +| **参数名称** | **参数说明** | **解析** | **备注** |
  699 +| --- | --- | --- | --- |
  700 +|int iBaseID|基站ID|1||
  701 +|int mode|模式|0||
  702 +|const char* sInfo|参数字符串|"5,OK"|5：带判断题模式切换到空闲模式成功|
  703 +
  704 +
  705 +## 选择题
  706 +### 选择题功能[广播]
543 707 函数名称：Start_TrueFalse_Event
544 708 功能：选择题功能[广播]
545 709 说明：把SDK管理的所有基站的在线键盘设置为选择题功能模式
... ... @@ -547,8 +711,8 @@ extern&quot;C&quot; __declspec(dllexport) bool T2_Start_TrueFalse_Event(
547 711 | **参数名称** | **参数说明** | **范围** | **备注** |
548 712 |---|---|---|---|
549 713 |optionsMode|选项类别|1:显示字母(默认值) </br>2:显示数字 |
550   -|secrecyMode|保密模式|0:不保密(默认值)</br>1:保密 |
551 714 |modifyMode|修改模式|0:不可修改 </br>1:可以修改(默认值) |
  715 +|secrecyMode|保密模式|0:不保密(默认值)</br>1:保密 |
552 716 |lessMode|迫选模式| 0:可缺选(默认值) </br>1:不可缺选</br>2:允许重复输入</br>3:允许重复输入且不可缺选 |
553 717 | options|选项数目|1≤M≤10(默认值4)|
554 718 | optionalN|可选项数|1≤N≤M(默认值1)|
... ... @@ -557,15 +721,55 @@ extern&quot;C&quot; __declspec(dllexport) bool T2_Start_TrueFalse_Event(
557 721 接口代码：
558 722 ```C++
559 723 extern"C" __declspec(dllexport) bool Start_Choice_Event(
560   - int Moed1 = 1,
561   - int Moed2 = 0,
562   - int Moed3 = 0,
563   - int Moed4 = 0,
564   - int Moed5 = 0,
565   - int Moed6 = 0);
  724 + int optionsMode,
  725 + int modifyMode,
  726 + int secrecyMode,
  727 + int lessMode,
  728 + int options,
  729 + int optionalN);
566 730 ```
567 731  
568   -## 选择题功能[指定键盘SN]
  732 +#### 样例：
  733 +样例目的：启动选择题，字母类型，4选1，可以修改结果
  734 +##### 启动功能部分：
  735 +```C++
  736 +Set_Custom_Title(0, 3, "TXT"); //设置自定义标题
  737 +Start_Choice_Event(1, 1, 0，0, 4, 1); //开启启动选择题
  738 +```
  739 +HDParamCallBack 回调接口反馈数据解析：
  740 +
  741 +| **参数名称** | **参数说明** | **解析** | **备注** |
  742 +| --- | --- | --- | --- |
  743 +|int iBaseID|基站ID|1||
  744 +|int mode|模式|910|选择题模式|
  745 +|const char* sInfo|参数字符串|"OK"|成功|
  746 +
  747 +##### 接收按键数据部分：
  748 +
  749 +KeyEventCallBack 回调接口反馈数据解析：
  750 +
  751 +| **参数名称** | **参数说明** | **数据值** | **备注** |
  752 +| --- | --- | --- | --- |
  753 +|UCHAR iBaseID|基站ID|1||
  754 +|unsigned long long keySn|键盘SN|1837454011||
  755 +|float Time|反馈时间[秒]|0.5||
  756 +|int mode|回调反馈数据模式|10||
  757 +|int RxMode|预留|0||
  758 +|const char* sInfo|回调反馈数据|"0,A,0,0"|"预留,按键值,预留,预留"|
  759 +
  760 +##### 退出功能部分：
  761 +```C++
  762 +ExitEvent(10); //带判断题模式切换到空闲模式
  763 +```
  764 +HDParamCallBack 回调接口反馈数据解析：
  765 +
  766 +| **参数名称** | **参数说明** | **解析** | **备注** |
  767 +| --- | --- | --- | --- |
  768 +|int iBaseID|基站ID|1||
  769 +|int mode|模式|0||
  770 +|const char* sInfo|参数字符串|"5,OK"|5：带判断题模式切换到空闲模式成功|
  771 +
  772 +### 选择题功能[指定键盘SN]
569 773 函数名称：Start_Choice_Event_SN
570 774 功能：选择题功能[指定键盘SN]
571 775 说明：把SDK管理的指定在线键盘设置为选择题功能模式
... ... @@ -588,17 +792,58 @@ extern&quot;C&quot; __declspec(dllexport) bool Start_Choice_Event(
588 792 extern"C" __declspec(dllexport) bool Start_Choice_Event_SN(
589 793 UCHAR iBaseID,
590 794 ULONG KeySN,
591   - int Moed1,
592   - int Moed2,
593   - int Moed3,
594   - int Moed4,
595   - int Moed5,
596   - int Moed6,
  795 + int optionsMode,
  796 + int modifyMode,
  797 + int secrecyMode,
  798 + int lessMode,
  799 + int options,
  800 + int optionalN,
597 801 UCHAR Txt_Len,
598 802 const char* Txt);
599 803 ```
600 804  
601   -## 语音题功能[广播]
  805 +#### 样例：
  806 +样例目的：启动选择题，字母类型，4选1，可以修改结果
  807 +##### 启动功能部分：
  808 +```C++
  809 +Start_Choice_Event_SN(0,1837454011, 1, 1, 0，0, 4, 1, 3, "TXT"); //开启启动判断题
  810 +```
  811 +VoteEventCallBack 回调接口反馈数据解析：
  812 +
  813 +| **参数名称** | **参数说明** | **解析** | **备注** |
  814 +| --- | --- | --- | --- |
  815 +|int iBaseID|基站ID|1||
  816 +|int mode|模式|301:S6<br>302:T2||
  817 +|const char* sInfo|参数字符串|S6:"投票模式,键盘SN,结果,预留,预留" <br>T2:"投票模式,键盘SN,结果"||
  818 +
  819 +##### 接收按键数据部分：
  820 +
  821 +KeyEventCallBack 回调接口反馈数据解析：
  822 +
  823 +| **参数名称** | **参数说明** | **数据值** | **备注** |
  824 +| --- | --- | --- | --- |
  825 +|UCHAR iBaseID|基站ID|1||
  826 +|unsigned long long keySn|键盘SN|1837454011||
  827 +|float Time|反馈时间[秒]|0.5||
  828 +|int mode|回调反馈数据模式|10||
  829 +|int RxMode|预留|0||
  830 +|const char* sInfo|回调反馈数据|"0,A,0,0"|"预留,按键值,预留,预留"|
  831 +
  832 +##### 退出功能部分：
  833 +```C++
  834 +ExitEvent(10); //带选择题模式切换到空闲模式
  835 +```
  836 +HDParamCallBack 回调接口反馈数据解析：
  837 +
  838 +| **参数名称** | **参数说明** | **解析** | **备注** |
  839 +| --- | --- | --- | --- |
  840 +|int iBaseID|基站ID|1||
  841 +|int mode|模式|0||
  842 +|const char* sInfo|参数字符串|"10,OK"|10：带选择题模式切换到空闲模式成功|
  843 +
  844 +
  845 +## 语音题
  846 +### 语音题功能[广播]
602 847 函数名称：Start_Voice_Event
603 848 功能：语音题功能[广播]
604 849 说明：把SDK管理的所有基站的在线键盘设置为语音题功能模式
... ... @@ -622,7 +867,52 @@ extern&quot;C&quot; __declspec(dllexport) bool Start_Voice_Event(
622 867 int OutMode);
623 868 ```
624 869  
625   -## 语音题功能[指定键盘SN]
  870 +#### 样例：
  871 +样例目的：启动语音题，mp3格式
  872 +##### 启动功能部分：
  873 +```C++
  874 +Set_Custom_Title(0, 3, "TXT"); //设置自定义标题
  875 +Start_Voice_Event(0, 0, 0，0); //开启启动语音题
  876 +```
  877 +HDParamCallBack 回调接口反馈数据解析：
  878 +
  879 +| **参数名称** | **参数说明** | **解析** | **备注** |
  880 +| --- | --- | --- | --- |
  881 +|int iBaseID|基站ID|1||
  882 +|int mode|模式|922|语音题模式|
  883 +|const char* sInfo|参数字符串|"OK"|成功|
  884 +
  885 +##### 接收按键数据部分：
  886 +
  887 +VoiceStreamEventCallBackFunc 回调接口反馈数据解析：
  888 +
  889 +| **参数名称** | **参数说明** | **数据值** | **备注** |
  890 +| --- | --- | --- | --- |
  891 +|UCHAR iBaseID|基站ID|1||
  892 +|unsigned long keySn|键盘SN|1837454011||
  893 +|int Mode|反馈数据模式|0:mp3(默认值)<br>1:实时流||
  894 +|USHORT voiceId|回话ID|答题时间内，可重复提交语音，每段语音流加一个回话ID，用于区分作答||
  895 +|USHORT dataIndex|数据包号|1开始||
  896 +|const char* data|回调反馈数据|Mode=0：反馈的是MP3文件路径 <br> Mode=1：反馈的是实时数据流||
  897 +|int len|数据长度|Base64编码后的字符串长度。应该将 "data" 通过Base64解码后得到原始的数据长度。||
  898 +|int sampleRate|音频采样率|16000||
  899 +|int bitsPerSample|音频采样精度|16||
  900 +|int channel|声道数|1|单声道|
  901 +|int recFlag|结束标志|默认为0，为1表示结束||
  902 +
  903 +##### 退出功能部分：
  904 +```C++
  905 +ExitEvent(16); //带语音题模式切换到空闲模式
  906 +```
  907 +HDParamCallBack 回调接口反馈数据解析：
  908 +
  909 +| **参数名称** | **参数说明** | **解析** | **备注** |
  910 +| --- | --- | --- | --- |
  911 +|int iBaseID|基站ID|1||
  912 +|int mode|模式|0||
  913 +|const char* sInfo|参数字符串|"16,OK"|16：带语音题模式切换到空闲模式成功|
  914 +
  915 +### 语音题功能[指定键盘SN]
626 916 函数名称：Start_Voice_Event_SN
627 917 功能：语音题功能[指定键盘SN]
628 918 说明：把SDK管理的指定在线键盘设置为语音题功能模式
... ... @@ -653,7 +943,52 @@ extern&quot;C&quot; __declspec(dllexport) bool Start_Voice_Event_SN(
653 943 const char* Txt);//
654 944 ```
655 945  
656   -## 自由题功能
  946 +#### 样例：
  947 +样例目的：启动语音题，mp3格式
  948 +##### 启动功能部分：
  949 +```C++
  950 +Start_Voice_Event_SN(0,1837454011, 0, 0, 0，0, 3, "TXT"); //开启启动语音题
  951 +```
  952 +VoteEventCallBack 回调接口反馈数据解析：
  953 +
  954 +| **参数名称** | **参数说明** | **解析** | **备注** |
  955 +| --- | --- | --- | --- |
  956 +|int iBaseID|基站ID|1||
  957 +|int mode|模式|301:S6<br>302:T2||
  958 +|const char* sInfo|参数字符串|S6:"投票模式,键盘SN,结果,预留,预留" <br>T2:"投票模式,键盘SN,结果"||
  959 +
  960 +##### 接收按键数据部分：
  961 +
  962 +VoiceStreamEventCallBackFunc 回调接口反馈数据解析：
  963 +
  964 +| **参数名称** | **参数说明** | **数据值** | **备注** |
  965 +| --- | --- | --- | --- |
  966 +|UCHAR iBaseID|基站ID|1||
  967 +|unsigned long keySn|键盘SN|1837454011||
  968 +|int Mode|反馈数据模式|0:mp3(默认值)<br>1:实时流||
  969 +|USHORT voiceId|回话ID|答题时间内，可重复提交语音，每段语音流加一个回话ID，用于区分作答||
  970 +|USHORT dataIndex|数据包号|1开始||
  971 +|const char* data|回调反馈数据|Mode=0：反馈的是MP3文件路径 <br> Mode=1：反馈的是实时数据流||
  972 +|int len|数据长度|Base64编码后的字符串长度。应该将 "data" 通过Base64解码后得到原始的数据长度。||
  973 +|int sampleRate|音频采样率|16000||
  974 +|int bitsPerSample|音频采样精度|16||
  975 +|int channel|声道数|1|单声道|
  976 +|int recFlag|结束标志|默认为0，为1表示结束||
  977 +
  978 +##### 退出功能部分：
  979 +```C++
  980 +ExitEvent(16); //带语音题模式切换到空闲模式
  981 +```
  982 +HDParamCallBack 回调接口反馈数据解析：
  983 +
  984 +| **参数名称** | **参数说明** | **解析** | **备注** |
  985 +| --- | --- | --- | --- |
  986 +|int iBaseID|基站ID|1||
  987 +|int mode|模式|0||
  988 +|const char* sInfo|参数字符串|"16,OK"|16：带语音题模式切换到空闲模式成功|
  989 +
  990 +## 自由题
  991 +### 自由题功能
657 992 函数名称：Start_Free_Question_Event
658 993 功能：自由题功能
659 994 说明：把SDK管理的所有基站的在线键盘设置为自由题功能模式
... ... @@ -661,7 +996,7 @@ extern&quot;C&quot; __declspec(dllexport) bool Start_Voice_Event_SN(
661 996 | **参数名称** | **参数说明** | **范围** | **备注** |
662 997 |---|---|---|---|
663 998 |UCHAR iBaseID|基站ID|0~32||
664   -|ULONG KeySN|指定键盘SN|||
  999 +|ULONG KeySN|指定键盘SN|0：默认值||
665 1000  
666 1001  
667 1002 接口代码：
... ... @@ -670,8 +1005,47 @@ extern&quot;C&quot; __declspec(dllexport) bool Start_Free_Question_Event(
670 1005 UCHAR iBaseID,
671 1006 ULONG KeySN);
672 1007 ```
  1008 +#### 样例：
  1009 +样例目的：启动自由题
  1010 +##### 启动功能部分：
  1011 +```C++
  1012 +Start_Free_Question_Event(0,0); //开启启动自由题
  1013 +```
  1014 +HDParamCallBack 回调接口反馈数据解析：
  1015 +
  1016 +| **参数名称** | **参数说明** | **解析** | **备注** |
  1017 +| --- | --- | --- | --- |
  1018 +|int iBaseID|基站ID|1||
  1019 +|int mode|模式|943|自由题模式|
  1020 +|const char* sInfo|参数字符串|"OK"|成功|
673 1021  
674   -## 抢答题功能
  1022 +##### 接收按键数据部分：
  1023 +
  1024 +KeyEventCallBack 回调接口反馈数据解析：
  1025 +
  1026 +| **参数名称** | **参数说明** | **数据值** | **备注** |
  1027 +| --- | --- | --- | --- |
  1028 +|UCHAR iBaseID|基站ID|1||
  1029 +|unsigned long long keySn|键盘SN|1837454011||
  1030 +|float Time|反馈时间[秒]|0.5||
  1031 +|int mode|回调反馈数据模式|10||
  1032 +|int RxMode|预留|0||
  1033 +|const char* sInfo|回调反馈数据|"0,A,0,0"|"预留,按键值,预留,预留"|
  1034 +
  1035 +##### 退出功能部分：
  1036 +```C++
  1037 +ExitEvent(10); //带自由题模式切换到空闲模式
  1038 +```
  1039 +HDParamCallBack 回调接口反馈数据解析：
  1040 +
  1041 +| **参数名称** | **参数说明** | **解析** | **备注** |
  1042 +| --- | --- | --- | --- |
  1043 +|int iBaseID|基站ID|1||
  1044 +|int mode|模式|0||
  1045 +|const char* sInfo|参数字符串|"10,OK"|10：带自由题模式切换到空闲模式成功|
  1046 +
  1047 +## 抢答题
  1048 +### 抢答题功能
675 1049  
676 1050 函数名称：Start_Rush_Answer_Event
677 1051 功能：抢答题功能
... ... @@ -679,20 +1053,58 @@ extern&quot;C&quot; __declspec(dllexport) bool Start_Free_Question_Event(
679 1053  
680 1054 | **参数名称** | **参数说明** | **范围** | **备注** |
681 1055 |---|---|---|---|
682   -|rushAnswerMode| 抢答模式|0:普通抢答(默认值)|
683   -|Moed2| 预留|0:(默认值)|
684   -|modifyMode|修改模式|0:不可修改<br>1:可以修改(默认值)|
  1056 +|int rushAnswerMode| 抢答模式|0:普通抢答(默认值)|
  1057 +|int Moed2| 预留|0:(默认值)|
  1058 +|int modifyMode|修改模式|0:不可修改<br>1:可以修改(默认值)|
685 1059  
686 1060  
687 1061 接口代码：
688 1062 ```C++
689 1063 extern"C" __declspec(dllexport) bool Start_Rush_Answer_Event(
690   - int Moed1 = 1,
691   - int Moed2 = 0,
692   - int Moed3 = 0); //抢答
  1064 + int intrushAnswerMode,
  1065 + int Moed2,
  1066 + int modifyMode); //抢答
  1067 +```
  1068 +#### 样例：
  1069 +样例目的：启动抢答题
  1070 +##### 启动功能部分：
  1071 +```C++
  1072 +Start_Rush_Answer_Event(0, 0, 0); //开启抢答题
  1073 +```
  1074 +HDParamCallBack 回调接口反馈数据解析：
  1075 +
  1076 +| **参数名称** | **参数说明** | **解析** | **备注** |
  1077 +| --- | --- | --- | --- |
  1078 +|int iBaseID|基站ID|1||
  1079 +|int mode|模式|914|抢答题模式|
  1080 +|const char* sInfo|参数字符串|"OK"|成功|
  1081 +
  1082 +##### 接收按键数据部分：
  1083 +
  1084 +KeyEventCallBack 回调接口反馈数据解析：
  1085 +
  1086 +| **参数名称** | **参数说明** | **数据值** | **备注** |
  1087 +| --- | --- | --- | --- |
  1088 +|UCHAR iBaseID|基站ID|1||
  1089 +|unsigned long long keySn|键盘SN|1837454011||
  1090 +|float Time|反馈时间[秒]|0.5||
  1091 +|int mode|回调反馈数据模式|13||
  1092 +|int RxMode|预留|0||
  1093 +|const char* sInfo|回调反馈数据|"0,1,0,0"|"预留,按键值,预留,预留"|
  1094 +
  1095 +##### 退出功能部分：
  1096 +```C++
  1097 +ExitEvent(13); //带选择题模式切换到空闲模式
693 1098 ```
  1099 +HDParamCallBack 回调接口反馈数据解析：
  1100 +
  1101 +| **参数名称** | **参数说明** | **解析** | **备注** |
  1102 +| --- | --- | --- | --- |
  1103 +|int iBaseID|基站ID|1||
  1104 +|int mode|模式|0||
  1105 +|const char* sInfo|参数字符串|"13,OK"|13：带抢答题模式切换到空闲模式成功|
694 1106  
695   -## 抢答题功能[指定键盘SN]
  1107 +### 抢答题功能[指定键盘SN]
696 1108 函数名称：Start_Rush_Answer_Event_SN
697 1109 功能：抢答题功能[指定键盘SN]
698 1110 说明：把SDK管理的指定在线键盘设置为抢答题功能模式
... ... @@ -701,23 +1113,62 @@ extern&quot;C&quot; __declspec(dllexport) bool Start_Rush_Answer_Event(
701 1113 | --- | --- | --- | --- |
702 1114 |UCHAR iBaseID|基站ID|0~32||
703 1115 |ULONG KeySN|指定键盘SN|||
704   -|rushAnswerMode| 抢答模式|0:普通抢答(默认值)|
705   -|Moed2| 预留|0:(默认值)|
706   -|modifyMode|修改模式|0:不可修改<br>1:可以修改(默认值)|
707   -|UCHAR Txt_Len|提示标题长度|1~16字节||
708   -|Txt|提示标题|字符串，长度最多不超过16个字节|
  1116 +|int rushAnswerMode| 抢答模式|0:普通抢答(默认值)|
  1117 +|int Moed2| 预留|0:(默认值)|
  1118 +|int modifyMode|修改模式|0:不可修改<br>1:可以修改(默认值)|
  1119 +
709 1120  
710 1121 接口代码：
711 1122 ```C++
712 1123 extern"C" __declspec(dllexport) bool Start_Rush_Answer_Event_SN(
713 1124 UCHAR iBaseID,
714 1125 ULONG KeySN,
715   - int Moed1 = 1,
716   - int Moed2 = 0,
717   - int Moed3 = 0); //抢答模式
  1126 + int rushAnswerMode,
  1127 + int Moed2,
  1128 + int modifyMode); //抢答模式
718 1129 ```
719 1130  
720   -## 填空题功能
  1131 +#### 样例：
  1132 +样例目的：启动抢答题
  1133 +##### 启动功能部分：
  1134 +```C++
  1135 +Start_Rush_Answer_Event_SN(0,1837454011, 0, 0, 0); //开启抢答题
  1136 +```
  1137 +VoteEventCallBack 回调接口反馈数据解析：
  1138 +
  1139 +| **参数名称** | **参数说明** | **解析** | **备注** |
  1140 +| --- | --- | --- | --- |
  1141 +|int iBaseID|基站ID|1||
  1142 +|int mode|模式|301:S6<br>302:T2||
  1143 +|const char* sInfo|参数字符串|S6:"投票模式,键盘SN,结果,预留,预留" <br>T2:"投票模式,键盘SN,结果"||
  1144 +
  1145 +##### 接收按键数据部分：
  1146 +
  1147 +keyEventCallBack 回调接口反馈数据解析：
  1148 +
  1149 +| **参数名称** | **参数说明** | **数据值** | **备注** |
  1150 +| --- | --- | --- | --- |
  1151 +|UCHAR iBaseID|基站ID|1||
  1152 +|unsigned long long keySn|键盘SN|1837454011||
  1153 +|float Time|反馈时间[秒]|0.5||
  1154 +|int mode|回调反馈数据模式|13||
  1155 +|int RxMode|预留|0||
  1156 +|const char* sInfo|回调反馈数据|"0,1,0,0"|"预留,按键值,预留,预留"|
  1157 +
  1158 +##### 退出功能部分：
  1159 +```C++
  1160 +ExitEvent(13); //带抢答题模式切换到空闲模式
  1161 +```
  1162 +HDParamCallBack 回调接口反馈数据解析：
  1163 +
  1164 +| **参数名称** | **参数说明** | **解析** | **备注** |
  1165 +| --- | --- | --- | --- |
  1166 +|int iBaseID|基站ID|1||
  1167 +|int mode|模式|0||
  1168 +|const char* sInfo|参数字符串|"13,OK"|13：带抢答题模式切换到空闲模式成功|
  1169 +
  1170 +## 填空题
  1171 +### 填空题功能
721 1172  
722 1173 函数名称：Start_Rush_Answer_Event
723 1174 功能：填空题功能
... ... @@ -725,21 +1176,61 @@ extern&quot;C&quot; __declspec(dllexport) bool Start_Rush_Answer_Event_SN(
725 1176  
726 1177 | **参数名称** | **参数说明** | **范围** | **备注** |
727 1178 |---|---|---|---|
728   -| optionsMode | 填空类型 | 1:任意输入(默认值) |
729   -| modifyMode | 预留 | 1: (默认值) |
730   -| secrecyMode | 预留 | 0: (默认值) |
  1179 +| int optionsMode | 填空类型 | 1:任意输入(默认值) |
  1180 +| int modifyMode | 修改模式|0:不可修改 </br>1:可以修改(默认值)|
  1181 +| int secrecyMode | 预留 | 0: (默认值) |
731 1182  
732 1183  
733 1184 接口代码：
734 1185 ```C++
735 1186 extern"C" __declspec(dllexport) bool Start_TextAnswer_Event(
736   - int Moed1 = 1,
737   - int Moed2 = 0,
738   - int Moed3 = 0);
  1187 + int optionsMode,
  1188 + int modifyMode,
  1189 + int secrecyMode);
739 1190 ```
740 1191  
741   -## 填空题功能[指定键盘SN]
742   -函数名称：Start_Rush_Answer_Event_SN
  1192 +#### 样例：
  1193 +样例目的：启动抢答题
  1194 +##### 启动功能部分：
  1195 +```C++
  1196 +Start_TextAnswer_Event(1, 1, 0); //开启填空题
  1197 +```
  1198 +HDParamCallBack 回调接口反馈数据解析：
  1199 +
  1200 +| **参数名称** | **参数说明** | **解析** | **备注** |
  1201 +| --- | --- | --- | --- |
  1202 +|int iBaseID|基站ID|1||
  1203 +|int mode|模式|924|抢答题模式|
  1204 +|const char* sInfo|参数字符串|"OK"|成功|
  1205 +
  1206 +##### 接收按键数据部分：
  1207 +
  1208 +KeyEventCallBack 回调接口反馈数据解析：
  1209 +
  1210 +| **参数名称** | **参数说明** | **数据值** | **备注** |
  1211 +| --- | --- | --- | --- |
  1212 +|UCHAR iBaseID|基站ID|1||
  1213 +|unsigned long long keySn|键盘SN|1837454011||
  1214 +|float Time|反馈时间[秒]|0.5||
  1215 +|int mode|回调反馈数据模式|12||
  1216 +|int RxMode|预留|0||
  1217 +|const char* sInfo|回调反馈数据|"填空内容"||
  1218 +
  1219 +##### 退出功能部分：
  1220 +```C++
  1221 +ExitEvent(12); //带填空题模式切换到空闲模式
  1222 +```
  1223 +HDParamCallBack 回调接口反馈数据解析：
  1224 +
  1225 +| **参数名称** | **参数说明** | **解析** | **备注** |
  1226 +| --- | --- | --- | --- |
  1227 +|int iBaseID|基站ID|1||
  1228 +|int mode|模式|0||
  1229 +|const char* sInfo|参数字符串|"12,OK"|12：带填空题模式切换到空闲模式成功|
  1230 +
  1231 +
  1232 +### 填空题功能[指定键盘SN]
  1233 +函数名称：Start_TextAnswer_Event_SN
743 1234 功能：填空题功能[指定键盘SN]
744 1235 说明：把SDK管理的指定在线键盘设置为填空题功能模式
745 1236  
... ... @@ -747,21 +1238,61 @@ extern&quot;C&quot; __declspec(dllexport) bool Start_TextAnswer_Event(
747 1238 | --- | --- | --- | --- |
748 1239 |UCHAR iBaseID|基站ID|0~32||
749 1240 |ULONG KeySN|指定键盘SN|||
750   -| optionsMode | 填空类型 | 1:任意输入(默认值) |
751   -| modifyMode | 预留 | 1: (默认值) |
752   -| secrecyMode | 预留 | 0: (默认值) |
  1241 +| int optionsMode | 填空类型 | 1:任意输入(默认值) |
  1242 +| int modifyMode | 修改模式|0:不可修改 </br>1:可以修改(默认值)|
  1243 +| int secrecyMode | 预留 | 0: (默认值) |
753 1244  
754 1245 接口代码：
755 1246 ```C++
756 1247 extern"C" __declspec(dllexport) bool Start_TextAnswer_Event_SN(
757 1248 UCHAR iBaseID,
758 1249 ULONG KeySN,
759   - int Moed1 = 1,
760   - int Moed2 = 0,
761   - int Moed3 = 0); //抢答模式
  1250 + int optionsMode,
  1251 + int modifyMode,
  1252 + int secrecyMode); //填空模式
762 1253 ```
763 1254  
764   -## 模拟测试功能[广播]
  1255 +#### 样例：
  1256 +样例目的：启动填空题
  1257 +##### 启动功能部分：
  1258 +```C++
  1259 +Start_Rush_Answer_Event_SN(0,1837454011, 0, 0, 0); //开启填空题
  1260 +```
  1261 +VoteEventCallBack 回调接口反馈数据解析：
  1262 +
  1263 +| **参数名称** | **参数说明** | **解析** | **备注** |
  1264 +| --- | --- | --- | --- |
  1265 +|int iBaseID|基站ID|1||
  1266 +|int mode|模式|301:S6<br>302:T2||
  1267 +|const char* sInfo|参数字符串|S6:"投票模式,键盘SN,结果,预留,预留" <br>T2:"投票模式,键盘SN,结果"||
  1268 +
  1269 +##### 接收按键数据部分：
  1270 +
  1271 +keyEventCallBack 回调接口反馈数据解析：
  1272 +
  1273 +| **参数名称** | **参数说明** | **数据值** | **备注** |
  1274 +| --- | --- | --- | --- |
  1275 +|UCHAR iBaseID|基站ID|1||
  1276 +|unsigned long long keySn|键盘SN|1837454011||
  1277 +|float Time|反馈时间[秒]|0.5||
  1278 +|int mode|回调反馈数据模式|12||
  1279 +|int RxMode|预留|0||
  1280 +|const char* sInfo|回调反馈数据|"填空内容"||
  1281 +
  1282 +##### 退出功能部分：
  1283 +```C++
  1284 +ExitEvent(12); //带填空题模式切换到空闲模式
  1285 +```
  1286 +HDParamCallBack 回调接口反馈数据解析：
  1287 +
  1288 +| **参数名称** | **参数说明** | **解析** | **备注** |
  1289 +| --- | --- | --- | --- |
  1290 +|int iBaseID|基站ID|1||
  1291 +|int mode|模式|0||
  1292 +|const char* sInfo|参数字符串|"12,OK"|12：带填空题模式切换到空闲模式成功|
  1293 +
  1294 +## 模拟测试
  1295 +### 模拟测试功能[广播]
765 1296 函数名称：MockTest_Event
766 1297 功能：模拟测试功能[广播]
767 1298 说明：把SDK管理的所有基站的在线键盘设置为自由题功能模式
... ... @@ -769,7 +1300,7 @@ extern&quot;C&quot; __declspec(dllexport) bool Start_TextAnswer_Event_SN(
769 1300 | **参数名称** | **参数说明** | **范围** | **备注** |
770 1301 |---|---|---|---|
771 1302 |UCHAR iBaseID|基站ID|0~32||
772   -|int Moed1|模式|||
  1303 +|int Moed1|模式|1-报告状态<br>2-按键模拟||
773 1304 |UCHAR KeyTime|按键开启时间|启动后，多少秒内随机模拟按下按键，0=马上||
774 1305 |UCHAR GapTime|按键间隔时间|提交成功后，多少秒内再重新提交，模拟修改按键，0=不测试||
775 1306  
... ... @@ -778,12 +1309,52 @@ extern&quot;C&quot; __declspec(dllexport) bool Start_TextAnswer_Event_SN(
778 1309 ```C++
779 1310 extern"C" __declspec(dllexport) bool MockTest_Event(
780 1311 UCHAR iBaseID,
781   - int Moed1 = 1,
782   - UCHAR KeyTime = 1,
783   - UCHAR GapTime = 1); //模拟测试[1 报告状态]
  1312 + int Moed1,
  1313 + UCHAR KeyTime,
  1314 + UCHAR GapTime); //模拟测试[1 报告状态]
784 1315 ```
785 1316  
786   -## 异步测验功能[广播]
  1317 +#### 样例：
  1318 +样例目的：启动模拟测试
  1319 +##### 启动功能部分：
  1320 +```C++
  1321 +MockTest_Event(0, 1, 0, 0); //开启模拟测试
  1322 +```
  1323 +HDParamCallBack 回调接口反馈数据解析：
  1324 +
  1325 +| **参数名称** | **参数说明** | **解析** | **备注** |
  1326 +| --- | --- | --- | --- |
  1327 +|int iBaseID|基站ID|1||
  1328 +|int mode|模式|9|模拟测试|
  1329 +|const char* sInfo|参数字符串|"OK"|成功|
  1330 +
  1331 +##### 接收按键数据部分：
  1332 +
  1333 +KeyEventCallBack 回调接口反馈数据解析：
  1334 +
  1335 +| **参数名称** | **参数说明** | **数据值** | **备注** |
  1336 +| --- | --- | --- | --- |
  1337 +|UCHAR iBaseID|基站ID|1||
  1338 +|unsigned long long keySn|键盘SN|1837454011||
  1339 +|float Time|反馈时间[秒]|0.5||
  1340 +|int mode|回调反馈数据模式|9||
  1341 +|int RxMode|预留|0||
  1342 +|const char* sInfo|"67,1837454011,1.0,99"|"键盘型号,键盘SN,软件版本,电压或电量"||
  1343 +
  1344 +##### 退出功能部分：
  1345 +```C++
  1346 +ExitEvent(9); //带模拟测试模式切换到空闲模式
  1347 +```
  1348 +HDParamCallBack 回调接口反馈数据解析：
  1349 +
  1350 +| **参数名称** | **参数说明** | **解析** | **备注** |
  1351 +| --- | --- | --- | --- |
  1352 +|int iBaseID|基站ID|1||
  1353 +|int mode|模式|0||
  1354 +|const char* sInfo|参数字符串|"9,OK"|9：带模拟测试模式切换到空闲模式成功|
  1355 +
  1356 +## 异步测验
  1357 +### 异步测验功能[广播]
787 1358 函数名称：TestMode_Event
788 1359 功能：异步测验功能[广播]
789 1360 说明：把SDK管理的所有基站的在线键盘设置为异步测验功能模式
... ... @@ -791,8 +1362,8 @@ extern&quot;C&quot; __declspec(dllexport) bool MockTest_Event(
791 1362 | **参数名称** | **参数说明** | **范围** | **备注** |
792 1363 |---|---|---|---|
793 1364 |UCHAR iBaseID|基站ID|0~32||
794   -|int Moed|模式|||
795   -|USHORT TestNum||||
  1365 +|int Moed|预留|||
  1366 +|USHORT TestNum|测试题目数量|||
796 1367  
797 1368  
798 1369 接口代码：
... ... @@ -803,6 +1374,45 @@ extern&quot;C&quot; __declspec(dllexport) bool TestMode_Event(
803 1374 USHORT TestNum);
804 1375 ```
805 1376  
  1377 +#### 样例：
  1378 +样例目的：启动异步测验，自动测试10道题目
  1379 +##### 启动功能部分：
  1380 +```C++
  1381 +TestMode_Event(0, 0, 10); //开启异步测验
  1382 +```
  1383 +HDParamCallBack 回调接口反馈数据解析：
  1384 +
  1385 +| **参数名称** | **参数说明** | **解析** | **备注** |
  1386 +| --- | --- | --- | --- |
  1387 +|int iBaseID|基站ID|1||
  1388 +|int mode|模式|14|异步测验|
  1389 +|const char* sInfo|参数字符串|"OK"|成功|
  1390 +
  1391 +##### 接收按键数据部分：
  1392 +
  1393 +KeyEventCallBack 回调接口反馈数据解析：
  1394 +
  1395 +| **参数名称** | **参数说明** | **数据值** | **备注** |
  1396 +| --- | --- | --- | --- |
  1397 +|UCHAR iBaseID|基站ID|1||
  1398 +|unsigned long long keySn|键盘SN|1837454011||
  1399 +|float Time|反馈时间[秒]|0.5||
  1400 +|int mode|回调反馈数据模式|14||
  1401 +|int RxMode|预留|0||
  1402 +|const char* sInfo|回调反馈数据|"1,1,0,0"|"题目编号,按键值,预留,预留"|
  1403 +
  1404 +##### 退出功能部分：
  1405 +```C++
  1406 +ExitEvent(0); //切换到空闲模式
  1407 +```
  1408 +HDParamCallBack 回调接口反馈数据解析：
  1409 +
  1410 +| **参数名称** | **参数说明** | **解析** | **备注** |
  1411 +| --- | --- | --- | --- |
  1412 +|int iBaseID|基站ID|1||
  1413 +|int mode|模式|0||
  1414 +|const char* sInfo|参数字符串|"0,OK"|0：切换到空闲模式成功|
  1415 +
806 1416 ## 多题型模式
807 1417 ### 启动多题型模式
808 1418 函数名称：Start_Multiple_Questions_Event
... ... @@ -927,8 +1537,8 @@ extern&quot;C&quot; __declspec(dllexport) bool Custom_Questions_Event(
927 1537 UCHAR iBaseID,
928 1538 const char* sInfo);
929 1539 ```
930   -
931   -## 开启快速配对功能[广播]
  1540 +## 快速配对
  1541 +### 开启快速配对功能[广播]
932 1542 函数名称：QuickMatch
933 1543 功能：开启快速配对功能[广播]
934 1544 说明：把SDK管理的所有基站的在线键盘设置为开启快速配对功能模式
... ... @@ -942,7 +1552,7 @@ extern&quot;C&quot; __declspec(dllexport) bool Custom_Questions_Event(
942 1552 extern"C" __declspec(dllexport) bool QuickMatch(UCHAR iBaseID);
943 1553 ```
944 1554  
945   -## 开启快速配对功能[内部接口]
  1555 +### 开启快速配对功能[内部接口]
946 1556 函数名称：QuickMatch_Pro
947 1557 功能：开启快速配对功能[广播]
948 1558 说明：把SDK管理的所有基站的在线键盘设置为开启快速配对功能模式
... ... @@ -1028,7 +1638,7 @@ extern&quot;C&quot; __declspec(dllexport) bool GetKeyNameTxt_C100B_S6(
1028 1638 ULONG KeySN);
1029 1639 ```
1030 1640  
1031   -### 设置键盘评分[积分]
  1641 +## 设置键盘评分[积分]
1032 1642 函数名称：SetKeyScore
1033 1643 功能：设置键盘评分[积分]
1034 1644 参数说明：
... ... @@ -1051,7 +1661,7 @@ extern&quot;C&quot; __declspec(dllexport) bool SetKeyScore(
1051 1661 char* Score);
1052 1662 ```
1053 1663  
1054   -### 键盘自定义标题字符串[第二行]
  1664 +## 键盘自定义标题字符串[第二行]
1055 1665 函数名称：SetKeyTitleTxt2
1056 1666 功能：设置键盘自定义标题字符串[第二行]
1057 1667 参数说明：
... ... @@ -1076,7 +1686,7 @@ extern&quot;C&quot; __declspec(dllexport) bool SetKeyTitleTxt2(
1076 1686 const char* Txt);
1077 1687 ```
1078 1688  
1079   -### 键盘自定义标题字符串[第三行]
  1689 +## 键盘自定义标题字符串[第三行]
1080 1690 函数名称：SetKeyTitleTxt3
1081 1691 功能：设置键盘自定义标题字符串[第三行]
1082 1692 参数说明：
... ... @@ -1099,7 +1709,7 @@ extern&quot;C&quot; __declspec(dllexport) bool SetKeyTitleTxt3(
1099 1709 const char* Txt);
1100 1710 ```
1101 1711  
1102   -### 键盘自定义评分[积分]和标题字符串[第二行]
  1712 +## 键盘自定义评分[积分]和标题字符串[第二行]
1103 1713 函数名称：SetKeyScreTxt2
1104 1714 功能：设置键盘自定义评分[积分]和标题字符串[第二行]
1105 1715 参数说明：
... ... @@ -1128,7 +1738,7 @@ extern&quot;C&quot; __declspec(dllexport) bool SetKeyScreTxt2(
1128 1738 const char* Txt);
1129 1739 ```
1130 1740  
1131   -### 键盘自定义短信
  1741 +## 键盘自定义短信
1132 1742 函数名称：SetKeyMessage
1133 1743 功能：设置键盘自定义短信
1134 1744 参数说明：
... ...
通讯协议-SDK应用部分[内部].md
  View file @6bdf30b
... ... @@ -487,12 +487,11 @@ params：{}
487 487  
488 488 |**Json字段**| **字段含义** | **赋值及含义**|
489 489 | --- | --- | --- |
490   -|bindMode| 签到模式| 1:指定键签到 <br> 2:PIN码签到(默认值) |
491   -| lessMode | 预留| 0:(默认值）|
  490 +| bindMode | 签到模式| 1:指定键签到 <br> 2:PIN码签到(默认值) |
492 491 | modifyMode | 修改模式 | 0:不可修改 <br>1:可以修改(默认值)|
493   -| limitNumber | 指定位数 | 0:不指定位数(默认值) <br> 1:指定位数 |
494   -| options | 预留 | 10:(默认值）|
495   -| optionalN | 可选数字 | 1≤N≤14 (指定位数才需要设置) |
  492 +| lessMode | 预留| 0:(默认值）|
  493 +| options | 预留 | 10:(默认值）|
  494 +| optionalN | 可选位数 | 1≤N≤14 |
496 495 | keyValue | 指定按键键值 | 0:未指定[OK键签到] <br>1:1 <br>2:2 <br> 3:3 <br> 4:4 <br> 5:5 <br> 6:6 <br> 7:7 <br> 8:8 <br> 9:9 <br> 10:0 <br> 11:上键 <br> 12:下键 <br> 13:OK <br> 14:ESC <br> 15: Menu |
497 496 | tipTitle | 提示标题 | 字符串，长度最多不超过16个字节|
498 497  
... ...