Commit 6bdf30bd1aef80ca8cf68d13a2e7007d40a5f6b8
1 parent
eb1166f1
1.SDK_DLL部分[内部] 启动业务增加样例。
2.SDK应用部分[内部] 开始签到部分参数位置调整。
Showing
3 changed files
with
730 additions
and
121 deletions
img/image7.png
0 → 100644
7.41 KB
通讯协议-SDK_DLL部分[内部].md
@@ -302,29 +302,29 @@ HDParamCallBack 回调接口反馈数据解析: | @@ -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 | |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 || | 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 | ```C++ | 313 | ```C++ |
314 | extern"C" __declspec(dllexport) bool Start_Sign_in_Event( | 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 | ```C++ | 325 | ```C++ |
326 | Set_Custom_Title(0, 3, "TXT"); //设置自定义标题 | 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 | HDParamCallBack 回调接口反馈数据解析: | 329 | HDParamCallBack 回调接口反馈数据解析: |
330 | 330 | ||
@@ -368,11 +368,11 @@ HDParamCallBack 回调接口反馈数据解析: | @@ -368,11 +368,11 @@ HDParamCallBack 回调接口反馈数据解析: | ||
368 | | --- | --- | --- | --- | | 368 | | --- | --- | --- | --- | |
369 | |UCHAR iBaseID|基站ID|0~32|| | 369 | |UCHAR iBaseID|基站ID|0~32|| |
370 | |ULONG KeySN|指定键盘SN||| | 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 | |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 || | 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 | |UCHAR Txt_Len|提示标题长度|1~16字节|| | 377 | |UCHAR Txt_Len|提示标题长度|1~16字节|| |
378 | |const char* Txt|提示标题|字符串|| | 378 | |const char* Txt|提示标题|字符串|| |
@@ -382,22 +382,22 @@ HDParamCallBack 回调接口反馈数据解析: | @@ -382,22 +382,22 @@ HDParamCallBack 回调接口反馈数据解析: | ||
382 | extern"C" __declspec(dllexport) bool Start_Sign_in_Event_SN( | 382 | extern"C" __declspec(dllexport) bool Start_Sign_in_Event_SN( |
383 | UCHAR iBaseID, | 383 | UCHAR iBaseID, |
384 | ULONG KeySN, | 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 | int KeyValue, | 390 | int KeyValue, |
391 | UCHAR Txt_Len, | 391 | UCHAR Txt_Len, |
392 | const char* Txt); //开始签到功能 | 392 | const char* Txt); //开始签到功能 |
393 | ``` | 393 | ``` |
394 | 394 | ||
395 | -#### 启动样例: | ||
396 | -目的:PIN签到模式,可以修改,可选项数6 | 395 | +#### 样例: |
396 | +样例目的:PIN签到模式,可以修改,可选项数6 | ||
397 | ##### 启动功能部分: | 397 | ##### 启动功能部分: |
398 | ```C++ | 398 | ```C++ |
399 | //指定键盘开启pin模式签到,带自定义标题 | 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 | HDParamCallBack 回调接口反馈数据解析: | 402 | HDParamCallBack 回调接口反馈数据解析: |
403 | 403 | ||
@@ -416,14 +416,14 @@ KeyEventCallBack 回调接口反馈数据解析: | @@ -416,14 +416,14 @@ KeyEventCallBack 回调接口反馈数据解析: | ||
416 | |UCHAR iBaseID|基站ID|1|| | 416 | |UCHAR iBaseID|基站ID|1|| |
417 | |unsigned long long keySn|键盘SN|1837454011|| | 417 | |unsigned long long keySn|键盘SN|1837454011|| |
418 | |float Time|反馈时间[秒]|0.5|| | 418 | |float Time|反馈时间[秒]|0.5|| |
419 | -|int mode|回调反馈数据模式|1|| | 419 | +|int mode|回调反馈数据模式|4|| |
420 | |int RxMode|预留|0|| | 420 | |int RxMode|预留|0|| |
421 | |const char* sInfo|回调反馈数据|"0,1001,0,0"|"预留,按键值,预留,预留"| | 421 | |const char* sInfo|回调反馈数据|"0,1001,0,0"|"预留,按键值,预留,预留"| |
422 | 422 | ||
423 | 423 | ||
424 | ##### 退出功能部分: | 424 | ##### 退出功能部分: |
425 | ```C++ | 425 | ```C++ |
426 | -ExitEvent(1); //带签到模式切换到空闲模式 | 426 | +ExitEvent(1); // |
427 | ``` | 427 | ``` |
428 | HDParamCallBack 回调接口反馈数据解析: | 428 | HDParamCallBack 回调接口反馈数据解析: |
429 | 429 | ||
@@ -431,19 +431,19 @@ HDParamCallBack 回调接口反馈数据解析: | @@ -431,19 +431,19 @@ HDParamCallBack 回调接口反馈数据解析: | ||
431 | | --- | --- | --- | --- | | 431 | | --- | --- | --- | --- | |
432 | |int iBaseID|基站ID|1|| | 432 | |int iBaseID|基站ID|1|| |
433 | |int mode|模式|0|| | 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 | 函数名称:Start_Number_Event | 438 | 函数名称:Start_Number_Event |
439 | 功能:数字题功能[广播] | 439 | 功能:数字题功能[广播] |
440 | 说明:把SDK管理的所有基站的在线键盘设置为数字功能模式 | 440 | 说明:把SDK管理的所有基站的在线键盘设置为数字功能模式 |
441 | 441 | ||
442 | | **参数名称** | **参数说明** | **范围** | **备注** | | 442 | | **参数名称** | **参数说明** | **范围** | **备注** | |
443 | |---|---|---|---| | 443 | |---|---|---|---| |
444 | -|secrecyMode|保密模式|0:不保密(默认值)<br>1:保密|| | ||
445 | -|modifyMode|修改模式|0:不可修改<br>1:可以修改(默认值)| | ||
446 | |aswOption|按键模式|0:无规则 (S6最多16位,T2最多14位)<br>1:预留<br>2:预留<br>3:带小数位上下限(T2不支持)| | 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 | |digits|小数位数|0:没有小数点<br>1:一位小数点<br>2:二位小数点| | 447 | |digits|小数位数|0:没有小数点<br>1:一位小数点<br>2:二位小数点| |
448 | |numMin|下限|aswOption=3<br>digits=0 范围:0~65535 <br> digits=1 范围:0~6553 <br> digits=2 范围:0~655| | 448 | |numMin|下限|aswOption=3<br>digits=0 范围:0~65535 <br> digits=1 范围:0~6553 <br> digits=2 范围:0~655| |
449 | |numMax|上限|aswOption=3<br>digits=0 范围:0~65535 <br> digits=1 范围:0~6553 <br> digits=2 范围:0~655| | 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,15 +451,56 @@ HDParamCallBack 回调接口反馈数据解析: | ||
451 | 接口代码: | 451 | 接口代码: |
452 | ```C++ | 452 | ```C++ |
453 | extern"C" __declspec(dllexport) bool Start_Number_Event( | 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 | 函数名称:Start_Number_Event_SN | 504 | 函数名称:Start_Number_Event_SN |
464 | 功能:数字题功能[指定键盘SN] | 505 | 功能:数字题功能[指定键盘SN] |
465 | 说明:把SDK管理的指定在线键盘设置为数字题功能模式 | 506 | 说明:把SDK管理的指定在线键盘设置为数字题功能模式 |
@@ -492,7 +533,47 @@ extern"C" __declspec(dllexport) bool Start_Number_Event_SN( | @@ -492,7 +533,47 @@ extern"C" __declspec(dllexport) bool Start_Number_Event_SN( | ||
492 | const char* Txt); // | 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 | 函数名称:Start_TrueFalse_Event | 577 | 函数名称:Start_TrueFalse_Event |
497 | 功能:判断题功能[广播] | 578 | 功能:判断题功能[广播] |
498 | 说明:把SDK管理的所有基站的在线键盘设置为判断题功能模式 | 579 | 说明:把SDK管理的所有基站的在线键盘设置为判断题功能模式 |
@@ -500,8 +581,9 @@ extern"C" __declspec(dllexport) bool Start_Number_Event_SN( | @@ -500,8 +581,9 @@ extern"C" __declspec(dllexport) bool Start_Number_Event_SN( | ||
500 | | **参数名称** | **参数说明** | **范围** | **备注** | | 581 | | **参数名称** | **参数说明** | **范围** | **备注** | |
501 | |---|---|---|---| | 582 | |---|---|---|---| |
502 | | optionsMode | 选项类别 | 1:True/False 对/错 </br>2:Yes/No 是/否</br> 3:√/×| | 583 | | optionsMode | 选项类别 | 1:True/False 对/错 </br>2:Yes/No 是/否</br> 3:√/×| |
503 | -| secrecyMode | 保密模式 | 0:不保密(默认值) </br> 1:保密| | ||
504 | | modifyMode | 修改模式 | 0:不可修改</br>1:可以修改(默认值)| | 584 | | modifyMode | 修改模式 | 0:不可修改</br>1:可以修改(默认值)| |
585 | +| secrecyMode | 保密模式 | 0:不保密(默认值) </br> 1:保密| | ||
586 | + | ||
505 | 587 | ||
506 | 588 | ||
507 | 接口代码: | 589 | 接口代码: |
@@ -512,7 +594,48 @@ extern"C" __declspec(dllexport) bool Start_TrueFalse_Event( | @@ -512,7 +594,48 @@ extern"C" __declspec(dllexport) bool Start_TrueFalse_Event( | ||
512 | int Moed3 = 0); | 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 | 函数名称:Start_TrueFalse_Event_SN | 639 | 函数名称:Start_TrueFalse_Event_SN |
517 | 功能:判断题功能[指定键盘SN] | 640 | 功能:判断题功能[指定键盘SN] |
518 | 说明:把SDK管理的指定在线键盘设置为判断题功能模式 | 641 | 说明:把SDK管理的指定在线键盘设置为判断题功能模式 |
@@ -522,24 +645,65 @@ extern"C" __declspec(dllexport) bool Start_TrueFalse_Event( | @@ -522,24 +645,65 @@ extern"C" __declspec(dllexport) bool Start_TrueFalse_Event( | ||
522 | |UCHAR iBaseID|基站ID|0~32|| | 645 | |UCHAR iBaseID|基站ID|0~32|| |
523 | |ULONG KeySN|指定键盘SN||| | 646 | |ULONG KeySN|指定键盘SN||| |
524 | | optionsMode | 选项类别 | 1:True/False 对/错 </br>2:Yes/No 是/否</br> 3:√/×| | 647 | | optionsMode | 选项类别 | 1:True/False 对/错 </br>2:Yes/No 是/否</br> 3:√/×| |
525 | -| secrecyMode | 保密模式 | 0:不保密(默认值) </br> 1:保密| | ||
526 | | modifyMode | 修改模式 | 0:不可修改</br>1:可以修改(默认值)| | 648 | | modifyMode | 修改模式 | 0:不可修改</br>1:可以修改(默认值)| |
649 | +| secrecyMode | 保密模式 | 0:不保密(默认值) </br> 1:保密| | ||
527 | |UCHAR Txt_Len|提示标题长度|1~16字节|| | 650 | |UCHAR Txt_Len|提示标题长度|1~16字节|| |
528 | |Txt|提示标题|字符串,长度最多不超过16个字节| | 651 | |Txt|提示标题|字符串,长度最多不超过16个字节| |
529 | 652 | ||
530 | 接口代码: | 653 | 接口代码: |
531 | ```C++ | 654 | ```C++ |
532 | -extern"C" __declspec(dllexport) bool T2_Start_TrueFalse_Event( | 655 | +extern"C" __declspec(dllexport) bool Start_TrueFalse_Event_SN( |
533 | UCHAR iBaseID, | 656 | UCHAR iBaseID, |
534 | ULONG KeySN, | 657 | ULONG KeySN, |
535 | - int Moed1, | ||
536 | - int Moed2, | ||
537 | - int Moed3, | 658 | + int optionsMode, |
659 | + int modifyMode, | ||
660 | + int secrecyMode, | ||
538 | UCHAR Txt_Len, | 661 | UCHAR Txt_Len, |
539 | const char* Txt); // | 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 | 函数名称:Start_TrueFalse_Event | 707 | 函数名称:Start_TrueFalse_Event |
544 | 功能:选择题功能[广播] | 708 | 功能:选择题功能[广播] |
545 | 说明:把SDK管理的所有基站的在线键盘设置为选择题功能模式 | 709 | 说明:把SDK管理的所有基站的在线键盘设置为选择题功能模式 |
@@ -547,8 +711,8 @@ extern"C" __declspec(dllexport) bool T2_Start_TrueFalse_Event( | @@ -547,8 +711,8 @@ extern"C" __declspec(dllexport) bool T2_Start_TrueFalse_Event( | ||
547 | | **参数名称** | **参数说明** | **范围** | **备注** | | 711 | | **参数名称** | **参数说明** | **范围** | **备注** | |
548 | |---|---|---|---| | 712 | |---|---|---|---| |
549 | |optionsMode|选项类别|1:显示字母(默认值) </br>2:显示数字 | | 713 | |optionsMode|选项类别|1:显示字母(默认值) </br>2:显示数字 | |
550 | -|secrecyMode|保密模式|0:不保密(默认值)</br>1:保密 | | ||
551 | |modifyMode|修改模式|0:不可修改 </br>1:可以修改(默认值) | | 714 | |modifyMode|修改模式|0:不可修改 </br>1:可以修改(默认值) | |
715 | +|secrecyMode|保密模式|0:不保密(默认值)</br>1:保密 | | ||
552 | |lessMode|迫选模式| 0:可缺选(默认值) </br>1:不可缺选</br>2:允许重复输入</br>3:允许重复输入且不可缺选 | | 716 | |lessMode|迫选模式| 0:可缺选(默认值) </br>1:不可缺选</br>2:允许重复输入</br>3:允许重复输入且不可缺选 | |
553 | | options|选项数目|1≤M≤10(默认值4)| | 717 | | options|选项数目|1≤M≤10(默认值4)| |
554 | | optionalN|可选项数|1≤N≤M(默认值1)| | 718 | | optionalN|可选项数|1≤N≤M(默认值1)| |
@@ -557,15 +721,55 @@ extern"C" __declspec(dllexport) bool T2_Start_TrueFalse_Event( | @@ -557,15 +721,55 @@ extern"C" __declspec(dllexport) bool T2_Start_TrueFalse_Event( | ||
557 | 接口代码: | 721 | 接口代码: |
558 | ```C++ | 722 | ```C++ |
559 | extern"C" __declspec(dllexport) bool Start_Choice_Event( | 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 | 函数名称:Start_Choice_Event_SN | 773 | 函数名称:Start_Choice_Event_SN |
570 | 功能:选择题功能[指定键盘SN] | 774 | 功能:选择题功能[指定键盘SN] |
571 | 说明:把SDK管理的指定在线键盘设置为选择题功能模式 | 775 | 说明:把SDK管理的指定在线键盘设置为选择题功能模式 |
@@ -588,17 +792,58 @@ extern"C" __declspec(dllexport) bool Start_Choice_Event( | @@ -588,17 +792,58 @@ extern"C" __declspec(dllexport) bool Start_Choice_Event( | ||
588 | extern"C" __declspec(dllexport) bool Start_Choice_Event_SN( | 792 | extern"C" __declspec(dllexport) bool Start_Choice_Event_SN( |
589 | UCHAR iBaseID, | 793 | UCHAR iBaseID, |
590 | ULONG KeySN, | 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 | UCHAR Txt_Len, | 801 | UCHAR Txt_Len, |
598 | const char* Txt); | 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 | 函数名称:Start_Voice_Event | 847 | 函数名称:Start_Voice_Event |
603 | 功能:语音题功能[广播] | 848 | 功能:语音题功能[广播] |
604 | 说明:把SDK管理的所有基站的在线键盘设置为语音题功能模式 | 849 | 说明:把SDK管理的所有基站的在线键盘设置为语音题功能模式 |
@@ -622,7 +867,52 @@ extern"C" __declspec(dllexport) bool Start_Voice_Event( | @@ -622,7 +867,52 @@ extern"C" __declspec(dllexport) bool Start_Voice_Event( | ||
622 | int OutMode); | 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 | 函数名称:Start_Voice_Event_SN | 916 | 函数名称:Start_Voice_Event_SN |
627 | 功能:语音题功能[指定键盘SN] | 917 | 功能:语音题功能[指定键盘SN] |
628 | 说明:把SDK管理的指定在线键盘设置为语音题功能模式 | 918 | 说明:把SDK管理的指定在线键盘设置为语音题功能模式 |
@@ -653,7 +943,52 @@ extern"C" __declspec(dllexport) bool Start_Voice_Event_SN( | @@ -653,7 +943,52 @@ extern"C" __declspec(dllexport) bool Start_Voice_Event_SN( | ||
653 | const char* Txt);// | 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 | 函数名称:Start_Free_Question_Event | 992 | 函数名称:Start_Free_Question_Event |
658 | 功能:自由题功能 | 993 | 功能:自由题功能 |
659 | 说明:把SDK管理的所有基站的在线键盘设置为自由题功能模式 | 994 | 说明:把SDK管理的所有基站的在线键盘设置为自由题功能模式 |
@@ -661,7 +996,7 @@ extern"C" __declspec(dllexport) bool Start_Voice_Event_SN( | @@ -661,7 +996,7 @@ extern"C" __declspec(dllexport) bool Start_Voice_Event_SN( | ||
661 | | **参数名称** | **参数说明** | **范围** | **备注** | | 996 | | **参数名称** | **参数说明** | **范围** | **备注** | |
662 | |---|---|---|---| | 997 | |---|---|---|---| |
663 | |UCHAR iBaseID|基站ID|0~32|| | 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"C" __declspec(dllexport) bool Start_Free_Question_Event( | @@ -670,8 +1005,47 @@ extern"C" __declspec(dllexport) bool Start_Free_Question_Event( | ||
670 | UCHAR iBaseID, | 1005 | UCHAR iBaseID, |
671 | ULONG KeySN); | 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 | 函数名称:Start_Rush_Answer_Event | 1050 | 函数名称:Start_Rush_Answer_Event |
677 | 功能:抢答题功能 | 1051 | 功能:抢答题功能 |
@@ -679,20 +1053,58 @@ extern"C" __declspec(dllexport) bool Start_Free_Question_Event( | @@ -679,20 +1053,58 @@ extern"C" __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 | ```C++ | 1062 | ```C++ |
689 | extern"C" __declspec(dllexport) bool Start_Rush_Answer_Event( | 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 | 函数名称:Start_Rush_Answer_Event_SN | 1108 | 函数名称:Start_Rush_Answer_Event_SN |
697 | 功能:抢答题功能[指定键盘SN] | 1109 | 功能:抢答题功能[指定键盘SN] |
698 | 说明:把SDK管理的指定在线键盘设置为抢答题功能模式 | 1110 | 说明:把SDK管理的指定在线键盘设置为抢答题功能模式 |
@@ -701,23 +1113,62 @@ extern"C" __declspec(dllexport) bool Start_Rush_Answer_Event( | @@ -701,23 +1113,62 @@ extern"C" __declspec(dllexport) bool Start_Rush_Answer_Event( | ||
701 | | --- | --- | --- | --- | | 1113 | | --- | --- | --- | --- | |
702 | |UCHAR iBaseID|基站ID|0~32|| | 1114 | |UCHAR iBaseID|基站ID|0~32|| |
703 | |ULONG KeySN|指定键盘SN||| | 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 | ```C++ | 1122 | ```C++ |
712 | extern"C" __declspec(dllexport) bool Start_Rush_Answer_Event_SN( | 1123 | extern"C" __declspec(dllexport) bool Start_Rush_Answer_Event_SN( |
713 | UCHAR iBaseID, | 1124 | UCHAR iBaseID, |
714 | ULONG KeySN, | 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 | 函数名称:Start_Rush_Answer_Event | 1173 | 函数名称:Start_Rush_Answer_Event |
723 | 功能:填空题功能 | 1174 | 功能:填空题功能 |
@@ -725,21 +1176,61 @@ extern"C" __declspec(dllexport) bool Start_Rush_Answer_Event_SN( | @@ -725,21 +1176,61 @@ extern"C" __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 | ```C++ | 1185 | ```C++ |
735 | extern"C" __declspec(dllexport) bool Start_TextAnswer_Event( | 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 | 功能:填空题功能[指定键盘SN] | 1234 | 功能:填空题功能[指定键盘SN] |
744 | 说明:把SDK管理的指定在线键盘设置为填空题功能模式 | 1235 | 说明:把SDK管理的指定在线键盘设置为填空题功能模式 |
745 | 1236 | ||
@@ -747,21 +1238,61 @@ extern"C" __declspec(dllexport) bool Start_TextAnswer_Event( | @@ -747,21 +1238,61 @@ extern"C" __declspec(dllexport) bool Start_TextAnswer_Event( | ||
747 | | --- | --- | --- | --- | | 1238 | | --- | --- | --- | --- | |
748 | |UCHAR iBaseID|基站ID|0~32|| | 1239 | |UCHAR iBaseID|基站ID|0~32|| |
749 | |ULONG KeySN|指定键盘SN||| | 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 | ```C++ | 1246 | ```C++ |
756 | extern"C" __declspec(dllexport) bool Start_TextAnswer_Event_SN( | 1247 | extern"C" __declspec(dllexport) bool Start_TextAnswer_Event_SN( |
757 | UCHAR iBaseID, | 1248 | UCHAR iBaseID, |
758 | ULONG KeySN, | 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 | 函数名称:MockTest_Event | 1296 | 函数名称:MockTest_Event |
766 | 功能:模拟测试功能[广播] | 1297 | 功能:模拟测试功能[广播] |
767 | 说明:把SDK管理的所有基站的在线键盘设置为自由题功能模式 | 1298 | 说明:把SDK管理的所有基站的在线键盘设置为自由题功能模式 |
@@ -769,7 +1300,7 @@ extern"C" __declspec(dllexport) bool Start_TextAnswer_Event_SN( | @@ -769,7 +1300,7 @@ extern"C" __declspec(dllexport) bool Start_TextAnswer_Event_SN( | ||
769 | | **参数名称** | **参数说明** | **范围** | **备注** | | 1300 | | **参数名称** | **参数说明** | **范围** | **备注** | |
770 | |---|---|---|---| | 1301 | |---|---|---|---| |
771 | |UCHAR iBaseID|基站ID|0~32|| | 1302 | |UCHAR iBaseID|基站ID|0~32|| |
772 | -|int Moed1|模式||| | 1303 | +|int Moed1|模式|1-报告状态<br>2-按键模拟|| |
773 | |UCHAR KeyTime|按键开启时间|启动后,多少秒内随机模拟按下按键,0=马上|| | 1304 | |UCHAR KeyTime|按键开启时间|启动后,多少秒内随机模拟按下按键,0=马上|| |
774 | |UCHAR GapTime|按键间隔时间|提交成功后,多少秒内再重新提交,模拟修改按键,0=不测试|| | 1305 | |UCHAR GapTime|按键间隔时间|提交成功后,多少秒内再重新提交,模拟修改按键,0=不测试|| |
775 | 1306 | ||
@@ -778,12 +1309,52 @@ extern"C" __declspec(dllexport) bool Start_TextAnswer_Event_SN( | @@ -778,12 +1309,52 @@ extern"C" __declspec(dllexport) bool Start_TextAnswer_Event_SN( | ||
778 | ```C++ | 1309 | ```C++ |
779 | extern"C" __declspec(dllexport) bool MockTest_Event( | 1310 | extern"C" __declspec(dllexport) bool MockTest_Event( |
780 | UCHAR iBaseID, | 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 | 函数名称:TestMode_Event | 1358 | 函数名称:TestMode_Event |
788 | 功能:异步测验功能[广播] | 1359 | 功能:异步测验功能[广播] |
789 | 说明:把SDK管理的所有基站的在线键盘设置为异步测验功能模式 | 1360 | 说明:把SDK管理的所有基站的在线键盘设置为异步测验功能模式 |
@@ -791,8 +1362,8 @@ extern"C" __declspec(dllexport) bool MockTest_Event( | @@ -791,8 +1362,8 @@ extern"C" __declspec(dllexport) bool MockTest_Event( | ||
791 | | **参数名称** | **参数说明** | **范围** | **备注** | | 1362 | | **参数名称** | **参数说明** | **范围** | **备注** | |
792 | |---|---|---|---| | 1363 | |---|---|---|---| |
793 | |UCHAR iBaseID|基站ID|0~32|| | 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"C" __declspec(dllexport) bool TestMode_Event( | @@ -803,6 +1374,45 @@ extern"C" __declspec(dllexport) bool TestMode_Event( | ||
803 | USHORT TestNum); | 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 | 函数名称:Start_Multiple_Questions_Event | 1418 | 函数名称:Start_Multiple_Questions_Event |
@@ -927,8 +1537,8 @@ extern"C" __declspec(dllexport) bool Custom_Questions_Event( | @@ -927,8 +1537,8 @@ extern"C" __declspec(dllexport) bool Custom_Questions_Event( | ||
927 | UCHAR iBaseID, | 1537 | UCHAR iBaseID, |
928 | const char* sInfo); | 1538 | const char* sInfo); |
929 | ``` | 1539 | ``` |
930 | - | ||
931 | -## 开启快速配对功能[广播] | 1540 | +## 快速配对 |
1541 | +### 开启快速配对功能[广播] | ||
932 | 函数名称:QuickMatch | 1542 | 函数名称:QuickMatch |
933 | 功能:开启快速配对功能[广播] | 1543 | 功能:开启快速配对功能[广播] |
934 | 说明:把SDK管理的所有基站的在线键盘设置为开启快速配对功能模式 | 1544 | 说明:把SDK管理的所有基站的在线键盘设置为开启快速配对功能模式 |
@@ -942,7 +1552,7 @@ extern"C" __declspec(dllexport) bool Custom_Questions_Event( | @@ -942,7 +1552,7 @@ extern"C" __declspec(dllexport) bool Custom_Questions_Event( | ||
942 | extern"C" __declspec(dllexport) bool QuickMatch(UCHAR iBaseID); | 1552 | extern"C" __declspec(dllexport) bool QuickMatch(UCHAR iBaseID); |
943 | ``` | 1553 | ``` |
944 | 1554 | ||
945 | -## 开启快速配对功能[内部接口] | 1555 | +### 开启快速配对功能[内部接口] |
946 | 函数名称:QuickMatch_Pro | 1556 | 函数名称:QuickMatch_Pro |
947 | 功能:开启快速配对功能[广播] | 1557 | 功能:开启快速配对功能[广播] |
948 | 说明:把SDK管理的所有基站的在线键盘设置为开启快速配对功能模式 | 1558 | 说明:把SDK管理的所有基站的在线键盘设置为开启快速配对功能模式 |
@@ -1028,7 +1638,7 @@ extern"C" __declspec(dllexport) bool GetKeyNameTxt_C100B_S6( | @@ -1028,7 +1638,7 @@ extern"C" __declspec(dllexport) bool GetKeyNameTxt_C100B_S6( | ||
1028 | ULONG KeySN); | 1638 | ULONG KeySN); |
1029 | ``` | 1639 | ``` |
1030 | 1640 | ||
1031 | -### 设置键盘评分[积分] | 1641 | +## 设置键盘评分[积分] |
1032 | 函数名称:SetKeyScore | 1642 | 函数名称:SetKeyScore |
1033 | 功能:设置键盘评分[积分] | 1643 | 功能:设置键盘评分[积分] |
1034 | 参数说明: | 1644 | 参数说明: |
@@ -1051,7 +1661,7 @@ extern"C" __declspec(dllexport) bool SetKeyScore( | @@ -1051,7 +1661,7 @@ extern"C" __declspec(dllexport) bool SetKeyScore( | ||
1051 | char* Score); | 1661 | char* Score); |
1052 | ``` | 1662 | ``` |
1053 | 1663 | ||
1054 | -### 键盘自定义标题字符串[第二行] | 1664 | +## 键盘自定义标题字符串[第二行] |
1055 | 函数名称:SetKeyTitleTxt2 | 1665 | 函数名称:SetKeyTitleTxt2 |
1056 | 功能:设置键盘自定义标题字符串[第二行] | 1666 | 功能:设置键盘自定义标题字符串[第二行] |
1057 | 参数说明: | 1667 | 参数说明: |
@@ -1076,7 +1686,7 @@ extern"C" __declspec(dllexport) bool SetKeyTitleTxt2( | @@ -1076,7 +1686,7 @@ extern"C" __declspec(dllexport) bool SetKeyTitleTxt2( | ||
1076 | const char* Txt); | 1686 | const char* Txt); |
1077 | ``` | 1687 | ``` |
1078 | 1688 | ||
1079 | -### 键盘自定义标题字符串[第三行] | 1689 | +## 键盘自定义标题字符串[第三行] |
1080 | 函数名称:SetKeyTitleTxt3 | 1690 | 函数名称:SetKeyTitleTxt3 |
1081 | 功能:设置键盘自定义标题字符串[第三行] | 1691 | 功能:设置键盘自定义标题字符串[第三行] |
1082 | 参数说明: | 1692 | 参数说明: |
@@ -1099,7 +1709,7 @@ extern"C" __declspec(dllexport) bool SetKeyTitleTxt3( | @@ -1099,7 +1709,7 @@ extern"C" __declspec(dllexport) bool SetKeyTitleTxt3( | ||
1099 | const char* Txt); | 1709 | const char* Txt); |
1100 | ``` | 1710 | ``` |
1101 | 1711 | ||
1102 | -### 键盘自定义评分[积分]和标题字符串[第二行] | 1712 | +## 键盘自定义评分[积分]和标题字符串[第二行] |
1103 | 函数名称:SetKeyScreTxt2 | 1713 | 函数名称:SetKeyScreTxt2 |
1104 | 功能:设置键盘自定义评分[积分]和标题字符串[第二行] | 1714 | 功能:设置键盘自定义评分[积分]和标题字符串[第二行] |
1105 | 参数说明: | 1715 | 参数说明: |
@@ -1128,7 +1738,7 @@ extern"C" __declspec(dllexport) bool SetKeyScreTxt2( | @@ -1128,7 +1738,7 @@ extern"C" __declspec(dllexport) bool SetKeyScreTxt2( | ||
1128 | const char* Txt); | 1738 | const char* Txt); |
1129 | ``` | 1739 | ``` |
1130 | 1740 | ||
1131 | -### 键盘自定义短信 | 1741 | +## 键盘自定义短信 |
1132 | 函数名称:SetKeyMessage | 1742 | 函数名称:SetKeyMessage |
1133 | 功能:设置键盘自定义短信 | 1743 | 功能:设置键盘自定义短信 |
1134 | 参数说明: | 1744 | 参数说明: |
通讯协议-SDK应用部分[内部].md
@@ -487,12 +487,11 @@ params:{} | @@ -487,12 +487,11 @@ params:{} | ||
487 | 487 | ||
488 | |**Json字段**| **字段含义** | **赋值及含义**| | 488 | |**Json字段**| **字段含义** | **赋值及含义**| |
489 | | --- | --- | --- | | 489 | | --- | --- | --- | |
490 | -|bindMode| 签到模式| 1:指定键签到 <br> 2:PIN码签到(默认值) | | ||
491 | -| lessMode | 预留| 0:(默认值)| | 490 | +| bindMode | 签到模式| 1:指定键签到 <br> 2:PIN码签到(默认值) | |
492 | | modifyMode | 修改模式 | 0:不可修改 <br>1:可以修改(默认值)| | 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 | | 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 | | 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 | | tipTitle | 提示标题 | 字符串,长度最多不超过16个字节| | 496 | | tipTitle | 提示标题 | 字符串,长度最多不超过16个字节| |
498 | 497 |