三汇语音卡编程指南：SynCTI驱动与应用

需积分: 31 103 浏览量更新于2024-07-15 收藏 30.57MB PDF 举报

身份认证购VIP最低享 7 折!

30元优惠券

"SynCTI Programmer's Manual_cn.pdf" 是一本针对语音开发的程序员手册，由杭州三汇信息工程有限公司出版。手册涵盖了语音开发接口、常用语音知识、语音转换、语音播放、语音通道通信、耳麦测试、语音回环测试、电话测试、会议模式以及坐席模式等内容，适用于语音开发和软件开发人员。标签提及了语音开发、软件开发、程序员开发手册和源码，表明手册可能包含实际的代码示例和接口详细说明。手册还涉及了Synway系列语音卡的多个版本和操作系统的支持。在手册中，详细介绍了Synway板卡的分类，包括CTI系列和REC系列，以及它们各自的特点和支持的CODEC。编码格式转换的工具函数被提及，意味着开发者可以处理不同编码格式之间的转换。手册还讨论了SynCTI驱动程序对多种操作系统的支持，如Windows等，并解析了驱动程序的体系结构，这对理解如何在不同平台上集成语音功能至关重要。此外，手册还提到了一系列配套的工具软件，如系统配置工具ShCtiConfig.exe用于设置和管理板卡，信号音分析工具ShTA.exe用于分析和识别电话信号音，SS7信令服务器配置程序SS7Cfg.exe和SS7monitor.exe用于处理SS7信令，以及MSU解码工具MsuDecode.exe用于解码MSU数据包。这些工具软件为开发者提供了全面的支持，简化了开发流程。在基础概念部分，手册详细解释了与语音处理相关的术语，如通道（CTI和REC系列的定义）、通道的逻辑编号、数字中继线及其配置、模拟电话线的电压变化、铃流信号、闪断信号、主叫号码等。这部分内容有助于开发者理解和处理实际通信中的各种情况。手册还涵盖了语音处理的实践操作，如语音播放，其中详细阐述了如何设置放音数据音量和方向。这些技术细节对于实现高质量的语音通信服务至关重要。 "SynCTI Programmer's Manual_cn.pdf" 是一个详尽的指南，为开发者提供了在Synway板卡上进行语音应用开发所需的所有信息和技术支持，包括硬件配置、软件接口、信号处理和实际操作步骤。无论是初学者还是经验丰富的开发者，都能从中获益良多，快速掌握Synway语音卡的编程方法。

资源详情

资源推荐

                                                                                                                                  杭  州  三  汇  信  息  工  程  有  限  公  司 
Synway Information Engineering Co., Ltd 
目录
                                                                                                                                                                         
xv 
 
2.9.4.4  SsmRestartPlay ...................................................................................................................... 353 
2.9.4.5  SsmFastFwdPlay .................................................................................................................... 353 
2.9.4.6  SsmFastBwdPlay .................................................................................................................... 354 
2.9.4.7  SsmSetPlayTime ..................................................................................................................... 354 
2.9.4.8  SsmSetPlayPrct ...................................................................................................................... 355 
2.9.4.9  SsmGetDataBytesToPlay ........................................................................................................ 355 
2.9.4.10  SsmGetDataBytesPlayed ........................................................................................................ 356 
2.9.4.11  SsmGetPlayedTimeEx ............................................................................................................ 356 
2.9.4.12  SsmGetPlayingFileInfo ........................................................................................................... 357 
2.9.4.13  SsmPlayFileW ......................................................................................................................... 357 
2.9.5 
播放文件序列的函数
 ......................................................................................................... 358 
2.9.5.1  SsmClearFileList ..................................................................................................................... 358 
2.9.5.2  SsmAddToFileList ................................................................................................................... 358 
2.9.5.3  SsmPlayFileList ...................................................................................................................... 359 
2.9.5.4  SsmStopPlayFileList ............................................................................................................... 360 
2.9.6 
播放单个内存的函数
 ......................................................................................................... 360 
2.9.6.1  SsmPlayMem .......................................................................................................................... 360 
2.9.6.2  SsmStopPlayMem ................................................................................................................... 362 
2.9.6.3  SsmSetStopPlayOffset ............................................................................................................ 362 
2.9.6.4  SsmGetPlayOffset .................................................................................................................. 363 
2.9.7 
播放指定内存序列的函数
 ................................................................................................. 363 
2.9.7.1  SsmAddToPlayMemList .......................................................................................................... 363 
2.9.7.2  SsmClearPlayMemList ............................................................................................................ 364 
2.9.7.3  SsmPlayMemList .................................................................................................................... 364 
2.9.7.4  SsmStopPlayMemList ............................................................................................................. 365 
2.9.8 
播放预加载语音的函数（
CTI
系列）
 ................................................................................ 366 
2.9.8.1  预加载语音信息的初始化函数 ................................................................................................. 366 
2.9.8.1.1  SsmSetMaxIdxSeg .............................................................................................................. 366 
2.9.8.1.2  SsmGetTotalIndexSeg......................................................................................................... 366 
2.9.8.1.3  SsmLoadIndexData ............................................................................................................. 367 
2.9.8.1.4  SsmFreeIndexData ............................................................................................................. 368 
2.9.8.1.5  SsmLoadChIndexData ........................................................................................................ 368 
2.9.8.1.6  SsmFreeChIndexData ......................................................................................................... 369 
2.9.8.2  播放预加载语音的函数 ............................................................................................................ 370 
2.9.8.2.1  SsmPlayIndexString ............................................................................................................ 370 
2.9.8.2.2  SsmPlayIndexList ................................................................................................................ 370 
2.9.8.2.3  SsmStopPlayIndex .............................................................................................................. 371 
2.9.9 
播放乒乓缓存的函数（
CTI
系列）
 ................................................................................... 371 
2.9.9.1  SsmPlayMemBlock ................................................................................................................. 371 
2.9.9.2  SsmStopPlayMemBlock .......................................................................................................... 374 
2.9.10 
终止播放任务的通用函数
 .............................................................................................. 374 
2.9.10.1  SsmStopPlay........................................................................................................................... 374 
2.9.11 
获取播放任务的相关信息
 .............................................................................................. 375 
2.9.11.1  SsmQueryPlayFormat ............................................................................................................. 375 

                                                                                                                                  杭  州  三  汇  信  息  工  程  有  限  公  司 
Synway Information Engineering Co., Ltd 
目录
                                                                                                                                                                         
xvi 
 
9.11.2  SsmGetPlayType .................................................................................................................... 375 
9.11.3  SsmCheckPlay ........................................................................................................................ 376 
9.11.4  SsmGetPlayedPercentage ...................................................................................................... 377 
9.11.5  SsmGetPlayedTime ................................................................................................................ 377 
10  有关录音操作的函数 ............................................................................................................ 378 
10.1 
设置录音操作的参数
 ..................................................................................................... 378 
10.1.1  设置信号源及其音量................................................................................................................ 378 
10.1.1.1  SsmSetRecVolume ........................................................................................................... 378 
10.1.1.2  SpySetRecVolume ............................................................................................................ 378 
10.1.1.3  SsmSetRecMixer .............................................................................................................. 379 
10.1.1.4  SpySetRecMixer ................................................................................................................ 379 
10.1.1.5  SsmQueryOpRecMixer ..................................................................................................... 380 
10.1.1.6  SsmGetRecMixerState ...................................................................................................... 380 
10.1.1.7  DTRSetMixerVolume ......................................................................................................... 381 
10.1.1.8  DTRGetMixerVolume ........................................................................................................ 382 
10.1.1.9  SsmSetRecBack ............................................................................................................... 382 
10.1.1.10  SsmSetNoModuleChBusRec .......................................................................................... 383 
10.1.2  设置录音任务的终止条件 ........................................................................................................ 384 
10.1.2.1  SsmSetDTMFStopRecCharSet ......................................................................................... 384 
10.1.2.2  SsmGetDTMFStopRecCharSet ......................................................................................... 384 
10.1.2.3  SsmSetHangupStopRecFlag ............................................................................................. 385 
10.1.3  设置预录音功能（REC 系列） ................................................................................................ 386 
10.1.3.1  SsmSetPrerecord .............................................................................................................. 386 
10.1.3.2  SsmGetPrerecordState ..................................................................................................... 387 
10.1.4  设置录音文件截尾功能 ............................................................................................................ 387 
10.1.4.1  SsmSetTruncateTail .......................................................................................................... 387 
10.1.4.2  SsmGetTruncateTailTime .................................................................................................. 388 
10.1.5  设置录音 AGC ......................................................................................................................... 389 
10.1.5.1  SsmSetRecAGC ............................................................................................................... 389 
10.1.5.2  SsmGetRecAGCSwitch..................................................................................................... 389 
10.1.6  设置录音立体声开关................................................................................................................ 390 
10.1.6.1  SsmSetRecStereo ............................................................................................................. 390 
10.2 
获取录音操作的信息
 ..................................................................................................... 391 
10.2.1  SsmQueryRecFormat ............................................................................................................. 391 
10.2.2  SsmGetRecType ..................................................................................................................... 391 
10.2.3  SsmGetRecTime ..................................................................................................................... 392 
10.2.4  SsmCheckRecord ................................................................................................................... 392 
10.3 
录制到文件的函数
 ......................................................................................................... 393 
10.3.1  SsmRecToFile ......................................................................................................................... 393 
10.3.2  SsmRecToFileA ...................................................................................................................... 393 
10.3.3  SsmRecToFileB ...................................................................................................................... 393 
10.3.4  SsmRecToFileEx ..................................................................................................................... 393 
10.3.5  SpyRecToFileA ........................................................................................................................ 393 
10.3.6  SpyRecToFileB ........................................................................................................................ 393 

                                                                                                                                  杭  州  三  汇  信  息  工  程  有  限  公  司 
Synway Information Engineering Co., Ltd 
目录
                                                                                                                                                                         
xvii 
 
10.3.7  SpyRecToFile ......................................................................................................................... 393 
10.3.8  SsmStopRecToFile .................................................................................................................. 397 
10.3.9  SpyStopRecToFile .................................................................................................................. 397 
10.3.10  SsmPauseRecToFile ............................................................................................................. 398 
10.3.11  SsmRestartRecToFile ............................................................................................................ 399 
10.3.12  SsmChkRecToFile ................................................................................................................. 399 
10.3.13  SsmGetDataBytesToRecord .................................................................................................. 400 
10.3.14  SsmRecStereoToFile ............................................................................................................. 400 
10.3.15  SsmStopRecStereoToFile ...................................................................................................... 401 
10.3.16  SsmChkStereoToFile ............................................................................................................. 401 
10.3.17  SsmPauseRecToFileEx ......................................................................................................... 402 
10.3.18  SsmRecToFileW .................................................................................................................... 403 
10.3.19  SsmRecToFileAW .................................................................................................................. 403 
10.3.20  SsmRecToFileBW .................................................................................................................. 403 
10.3.21  SsmRecToFileExW ................................................................................................................ 403 
10.4 
录制到指定内存的函数
 .................................................................................................. 403 
10.4.1  SsmRecToMem ....................................................................................................................... 403 
10.4.2  SpyRecToMem ........................................................................................................................ 403 
10.4.3  SsmStopRecToMem ............................................................................................................... 404 
10.4.4  SpyStopRecToMem ................................................................................................................. 405 
10.4.5  SsmGetRecOffset ................................................................................................................... 405 
10.5 
录制到指定乒乓缓存的函数（
CTI
系列）
 ..................................................................... 406 
10.5.1  SsmRecordMemBlock ............................................................................................................ 406 
10.5.2  SsmStopRecordMemBlock ..................................................................................................... 408 
11  有关交换总线的函数 ............................................................................................................ 409 
11.1 
双向连接函数（
CTI
系列）
 ........................................................................................... 409 
11.1.1  建立双向连接 .......................................................................................................................... 409 
11.1.1.1  SsmTalkWith ..................................................................................................................... 409 
11.1.1.2  SsmTalkWithEx ................................................................................................................. 409 
11.1.2  拆除双向连接 .......................................................................................................................... 410 
11.1.2.1  SsmStopTalkWith............................................................................................................... 410 
11.2 
单向连接函数
 ................................................................................................................ 411 
11.2.1  建立单向连接 ........................................................................................................................... 411 
11.2.1.1  SsmListenTo ....................................................................................................................... 411 
11.2.1.2  SsmListenToEx ................................................................................................................... 411 
11.2.1.3  SsmLinkFrom ..................................................................................................................... 411 
11.2.1.4  SsmLinkFromEx ................................................................................................................. 411 
11.2.1.5  SsmLinkFromAllCh ............................................................................................................. 411 
11.2.2  拆除单向连接 .......................................................................................................................... 413 
11.2.2.1  SsmStopListenTo ............................................................................................................... 413 
11.2.2.2  SsmStopLinkFrom ............................................................................................................. 413 
11.2.2.3  SsmUnLinkFromAllCh ....................................................................................................... 413 
11.3 
获取总线信息函数
 ......................................................................................................... 414 
11.3.1  SsmGetChBusInfo .................................................................................................................. 414 

                                                                                                                                  杭  州  三  汇  信  息  工  程  有  限  公  司 
Synway Information Engineering Co., Ltd 
目录
                                                                                                                                                                         
xviii 
 
2.11.4 
高级总线操作函数（
CTI
系列）
 .................................................................................... 415 
2.11.4.1  强制拆除通道的所有总线连接 ................................................................................................. 415 
2.11.4.1.1  SsmClearChBusLink ......................................................................................................... 415 
2.11.4.2  通道到总线时隙的单向连接 ..................................................................................................... 416 
2.11.4.2.1  SsmLinkToBus ................................................................................................................... 416 
2.11.4.2.2  SsmUnLinkToBus .............................................................................................................. 416 
2.11.4.3  总线时隙到通道的单向连接 ..................................................................................................... 417 
2.11.4.3.1  SsmLinkFromBus .............................................................................................................. 417 
2.11.4.3.2  SsmLinkFromBusEx .......................................................................................................... 417 
2.11.4.3.3  SsmUnLinkFromBus .......................................................................................................... 418 
2.11.4.3.4  SsmListenToPlay ............................................................................................................... 419 
2.11.4.3.5  SsmUnListenToPlay .......................................................................................................... 419 
2.12  有关板载音频功率放大器的函数 .......................................................................................... 420 
2.12.1  SsmQueryOpPowerAmp .............................................................................................. 420 
2.12.2  SsmSetPowerAmpVlm ................................................................................................. 420 
2.12.3  SetVolume .................................................................................................................... 420 
2.13  有关板载扬声器的函数 ........................................................................................................ 421 
2.13.1  SsmSetLine0OutTo ...................................................................................................... 421 
2.14  有关回波抵消器（Echo Canceller）的函数（CTI 系列） ................................................... 422 
2.14.1 
设置回波抵消器的工作状态
........................................................................................... 422 
2.14.1.1  SsmQueryOpEchoCanceller ................................................................................................... 422 
2.14.1.2  SsmSetEchoCanceller ............................................................................................................ 422 
2.14.1.3  SsmGetEchoCancellerState .................................................................................................... 423 
2.14.2 
设置回波抵消器的工作参数
........................................................................................... 423 
2.14.2.1  SsmSetEchoCancelDelaySize ................................................................................................ 423 
2.14.2.2  SsmGetEchoCancelDelaySize ................................................................................................ 424 
2.15  有关电话会议的函数（CTI 系列） ....................................................................................... 425 
2.15.1 
会议室初始化函数
 ......................................................................................................... 425 
2.15.1.1  SsmCreateConfGroup ............................................................................................................ 425 
2.15.1.2  SsmFreeConfGroup ................................................................................................................ 425 
2.15.2 
会议室成员操作函数
 ..................................................................................................... 426 
2.15.2.1  SsmJoinConfGroup ................................................................................................................. 426 
2.15.2.2  SsmExitConfGroup ................................................................................................................. 427 
2.15.2.3  SsmSetListenVlmInConf ......................................................................................................... 427 
2.15.2.4  SsmSetContactInConf............................................................................................................. 428 
2.15.3 
获取会议室信息的函数
 .................................................................................................. 428 
2.15.3.1  SsmGetConfCfgInfo ................................................................................................................ 428 
2.15.3.2  SsmGetTotalConfGroup .......................................................................................................... 429 
2.15.3.3  SsmGetConfGrpCfgInfo .......................................................................................................... 429 
2.15.3.4  SsmGetConfGrpInfo ............................................................................................................... 430 
2.15.3.5  SsmGetConfGrpId .................................................................................................................. 430 
2.15.3.6  SsmValidateGrpId ................................................................................................................... 431 
2.15.4 
获取会议室成员信息的函数
........................................................................................... 431 
2.15.4.1  SsmGetConfGrpMmbrId ......................................................................................................... 431 

                                                                                                                                  杭  州  三  汇  信  息  工  程  有  限  公  司 
Synway Information Engineering Co., Ltd 
目录
                                                                                                                                                                         
xix 
 
2.15.4.2  SsmGetConfGrpMmbrInfo ...................................................................................................... 432 
2.15.4.3  SsmGetConfChInfo ................................................................................................................. 432 
2.16  有关 FSK 收发器的函数（CTI 系列） ................................................................................. 433 
2.16.1  FSK
数据发送器
 ............................................................................................................ 433 
2.16.1.1  SsmSetFskPara ...................................................................................................................... 433 
2.16.1.2  SsmGetFskPara ...................................................................................................................... 434 
2.16.1.3  SsmTransFskData .................................................................................................................. 434 
2.16.1.4  SsmStartSendFSK .................................................................................................................. 435 
2.16.1.5  SsmCheckSendFsk ................................................................................................................ 436 
2.16.1.6  SsmStopSendFsk ................................................................................................................... 436 
2.16.2  FSK
数据接收器
 ............................................................................................................ 437 
2.16.2.1  SsmStartRcvFSK .................................................................................................................... 437 
2.16.2.2  SsmStartRcvFSK_II ................................................................................................................ 438 
2.16.2.3  SsmStartRcvFSK_III ............................................................................................................... 440 
2.16.2.4  SsmCheckRcvFSK ................................................................................................................. 441 
2.16.2.5  SsmStopRcvFSK .................................................................................................................... 442 
2.16.2.6  SsmClearRcvFSKBuf .............................................................................................................. 442 
2.16.2.7  SsmGetRcvFSK ...................................................................................................................... 443 
2.17  有关电压检测器的函数 ........................................................................................................ 444 
2.17.1 
忽略电压检测结果
 ......................................................................................................... 444 
2.17.1.1  SsmSetIgnoreLineVoltage ....................................................................................................... 444 
2.17.1.2  SsmGetIgnoreLineVoltage ...................................................................................................... 444 
2.17.2 
设置检测摘机
/
挂机动作的门限电压
 ............................................................................... 445 
2.17.2.1  SsmSetDtrmLineVoltage ......................................................................................................... 445 
2.17.2.2  SsmGetDtrmLineVoltage ......................................................................................................... 445 
2.17.3 
获取电压检测器的输出结果
........................................................................................... 446 
2.17.3.1  SsmGetLineVoltage ................................................................................................................ 446 
2.17.4 
有关极性反转检测器的函数
........................................................................................... 446 
2.17.4.1  SsmQueryOpPolarRvrs .......................................................................................................... 446 
2.17.4.2  SsmGetPolarRvrsCount .......................................................................................................... 447 
2.17.5 
有关铃流信号检测器的函数
........................................................................................... 448 
2.17.5.1  SsmGetRingCount .................................................................................................................. 448 
2.17.5.2  SsmGetCallBackRingCount .................................................................................................... 448 
2.17.5.3  SsmClearRingCount ............................................................................................................... 449 
2.17.5.4  SsmGetRingFlag ..................................................................................................................... 449 
2.18  有关数字中继线信息的函数 ................................................................................................. 450 
2.18.1  SsmGetMaxPcm ........................................................................................................... 450 
2.18.2  SsmGetPcmInfo ............................................................................................................ 450 
2.18.3  SsmGetPcmLinkStatus ................................................................................................. 451 
2.18.4  SsmPcmTsToCh ........................................................................................................... 453 
2.18.5  SsmChToPcmTs ........................................................................................................... 453 
2.18.6  SsmSetPcmClockMode ................................................................................................ 454 
2.18.7  SsmGetInboundLinkSet ................................................................................................ 454 
2.18.8  SsmGetCbChStatus ...................................................................................................... 455 