CC301参数定义文档

1 通用参数

#define QNV_DLL_VER 0x0106 #define QNV_DLL_VER_STR \

#define QNV_CC_LICENSE \

//播放/录音回调时如果返回该值，系统将自动删除该回调模块，下次将不会被回调 #define CB_REMOVELIST (-1)

#define MULTI_SEPA_CHAR '|'//多个文件播放列表分割符号 #define PROXYDIAL_SIGN 0x40000000//代拨标记 #define PROXYDIAL_SIGN_STRU 'P'//代拨标记 #define PROXYDIAL_SIGN_STRL 'p'//代拨标记

#define RING_BEGIN_SIGN_STR \#define RING_END_SIGN_STR \#define RING_BEGIN_SIGN_CH '0' #define RING_END_SIGN_CH '1'

#define RINGBACK_TELDIAL_STR \#define RINGBACK_PCDIAL_STR \#define RINGBACK_PCDIAL_CH '1' #define RINGBACK_TELDIAL_CH '0'

#define DEFAULT_FLASH_ELAPSE 600 //默认拍插簧间隔时间(ms) #define DEFAULT_FLASHFLASH_ELAPSE 1000 //默认拍插簧后间隔一定时间回调事件ms #define DEFAULT_RING_ELAPSE 1000 //默认给内部话机/交换机震铃时间ms响 1秒 #define DEFAULT_RINGSILENCE_ELAPSE 4000 //默认给内部话机/交换机震铃后停止ms 4秒 #define DEFAULT_RING_TIMEOUT 12 //默认给内线震铃超时次数,每次1秒响4秒停,总共时间就为N*5 #define DEFAULT_REFUSE_ELAPSE 500 //拒接时默认使用间隔(ms) #define DEFAULT_DIAL_SPEED 75 //默认拨号速度ms #define DEFAULT_DIAL_SILENCE 75 //默认号码之间静音时间ms

#define DEFAULT_CHECKDIALTONE_TIMEOUT 3000 //检测拨号音超时就强制呼叫ms #define DEFAULT_CALLINTIMEOUT //来电响铃超时ms #define DIAL_DELAY_SECOND //拨号时号码之间延迟1秒 #define DIAL_DELAY_HSECOND //拨号时号码之间延迟0.5秒 #define DIAL_CHECK_CITYCODE //拨号时该符号后自动过滤城市区号 #define CC_PARAM_SPLIT //CC参数的分隔符号

//自动创建录音文件时的默认目录名 #define RECFILE_DIR //配置信息里的KEY #define INI_QNVICC //默认配置文件名 #define INI_FILENAME //VOIP代拨标记 #define CC_VOIP_SIGN //匿名登陆CC,密码跟号码为相同 #define WEB_802ID

//支持的最多USB芯片数 #define MAX_USB_COUNT //支持的最多通道数 #define MAX_CHANNEL_COUNT //location返回的最大长度 #define OUTVALUE_MAX_SIZE

2 通道定义

//声卡控制有效通道ID号,0->255为USB设备通道号#define SOUND_CHANNELID //远程通信通道,HTTP上传/下载 #define REMOTE_CHANNELID //CC控制通道 #define CCCTRL_CHANNELID //socket 服务器端通道 #define SOCKET_SERVER_CHANNELID //socket 终端通道

5500 ',' '.' ':' ',' \ \ \ \\ 64 128 260 256 257 258

259

#define SOCKET_CLIENT_CHANNELID //UDP通道 #define SOCKET_UDP_CHANNELID //ICC301虚拟声卡驱动控制 #define AUDRV_CHANNELID

//CC发送消息的最大长度 #define MAX_CCMSG_LEN //CC发送命令的最大长度 #define MAX_CCCMD_LEN

3 设备类型

//cc301系列 #define DEVTYPE_T1

#define DEVTYPE_T2 #define DEVTYPE_T3 #define DEVTYPE_T4 #define DEVTYPE_T5 #define DEVTYPE_T6

//8-I系列/1-单路/0-R系列/1-A系列第1个 #define DEVTYPE_IR1 #define DEVTYPE_ID1 //8-I系列/1-单路/1-A系列/1-A系列第1个 #define DEVTYPE_IA1 #define DEVTYPE_IA2 #define DEVTYPE_IA3 #define DEVTYPE_IA4 #define DEVTYPE_IA4_F //8-I系列/1-单路/2-B系列/1-A系列第1个 #define DEVTYPE_IB1 #define DEVTYPE_IB2 #define DEVTYPE_IB3 #define DEVTYPE_IB4 //8-I系列/1-单路/3-P系列/1-A系列第1个 #define DEVTYPE_IP1 #define DEVTYPE_IP1_F //2路设备 #define DEVTYPE_IC2_R

260 261 262

400 400

0x1009 0x1000 0x1008 0x1005 0x1001 0x1004

0x8100 0x8102 0x8111 0x8112 0x8113 0x8114 0x8115 0x8121 0x8122 0x8123 0x8124 0x8131 0x8132 0x8200

#define DEVTYPE_IC2_LP #define DEVTYPE_IC2_LPQ #define DEVTYPE_IC2_LPF //4路设备 #define DEVTYPE_IC4_R #define DEVTYPE_IC4_LP #define DEVTYPE_IC4_LPQ #define DEVTYPE_IC4_LPF //7路设备 #define DEVTYPE_IC7_R #define DEVTYPE_IC7_LP #define DEVTYPE_IC7_LPQ #define DEVTYPE_IC7_LPF

#define DEVTYPE_Z2 //以下为玻瑞器系列 #define DEVTYPE_A1 #define DEVTYPE_A2 #define DEVTYPE_A3 #define DEVTYPE_A4 #define DEVTYPE_B1 #define DEVTYPE_B2 #define DEVTYPE_B3 #define DEVTYPE_B4 #define DEVTYPE_C4_L #define DEVTYPE_C4_P #define DEVTYPE_C4_LP #define DEVTYPE_C4_LPQ #define DEVTYPE_C7_L #define DEVTYPE_C7_P #define DEVTYPE_C7_LP #define DEVTYPE_C7_LPQ #define DEVTYPE_R1 #define DEVTYPE_C_PR

0x8203 0x8207 0x8211 0x8400 0x8403 0x8407 0x8411 0x8700 0x8703 0x8707 0x8711

0x9001//OEM芯片开发板 0x1100000 0x1200000 0x1300000 0x1400000 0x2100000 0x2200000 0x2300000 0x2400000 0x3100000 0x3200000 0x3300000 0x3400000 0x3500000 0x3600000 0x3700000 0x3800000 0x4100000 0x4200000

4 设备功能模块定义

//是否具有内置喇叭功能

//可以PC播放语音到喇叭/通话时线路声音到喇叭 #define DEVMODULE_DOPLAY 0x1

//是否具有可接入外线获取来电号码(FSK/DTMF双制式)/通话录音功能

//可以来电弹屏/通话录音/通话时获取对方按键(DTMF) #define DEVMODULE_CALLID 0x2 //是否具有可接入话机进行PSTN通话功能

//可以使用电话机进行PSTN通话/获取话机拨出的号码 #define DEVMODULE_PHONE 0x4 //是否具有继电器切换断开/接通话机功能

//断开话机后可以:来电时话机不响铃/使用话机MIC独立采集录音配合DEVFUNC_RING模块给话机模拟来电震铃 #define DEVMODULE_SWITCH 0x8

//PC播放语音给话机听筒,具有 DEVMODULE_SWITCH模块,switch后播放语音到话机听筒 #define DEVMODULE_PLAY2TEL 0x10 //是否具有话机摘机后拨号/放音给线路的功能

//可以使用PC自动摘机进行拨号/通话时可以给对方播放语音/来电留言/外拨通知/来电IVR(语音答录) #define DEVMODULE_HOOK 0x20 //是否具有插入MIC/耳机功能

//可以用MIC/耳机进行PSTN通话/使用MIC独立录音/PC播放语音给耳机 #define DEVMODULE_MICSPK 0x40 //是否具有让接在phone口的设备(电话机,交换机等)模拟震铃功能

//可以任意时刻让phone口的设备模拟来电震铃.如:在来电IVR(语音答录)之后进入工服务时给内部话机或交换机模拟震铃 #define DEVMODULE_RING 0x80 //是否具有接收/发送传真功能

//可以发送图片,文档到对方的传真机/可以接收保存对方传真机发送过来的图片 #define DEVMODULE_FAX 0x100 //具有级性反转检测对方摘机的功能

//如果PSTN线路在当地电信部门同时开通该级性反转检测服务,就可以在外拨时精确检测到对方摘机/挂机

//如果没有该功能,只有拨打的号码具有标准回铃才才能检测到对方摘机,对手机彩铃,IP等不具有标准回铃线路的不能检测对方摘机/挂机 #define DEVMODULE_POLARITY 0x800 //----------------------------------------------------------------

5 函数宏定义参数 5.1 打开设备类型

#define #define #define

ODT_LBRIDGE ODT_SOUND ODT_CC

0x0//CC301设备 0x1//声卡 0x2//CC模块

5.28 cc 消息参数

//具体字体参数意义请查看windows相关文档 #define MSG_KEY_CC #define MSG_KEY_NAME #define MSG_KEY_TIME #define MSG_KEY_FACE #define MSG_KEY_COLOR #define MSG_KEY_SIZE #define MSG_KEY_CHARSET #define MSG_KEY_EFFECTS #define MSG_KEY_LENGTH //CC文件参数 #define MSG_KEY_FILENAME #define MSG_KEY_FILESIZE #define MSG_KEY_FILETYPE

#define MSG_KEY_CALLPARAM

#define MSG_KEY_SPLIT #define MSG_TEXT_SPLIT 号 //

\消息来源CC号

\消息来源名称，保留 \消息来源时间 \字体名称 \字体颜色 \字体尺寸 \字体特征 \字体效果 \消息正文长度 \文件名 \文件长度 \文件类型

\呼叫时的参数

\参数之间分隔符号

\消息参数和消息内容的分隔符

6 事件结构定义

#define MAX_BRIEVENT_DATA 512//事件产生后保存的数据最大长度

typedef struct tag_BriEvent_Data { BRICHAR8 uVersion;//结构版本，保留 BRICHAR8 uReserv;//保留 BRIINT16 uChannelID;//通道ID BRIINT32 lEventType;//事件类型ID 查看BRI_EVENT.lEventType Define BRIINT32 lEventHandle;//事件相关句柄 BRIINT32 lResult;//事件相关数值 BRIINT32 lParam;//保留,扩展时使用 BRICHAR8 szData[MAX_BRIEVENT_DATA];//事件相关数据.如：来电时，保存了来电的号码 BRICHAR8 szDataEx[32];//保留,扩展时使用 }BRI_EVENT,*PBRI_EVENT;

7 回调函数原型

//

//缓冲播放回调原型 //uChannelID:通道ID

//dwUserData:用户自定义的数据 //lHandle:播放时返回的句柄 //lDataSize:当前缓冲的语音数据 //lFreeSize:当前缓冲的空闲长度

//返回 CB_REMOVELIST(-1) 将被系统删除该回调资源，下次不再回调/返回其它值保留 typedef BRIINT32 (CALLBACK *PCallBack_PlayBuf)(BRIINT16 uChannelID,BRIUINT32 dwUserData,BRIINT32 lHandle,BRIINT32 lDataSize,BRIINT32 lFreeSize); ///////////////////////////////////////////////////////////////////////////////////////////////////////////

////////////////////////////////////////////////////////////////////////////////////////////////////////// //设置文件播放回调原型 //uChannelID:通道ID

//nPlayState:文件播放的状态,PLAYING/REPLAY/END //dwUserData:用户自定义的数据 //lHandle:播放时返回的句柄

//lElapses:总共播放的时间(单位秒)

//返回 CB_REMOVELIST(-1) 系统将自动停止播放该文件/返回其它值保留

typedef BRIINT32 (CALLBACK *PCallBack_PlayFile)(BRIINT16 uChannelID,BRIUINT32 nPlayState,BRIUINT32 dwUserData,BRIINT32 lHandle,BRIINT32 lElapses);

////////////////////////////////////////////////////////////////////////////////////////// //缓冲录音回调原型 默认格式为8K/16位/单声道/线性 //uChannelID:通道ID

//dwUserData:用户自定义数据 //pBufData:语音数据

//lBufSize:语音数据的内存字节长度

//返回 CB_REMOVELIST(-1) 将被系统删除该回调资源，下次不再回调/返回其它值保留 typedef BRIINT32 (CALLBACK *PCallBack_RecordBuf)(BRIINT16 uChannelID,BRIUINT32 dwUserData,BRIBYTE8 *pBufData,BRIINT32 lBufSize); ////////////////////////////////////////////////////////////////////////////////////////////

////////////////////////////////////////////////////////////////////////////////////////// //事件发生回调原型 //uChannelID:通道ID

//dwUserData:用户自定义数据

//lType:事件类型ID 查看BRI_EVENT.lEventType Define //lResult:事件相关数据 //szData:事件相关数据

/////////////////////////////////////////////////////////////////////////////////////////

typedef BRIINT32 (CALLBACK *PCallBack_Event)(BRIINT16 uChannelID,BRIUINT32 dwUserData,BRIINT32 lType,BRIINT32 lHandle,BRIINT32 lResult, BRIINT32 lParam, BRIPCHAR8 pData,BRIPCHAR8 pDataEx);

////////////////////////////////////////////////////////////////////////////////////////// //事件发生回调原型,使用结构体方式 //pEvent:事件结构体数据

//dwUserData:用户自定义数据

//备注:和PCallBack_Event只要使用其中一种凡是就可以了 /////////////////////////////////////////////////////////////////////////////////////////

typedef BRIINT32 (CALLBACK *PCallBack_EventEx)(PBRI_EVENT pEvent,BRIUINT32 dwUserData);

////////////////////////////////////////////////////////////////////// // BRI_EVENT.lEventType Define

8 事件类型定义

//同步与系统发出的窗口消息(请选择其中一种方式处理)

// 本地电话机摘机事件

#define BriEvent_PhoneHook 1 // 本地电话机挂机事件 #define BriEvent_PhoneHang 2

// 外线通道来电响铃事件 // BRI_EVENT.lResult 为响铃次数 // BRI_EVENT.szData[0]='0' 开始1秒响铃

// BRI_EVENT.szData[0]='1' 为1秒响铃完成，开始4秒静音 #define BriEvent_CallIn 3

// 得到来电号码

// BRI_EVENT.lResult 来电号码模式(CALLIDMODE_FSK/CALLIDMODE_DTMF // BRI_EVENT.szData 保存的来电号码 // 该事件可能在响铃前,也可能在响铃后 #define BriEvent_GetCallID 4

// 对方停止呼叫(产生一个未接电话) #define BriEvent_StopCallIn 5

// 调用开始拨号后，全部号码拨号结束 #define BriEvent_DialEnd 6

// 播放文件结束事件

// BRI_EVENT.lEventHandle 播放文件时返回的句柄ID #define BriEvent_PlayFileEnd 7

// 多文件连播结束事件 //

#define BriEvent_PlayMultiFileEnd 8

//播放字符结束

#define BriEvent_PlayStringEnd 9

// 播放文件结束准备重复播放

// BRI_EVENT.lEventHandle 播放文件时返回的句柄ID //

#define BriEvent_RepeatPlayFile 10

// 给本地PHONE设备发送震铃信号时发送号码结束 #define BriEvent_SendCallIDEnd 11

//给本地PHONE设备发送震铃信号时超时

//默认响DEFAULT_RING_TIMEOUT(12)次后超时 #define BriEvent_RingTimeOut 12

//给本地PHONE设备正在震铃

// BRI_EVENT.lResult 已经响铃的次数 // BRI_EVENT.szData[0]='0' 开始一次响铃

// BRI_EVENT.szData[0]='1' 一次响铃完成，准备静音 #define BriEvent_Ringing 13

// 通话时检测到一定时间的静音.默认为5秒 #define BriEvent_Silence 14

// 线路接通时收到DTMF码事件

// 该事件不能区分通话中是本地话机按键还是对方话机按键触发 #define BriEvent_GetDTMFChar 15

// 拨号后,被叫方摘机事件（该事件仅做参考,原因如下：） // 原因：

// 该事件只适用于拨打是标准信号音的号码时，也就是拨号后带有标准回铃音的号码。 // 如：当拨打的对方号码是彩铃(彩铃手机号)或系统提示音(179xx)都不是标准回铃音时该事件无效。

//

// 反极信号是模拟线路中唯一可靠的判断对方摘机的方法，只是一方面需要开通才有该功能，另一方面在有些地方，即使申请也未必受理，因为该功能原本是针对公用电话计费的。 // 没有该功能，利用信号音做判断依据，但可靠性不能做到100％，尤其是在被叫方为彩铃时，检测率很低

// 拥有反级服务方式一：向电信的PSTN线路申请开通,该方式操作性不强,原因如上所述 // 拥有反级服务方式二：购买一个手机sim/3g卡,再购买一个带反级服务的sim/3g平台设备(200人民币左右),该设备会引出一个电话线接入到USB设备 // BRI_EVENT.lResult : 0 为语音信号分析的结果 // BRI_EVENT.lResult : 1 为反级检测的结果 #define BriEvent_RemoteHook 16

// 挂机事件

// 如果线路检测到被叫方摘机后，被叫方挂机时会触发该事件，不然被叫方挂机后就触发BriEvent_Busy事件

// 该事件或者BriEvent_Busy的触发都表示PSTN线路已经被断开

// 备注：该事件是根据线路的忙音信号检测，如果没有忙音就不会触发该事件 // 如果有反级服务就为可靠提示

// BRI_EVENT.lResult : 0 为语音信号分析的结果 // BRI_EVENT.lResult : 1 为反级检测的结果 #define BriEvent_RemoteHang 17

// 检测到忙音事件,表示PSTN线路已经被断开 #define BriEvent_Busy 18

// 本地摘机后检测到拨号音 #define BriEvent_DialTone 19

// 只有在本地话机摘机，没有调用软摘机时，检测到DTMF拨号 #define BriEvent_PhoneDial 20

// 电话机拨号结束呼出事件。

// 也就时电话机拨号后接收到标准回铃音或者15秒超时

// BRI_EVENT.lResult=0 检测到回铃音// 注意：如果线路是彩铃是不会触发该类型 // BRI_EVENT.lResult=1 拨号超时

// BRI_EVENT.lResult=2 动态检测拨号码结束(根据中国大陆的号码规则进行智能分析，仅做参考)

// BRI_EVENT.szData[0]='1' 软摘机拨号结束后回铃了 // BRI_EVENT.szData[0]='0' 电话机拨号中回铃了 #define BriEvent_RingBack 21

// MIC插入状态

// 只适用具有该功能的设备 #define BriEvent_MicIn 22

// MIC拔出状态

// 只适用具有该功能的设备 #define BriEvent_MicOut 23

// 拍插簧(Flash)完成事件，拍插簧完成后可以检测拨号音后进行二次拨号 // BRI_EVENT.lResult=TEL_FLASH 用户使用电话机进行拍叉簧完成 // BRI_EVENT.lResult=SOFT_FLASH 调用StartFlash函数进行拍叉簧完成 #define BriEvent_FlashEnd 24

// 拒接完成

#define BriEvent_RefuseEnd 25

// 语音识别完成

#define BriEvent_SpeechResult 26

//PSTN线路断开,线路进入空闲状态 //当前没有软摘机而且话机也没摘机 #define BriEvent_PSTNFree 27

// 接收到对方准备发送传真的信号 #define BriEvent_RemoteSendFax 30

// 接收传真完成

#define BriEvent_FaxRecvFinished 31 // 接收传真失败

#define BriEvent_FaxRecvFailed 32

// 发送传真完成

#define BriEvent_FaxSendFinished 33 // 发送传真失败

#define BriEvent_FaxSendFailed 34

// 启动声卡失败

#define BriEvent_OpenSoundFailed 35

// 产生一个PSTN呼入/呼出日志 #define BriEvent_CallLog 36

//检测到连续的静音

//使用QNV_GENERAL_CHECKSILENCE启动后检测到设定的静音长度 #define BriEvent_RecvSilence 37

//检测到连续的声音

//使用QNV_GENERAL_CHECKVOICE启动后检测到设定的语音长度

#define BriEvent_RecvVoice 38

//远程上传事件

// BRI_EVENT.lResult 启动上传时返回的本次操作的句柄

// http 服务器接收到数据后返回Result:1 终端将接收到该事件，否则返回失败 #define BriEvent_UploadSuccess 50

#define BriEvent_UploadFailed 51 // 远程连接已被断开

#define BriEvent_RemoteDisconnect 52

//HTTP远程下载文件完成

//BRI_EVENT.lResult 启动下载时返回的本次操作的句柄 #define BriEvent_DownloadSuccess 60 #define BriEvent_DownloadFailed 61 //等候播放远程数据

#define BriEvent_PlayRemoteWait 62

//线路检测结果

//BRI_EVENT.lResult 为检测结果信息 //1:能软拨号 //2:线路没接反

//3:能软拨号而且线路没接反 #define BriEvent_CheckLine 70

// 应用层调用软摘机/软挂机成功事件 // BRI_EVENT.lResult=1 软摘机 // BRI_EVENT.lResult=0 软挂机 #define BriEvent_EnableHook 100 // 喇叭被打开或者/关闭

// BRI_EVENT.lResult=0 关闭 // BRI_EVENT.lResult=1 打开 #define BriEvent_EnablePlay 101 // MIC被打开或者关闭

// BRI_EVENT.lResult=0 关闭 // BRI_EVENT.lResult=1 打开 #define BriEvent_EnableMic 102 // 耳机被打开或者关闭

// BRI_EVENT.lResult=0 关闭 // BRI_EVENT.lResult=1 打开 #define BriEvent_EnableSpk 103 // 电话机跟电话线(PSTN)断开/接通(DoPhone) // BRI_EVENT.lResult=0 断开 // BRI_EVENT.lResult=1 接通

#define BriEvent_EnableRing 104 // 修改输入的线路line通道

// BRI_EVENT.lResult= linein id值 #define BriEvent_SelectLineIn 105 // 开始软件拨号

// BRI_EVENT.szData 准备拨的号码

// BRI_EVENT.lResult=0 拨号前准备检测拨号音 // BRI_EVENT.lResult=1 检测到拨号音开始拨号

// BRI_EVENT.lResult=2 未检测到拨号音开始强制拨号(QNV_PARAM_DIALTONERESULT=2时触发)

// BRI_EVENT.lResult=3 未检测到拨号音,拨号失败，不再进行拨号了(QNV_PARAM_DIALTONERESULT=3时触发) #define BriEvent_DoStartDial 106 // 喇叭语音通道被选择

// BRI_EVENT.lResult= 选择的mux值 #define BriEvent_EnablePlayMux 107 //改变设备控制状态

#define BriEvent_DevCtrl 110

//在通话状态中接收到拨号音

//如果是来电响铃后刚拿起话机一定时间内检测到,应用层可以考虑认为是刚才电话已经未接,本次拿起话机属于去电

#define BriEvent_DialToneEx 193

// 接收到DTMF,不区分是拨号还是通话中,所有接收到的DTMF事件都回调 // BRI_EVENT.szData 号码 // 建议一般用户不需要使用 #define BriEvent_RecvedDTMF 194

//设备可能被拔掉了,效果相当于BriEvent_DevErr事件时的BRI_EVENT.lResult=3 #define BriEvent_PlugOut 195 //硬解码来电 // 保留

#define BriEvent_CallInEx 196 // 重新打开设备成功 // 保留

#define BriEvent_ReopenSucccess 197 // 接收到号码,包括通话中FSK // BRI_EVENT.szData 号码

//保留，内部使用，建议一般用户不需要使用 #define BriEvent_RecvedFSK 198 //设备异常错误

//BRI_EVENT.lResult=3 表示设备可能被移除了,必须关闭后重新打开设备才可以正常使用 //其它可以忽略不做处理 #define BriEvent_DevErr 199

//CCCtrl Event

//CC控制相关事件

#define BriEvent_CC_ConnectFailed 200//连接失败 #define BriEvent_CC_LoginFailed 201//登陆失败 #define BriEvent_CC_LoginSuccess 202//登陆成功 #define BriEvent_CC_SystemTimeErr 203//系统时间错误 #define BriEvent_CC_CallIn 204//有CC呼入请求 #define BriEvent_CC_CallOutFailed 205//呼叫失败 #define BriEvent_CC_CallOutSuccess 206//呼叫成功，正在呼叫 #define BriEvent_CC_Connecting 207//呼叫正在连接 #define BriEvent_CC_Connected 208//呼叫连通 #define BriEvent_CC_CallFinished 209//呼叫结束 #define BriEvent_CC_ReplyBusy 210//对方回复忙过来 #define BriEvent_CC_GetDTMF 211//接收到DTMF #define BriEvent_CC_PlayFileEnd 212//播放文件结束

// BRI_EVENT.szData 保存消息相关信息 #define BriEvent_CC_RecvedMsg 220//接收到用户即时消息 // BRI_EVENT.szData 保存命令相关信息 #define BriEvent_CC_RecvedCmd 221//接收到用户自定义命令

#define BriEvent_CC_RegSuccess 225//注册CC成功 #define BriEvent_CC_RegFailed 226//注册CC失败

#define BriEvent_CC_RecvFileRequest 230//接收到用户发送的文件请求 #define BriEvent_CC_TransFileFinished 231//传输文件结束

#define BriEvent_CC_AddContactSuccess 240//增加好友成功 #define BriEvent_CC_AddContactFailed 241//增加好友失败 #define BriEvent_CC_InviteContact 242//接收到增加好好友邀请 #define BriEvent_CC_ReplyAcceptContact 243//对方回复同意为好友 #define BriEvent_CC_ReplyRefuseContact 244//对方回复拒绝为好友 #define BriEvent_CC_AcceptContactSuccess 245//接受好友成功 #define BriEvent_CC_AcceptContactFailed 246//接受好友失败 #define BriEvent_CC_RefuseContactSuccess 247//拒绝好友成功 #define BriEvent_CC_RefuseContactFailed 248//拒绝好友失败 #define BriEvent_CC_DeleteContactSuccess 249//删除好友成功 #define BriEvent_CC_DeleteContactFailed 250//删除好友失败 #define BriEvent_CC_ContactUpdateStatus 251//好友登陆状态改变

#define BriEvent_CC_ContactDownendStatus 252//获取到所有好友改变完成

#define BriEvent_EndID 300//空ID

9 消息定义说明

////////////////////////////////////////////////////////////// // WM_USER为windows系统定义值 1024 #define BRI_EVENT_MESSAGE #define BRI_RECBUF_MESSAGE ////消息定义结束

(WM_USER+2000)//事件消息

(WM_USER+2001)//缓冲录音数据

10 语音文件编码格式ID

0 //16k/s 1 // 8k/s 2 // 8k/s 3 // 4k/s 4 // 8k/s 5 //16k/s 6 //~1.2k/s 7 //~2.4k/s 8 //~1.5k/s 9 //~2.2k/s 255 //无效ID

// 默认为BRI_AUDIO_FORMAT_PCM8K16B #define BRI_WAV_FORMAT_DEFAULT #define BRI_WAV_FORMAT_ALAW8K #define BRI_WAV_FORMAT_ULAW8K #define BRI_WAV_FORMAT_IMAADPCM8K4B #define BRI_WAV_FORMAT_PCM8K8B #define BRI_WAV_FORMAT_PCM8K16B #define BRI_WAV_FORMAT_MP38K8B #define BRI_WAV_FORMAT_MP38K16B #define BRI_WAV_FORMAT_TM8K1B #define BRI_WAV_FORMAT_GSM6108K #define BRI_WAV_FORMAT_END //保留最多256个

////////////////////////////////////////////////////////////

11 函数操作类型值

//----------------------------------------------------------------------------------

11.1 设备信息

#define #define #define #define #define #define

QNV_DEVINFO_GETCHIPTYPE QNV_DEVINFO_GETCHIPS QNV_DEVINFO_GETTYPE QNV_DEVINFO_GETMODULE QNV_DEVINFO_GETCHIPCHID QNV_DEVINFO_GETSERIAL

1 2 3 4 5 6

#define QNV_DEVINFO_GETCHANNELS #define QNV_DEVINFO_GETDEVID #define QNV_DEVINFO_GETDLLVER #define QNV_DEVINFO_GETCHIPCHANNEL #define QNV_DEVINFO_GETCHANNELTYPE #define QNV_DEVINFO_GETCHIPCHANNELS

#define

QNV_DEVINFO_FILEVERSION

11.2 参数类型列表

//uParamType #define QNV_PARAM_BUSY #define QNV_PARAM_DTMFLEVEL #define QNV_PARAM_DTMFVOL #define QNV_PARAM_DTMFNUM #define QNV_PARAM_DTMFLOWINHIGH #define QNV_PARAM_DTMFHIGHINLOW #define QNV_PARAM_DIALSPEED #define QNV_PARAM_DIALSILENCE #define QNV_PARAM_DIALVOL #define QNV_PARAM_RINGSILENCE #define QNV_PARAM_CONNECTSILENCE #define QNV_PARAM_RINGBACKNUM #define QNV_PARAM_SWITCHLINEIN #define QNV_PARAM_FLASHELAPSE #define QNV_PARAM_FLASHENDELAPSE #define QNV_PARAM_RINGELAPSE #define QNV_PARAM_RINGSILENCEELAPSE #define QNV_PARAM_RINGTIMEOUT #define QNV_PARAM_RINGCALLIDTYPE #define QNV_PARAM_REFUSEELAPSE #define QNV_PARAM_DIALTONETIMEOUT #define QNV_PARAM_MINCHKFLASHELAPSE #define QNV_PARAM_MAXCHKFLASHELAPSE #define QNV_PARAM_HANGUPELAPSE #define QNV_PARAM_OFFHOOKELAPSE #define QNV_PARAM_RINGHIGHELAPSE #define QNV_PARAM_RINGLOWELAPSE #define QNV_PARAM_DIALTONERESULT #define QNV_PARAM_SPEECHGENDER #define QNV_PARAM_SPEECHTHRESHOLD #define QNV_PARAM_SPEECHSILENCEAM

7 8 9 10 11 12 20

1

2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 30 31 32

#define QNV_PARAM_ECHOTHRESHOLD #define QNV_PARAM_ECHODECVALUE #define QNV_PARAM_SIGSILENCEAM #define QNV_PARAM_LINEINFREQ1TH #define QNV_PARAM_LINEINFREQ2TH #define QNV_PARAM_LINEINFREQ3TH

#define QNV_PARAM_ADBUSY #define QNV_PARAM_ADBUSYMINFREQ #define QNV_PARAM_ADBUSYMAXFREQ

#define QNV_PARAM_AM_MIC #define QNV_PARAM_AM_SPKOUT #define QNV_PARAM_AM_LINEIN #define QNV_PARAM_AM_LINEOUT #define QNV_PARAM_AM_DOPLAY

#define QNV_PARAM_CITYCODE #define QNV_PARAM_PROXYDIAL

#define QNV_PARAM_FINDSVRTIMEOUT #define QNV_PARAM_CONFJITTERBUF

#define

QNV_PARAM_RINGTHRESHOLD

11.3 设备控制/状态

//uCtrlType #define QNV_CTRL_DOSHARE #define QNV_CTRL_DOHOOK #define QNV_CTRL_DOPHONE #define QNV_CTRL_DOPLAY #define QNV_CTRL_DOLINETOSPK #define QNV_CTRL_DOPLAYTOSPK #define QNV_CTRL_DOMICTOLINE #define QNV_CTRL_ECHO #define QNV_CTRL_RECVFSK #define QNV_CTRL_RECVDTMF #define QNV_CTRL_RECVSIGN #define QNV_CTRL_WATCHDOG #define QNV_CTRL_PLAYMUX #define QNV_CTRL_PLAYTOLINE #define

QNV_CTRL_SELECTLINEIN 33 34 35 40 41 42 45 46 47 50 51 52 53 54 60 61 70 71 80

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

#define QNV_CTRL_SELECTADCIN #define QNV_CTRL_PHONEPOWER #define QNV_CTRL_RINGPOWER #define QNV_CTRL_LEDPOWER #define QNV_CTRL_LINEOUT #define QNV_CTRL_SWITCHOUT #define QNV_CTRL_UPLOAD #define QNV_CTRL_DOWNLOAD #define QNV_CTRL_POLARITY //以下状态不能设置(set),只能获取(get) #define QNV_CTRL_PHONE #define QNV_CTRL_MICIN #define QNV_CTRL_RINGTIMES #define QNV_CTRL_RINGSTATE

//

11.4 放音控制

//uPlayType

11.4.1 播放文件

#define QNV_PLAY_FILE_START #define QNV_PLAY_FILE_SETCALLBACK #define QNV_PLAY_FILE_SETVOLUME #define QNV_PLAY_FILE_GETVOLUME #define QNV_PLAY_FILE_PAUSE #define QNV_PLAY_FILE_RESUME #define QNV_PLAY_FILE_ISPAUSE #define QNV_PLAY_FILE_SETREPEAT #define QNV_PLAY_FILE_ISREPEAT #define QNV_PLAY_FILE_SEEKTO #define QNV_PLAY_FILE_SETREPEATTIMEOUT #define QNV_PLAY_FILE_GETREPEATTIMEOUT #define QNV_PLAY_FILE_SETPLAYTIMEOUT #define QNV_PLAY_FILE_GETPLAYTIMEOUT #define QNV_PLAY_FILE_TOTALLEN #define QNV_PLAY_FILE_CURSEEK #define QNV_PLAY_FILE_ELAPSE #define QNV_PLAY_FILE_ISPLAY #define QNV_PLAY_FILE_ENABLEAGC #define

QNV_PLAY_FILE_ISENABLEAGC

16 17 18 19 20 21 22 23 24 30 31 32 33

1

2 3 4 5 6 7 8 9 11 12 13 14 15 16 17 18 19 20 21

#define QNV_PLAY_FILE_STOP #define QNV_PLAY_FILE_GETCOUNT #define QNV_PLAY_FILE_STOPALL

11.4.2 播放缓冲

#define QNV_PLAY_BUF_START

#define QNV_PLAY_BUF_SETCALLBACK #define QNV_PLAY_BUF_SETWAVEFORMAT #define QNV_PLAY_BUF_WRITEDATA #define QNV_PLAY_BUF_SETVOLUME #define QNV_PLAY_BUF_GETVOLUME #define QNV_PLAY_BUF_SETUSERVALUE #define QNV_PLAY_BUF_GETUSERVALUE #define QNV_PLAY_BUF_ENABLEAGC #define QNV_PLAY_BUF_ISENABLEAGC #define QNV_PLAY_BUF_PAUSE #define QNV_PLAY_BUF_RESUME #define QNV_PLAY_BUF_ISPAUSE #define QNV_PLAY_BUF_STOP #define QNV_PLAY_BUF_FREESIZE #define QNV_PLAY_BUF_DATASIZE #define QNV_PLAY_BUF_TOTALSAMPLES #define QNV_PLAY_BUF_SETJITTERBUFSIZE #define QNV_PLAY_BUF_GETJITTERBUFSIZE #define QNV_PLAY_BUF_GETCOUNT #define

QNV_PLAY_BUF_STOPALL

11.4.3 多文件播放

#define QNV_PLAY_MULTIFILE_START #define QNV_PLAY_MULTIFILE_PAUSE #define QNV_PLAY_MULTIFILE_RESUME #define QNV_PLAY_MULTIFILE_ISPAUSE #define QNV_PLAY_MULTIFILE_SETVOLUME #define QNV_PLAY_MULTIFILE_GETVOLUME #define QNV_PLAY_MULTIFILE_ISSTART #define QNV_PLAY_MULTIFILE_STOP #define

QNV_PLAY_MULTIFILE_STOPALL

22 23 24

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

1

2 3 4 5 6 7 8 9

11.4.4 播放字符

#define #define #define #define #define #define #define #define #define #define

QNV_PLAY_STRING_INITLIST QNV_PLAY_STRING_START QNV_PLAY_STRING_PAUSE QNV_PLAY_STRING_RESUME QNV_PLAY_STRING_ISPAUSE QNV_PLAY_STRING_SETVOLUME QNV_PLAY_STRING_GETVOLUME QNV_PLAY_STRING_ISSTART QNV_PLAY_STRING_STOP QNV_PLAY_STRING_STOPALL

1 2 3 4 5 6 7 8 9 10

11.5 录音控制

//uRecordType

11.5.1 文件录音

#define #define #define #define #define #define #define #define #define #define

QNV_RECORD_FILE_START QNV_RECORD_FILE_PAUSE QNV_RECORD_FILE_RESUME QNV_RECORD_FILE_ISPAUSE QNV_RECORD_FILE_ELAPSE QNV_RECORD_FILE_SETVOLUME QNV_RECORD_FILE_GETVOLUME QNV_RECORD_FILE_PATH QNV_RECORD_FILE_STOP QNV_RECORD_FILE_STOPALL

1 2 3 4 5 6 7 8 9 10

11.5.2 缓冲类型

#define #define #define #define #define #define #define

QNV_RECORD_BUF_HWND_START 1 QNV_RECORD_BUF_HWND_STOP 2 QNV_RECORD_BUF_HWND_STOPALL 3 QNV_RECORD_BUF_CALLBACK_START 4 QNV_RECORD_BUF_CALLBACK_STOP 5 QNV_RECORD_BUF_CALLBACK_STOPALL 6 QNV_RECORD_BUF_SETCBSAMPLES 7

#define QNV_RECORD_BUF_GETCBSAMPLES #define QNV_RECORD_BUF_ENABLEECHO #define QNV_RECORD_BUF_ISENABLEECHO #define QNV_RECORD_BUF_PAUSE #define QNV_RECORD_BUF_ISPAUSE #define QNV_RECORD_BUF_RESUME #define QNV_RECORD_BUF_SETVOLUME #define QNV_RECORD_BUF_GETVOLUME #define QNV_RECORD_BUF_SETWAVEFORMAT #define QNV_RECORD_BUF_GETWAVEFORMAT

11.6 会议控制

//uConferenceType #define QNV_CONFERENCE_CREATE #define QNV_CONFERENCE_ADDTOCONF #define QNV_CONFERENCE_GETCONFID #define QNV_CONFERENCE_SETSPKVOLUME #define QNV_CONFERENCE_GETSPKVOLUME #define QNV_CONFERENCE_SETMICVOLUME #define QNV_CONFERENCE_GETMICVOLUME #define QNV_CONFERENCE_PAUSE #define QNV_CONFERENCE_RESUME #define QNV_CONFERENCE_ISPAUSE #define QNV_CONFERENCE_ENABLESPK #define QNV_CONFERENCE_ISENABLESPK #define QNV_CONFERENCE_ENABLEMIC #define QNV_CONFERENCE_ISENABLEMIC #define QNV_CONFERENCE_ENABLEAGC #define QNV_CONFERENCE_ISENABLEAGC #define QNV_CONFERENCE_DELETECHANNEL #define QNV_CONFERENCE_DELETECONF #define QNV_CONFERENCE_DELETEALLCONF #define QNV_CONFERENCE_GETCONFCOUNT #define QNV_CONFERENCE_RECORD_START #define QNV_CONFERENCE_RECORD_PAUSE #define QNV_CONFERENCE_RECORD_RESUME #define QNV_CONFERENCE_RECORD_ISPAUSE #define QNV_CONFERENCE_RECORD_FILEPATH #define QNV_CONFERENCE_RECORD_ISSTART #define QNV_CONFERENCE_RECORD_STOP #define QNV_CONFERENCE_RECORD_STOPALL

8 9 10 11 12 13 14 15 16 17

1

2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 30 31 32 33 34 35 36 37

11.7 语音广播

#define #define #define #define QNV_BROADCAST_SEND_START QNV_BROADCAST_SEND_STOP QNV_BROADCAST_SEND_ADDADDR QNV_BROADCAST_SEND_DELETEADDR 1 2 3 4 #define QNV_BROADCAST_SEND_PAUSE #define QNV_BROADCAST_SEND_RESUME #define QNV_BROADCAST_SEND_ISPAUSE #define QNV_BROADCAST_SEND_SETVOLUME #define QNV_BROADCAST_SEND_GETVOLUME

#define QNV_BROADCAST_RECV_START #define QNV_BROADCAST_RECV_STOP #define QNV_BROADCAST_RECV_SETVOLUME #define

QNV_BROADCAST_RECV_GETVOLUME

11.8 speech语音识别

#define QNV_SPEECH_CONTENTLIST #define QNV_SPEECH_STARTSPEECH #define QNV_SPEECH_ISSPEECH #define QNV_SPEECH_STOPSPEECH #define QNV_SPEECH_GETRESULT #define

QNV_SPEECH_GETRESULTEX

11.9 传真模块接口

#define QNV_FAX_LOAD

#define QNV_FAX_UNLOAD #define QNV_FAX_STARTSEND #define QNV_FAX_STOPSEND #define QNV_FAX_STARTRECV #define QNV_FAX_STOPRECV #define QNV_FAX_STOP #define

QNV_FAX_PAUSE

5 6 7 8 9 30 31 32 33

1 2 3 4 5 6

1 2 3 4 5 6 7 8

#define QNV_FAX_RESUME #define QNV_FAX_ISPAUSE #define QNV_FAX_TYPE #define QNV_FAX_TRANSMITSIZE #define QNV_FAX_IMAGESIZE #define QNV_FAX_SAVESENDFILE

11.10 event事件获取

//ueventType #define QNV_EVENT_POP #define QNV_EVENT_POPEX #define QNV_EVENT_TYPE #define QNV_EVENT_HANDLE #define QNV_EVENT_RESULT #define QNV_EVENT_PARAM #define QNV_EVENT_DATA #define QNV_EVENT_DATAEX

#define QNV_EVENT_REMOVE #define QNV_EVENT_REMOVEALL

#define QNV_EVENT_REGWND #define QNV_EVENT_UNREGWND #define QNV_EVENT_REGCBFUNC #define QNV_EVENT_REGCBFUNCEX #define QNV_EVENT_UNREGCBFUNC

11.11 通用函数general

//uGeneralType #define QNV_GENERAL_STARTDIAL #define QNV_GENERAL_SENDNUMBER #define QNV_GENERAL_REDIAL #define QNV_GENERAL_STOPDIAL #define QNV_GENERAL_ISDIALING

#define QNV_GENERAL_STARTRING #define QNV_GENERAL_STOPRING #define QNV_GENERAL_ISRINGING

9 10 11 12 13 14

1 2 3 4 5 6 7 8 20 21 30 31 32 33 34

1 2 3 4 5 10 11

12

#define #define #define

#define #define #define

#define #define #define #define #define #define

#define #define #define

#define #define #define #define

#define #define #define #define #define #define

#define #define #define #define

#define #define

//call log #define #define #define #define

QNV_GENERAL_STARTFLASH QNV_GENERAL_STOPFLASH QNV_GENERAL_ISFLASHING QNV_GENERAL_STARTREFUSE QNV_GENERAL_STOPREFUSE QNV_GENERAL_ISREFUSEING

QNV_GENERAL_GETCALLIDTYPE QNV_GENERAL_GETCALLID QNV_GENERAL_GETTELDIALCODE QNV_GENERAL_GETTELDIALCODEEX QNV_GENERAL_RESETTELDIALBUF QNV_GENERAL_GETTELDIALLEN QNV_GENERAL_STARTSHARE

QNV_GENERAL_STOPSHARE QNV_GENERAL_ISSHARE

QNV_GENERAL_ENABLECALLIN QNV_GENERAL_ISENABLECALLIN QNV_GENERAL_ISLINEHOOK QNV_GENERAL_ISLINEFREE QNV_GENERAL_RESETRINGBACK QNV_GENERAL_CHECKCHANNELID QNV_GENERAL_CHECKDIALTONE QNV_GENERAL_CHECKSILENCE QNV_GENERAL_CHECKVOICE QNV_GENERAL_CHECKLINESTATE QNV_GENERAL_SETUSERVALUE QNV_GENERAL_SETUSERSTRING QNV_GENERAL_GETUSERVALUE QNV_GENERAL_GETUSERSTRING QNV_GENERAL_READPARAM QNV_GENERAL_WRITEPARAM

QNV_CALLLOG_BEGINTIME

QNV_CALLLOG_RINGBACKTIME QNV_CALLLOG_CONNECTEDTIME QNV_CALLLOG_ENDTIME 20 21 22 30 31 32 50 51 52 53 54 55 60 61 62 70 71 72 73 80 81 82 83 84 85 90 91 92 93 100 101

1 2 3 4

#define QNV_CALLLOG_CALLTYPE

#define QNV_CALLLOG_CALLRESULT #define QNV_CALLLOG_CALLID #define QNV_CALLLOG_CALLRECFILE #define QNV_CALLLOG_DELRECFILE #define QNV_CALLLOG_RESET

11.12 工具函数，跟设备无关

//uToolType #define QNV_TOOL_PSTNEND

#define QNV_TOOL_CODETYPE #define QNV_TOOL_LOCATION #define QNV_TOOL_DISKFREESPACE #define QNV_TOOL_DISKTOTALSPACE #define QNV_TOOL_DISKLIST #define QNV_TOOL_RESERVID1 #define QNV_TOOL_ RESERVID2 #define QNV_TOOL_CONVERTFMT #define QNV_TOOL_SELECTDIRECTORY #define QNV_TOOL_SELECTFILE #define QNV_TOOL_CONVERTTOTIFF #define QNV_TOOL_APMQUERYSUSPEND #define QNV_TOOL_SLEEP #define QNV_TOOL_SETUSERVALUE #define QNV_TOOL_GETUSERVALUE #define QNV_TOOL_SETUSERVALUEI #define QNV_TOOL_GETUSERVALUEI #define QNV_TOOL_ISFILEEXIST #define QNV_TOOL_FSKENCODE #define QNV_TOOL_WRITELOG

11.13 存储操作

#define QNV_STORAGE_PUBLIC_READ #define QNV_STORAGE_PUBLIC_READSTR #define QNV_STORAGE_PUBLIC_WRITE #define QNV_STORAGE_PUBLIC_SETREADPWD #define QNV_STORAGE_PUBLIC_SETWRITEPWD #define

QNV_STORAGE_PUBLIC_GETSPACESIZE

5 6 7 8 9 20

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 20 21 22

1 2 3 4 5

6

本文来源：https://www.bwwdw.com/article/uki7.html