USB盒动态库开发文档.doc

概述USB盒有以下几种类型:Fi3001B(1路USB录音盒)、Fi3002B(2路USB录音盒)、Fi3101A(1路USB语音盒,带耳麦和电话机)、Fi3102A(2路USB语音盒),其中Fi3101,Fi3002和Fi3102在window2000不能工作。如果想要Fi3001在windows2000工作,,。。,。该接口支持下面几种类型的产品,统一用此接口。Fi3001B1路USB录音盒(,)Fi3101A带耳麦的USB语音盒(1外1内)(,)Fi3002B2路USB录音盒(,)Fi3102A2路USB外线(,)上面括号内表示:应用程序必须依赖的库的文件。Fi3002B有两个版本,,低于该版本的硬件不支持测量线路电压功能。编程时第一个要调用的函数是ubox_open(UBoxEventNotifyProcproc,UBOX_WORK_MODEmode),用于设置事件回调函数,并启动USB盒。事件回调函数原形如下: typedefvoid(CALLBACK*UBoxEventNotifyProc)(UBOX_HANDLEuboxHnd设备句柄,一个合法的设备句柄是不等于-1的整数,这个值对于不同的PC机的USB端口的值是不同的,多个USB设备通过它来区别,inteventID事件,参考UBOX_EVENT的定义,unsignedlongparam1下面几个参数不同的事件,其含义不同,unsignedlongparam2事件参数2 ,unsignedlongparam3事件参数3 ,unsignedlongparam4事件参数4 );其简单开发流程:先调用ubox_open函数;如果USB录音盒设备已插入,会有设备插入事件UBOX_EVENT_DEVICE_PLUG_IN通知上层程序;电话振铃,主叫号码,摘机,挂机、按键和都会用事件通知上层程序;一般在摘机事件触发时调用ubox_record_file开始录音,在挂机事件触发时调用ubox_stop_record停止录音;拨号调用ubox_send_dtmf,号码发送完毕,应用程序会收到UBOX_EVENT_CALLOUTFINISH事件。由于有彩铃,无法正确判断对方是否摘机,所以底层没有做检测对方摘机功能。但是具有检测对方挂机忙音功能,当底层检测到挂机忙音,会送UBOX_EVENT_DEVICE_BUSY_TONE事件给应用程序。程序退出时要调用用ubox_close()关闭设备。请看“”文档UBOX_EVENT事件UBOX_EVENT_DEVICE_PLUG_IN 设备插入功能:通知应用程序检测到USB设备插入参数:UBOX_HANDLEuboxHnd是USB设备句柄eventID:UBOX_EVENT_DEVICE_PLUG_IN说明:USB设备句柄用于标识USB线路。不同USB盒的句柄并不是连续的,但对于同一个2路的USB盒,其线路1和线路2的句柄值是相邻的。有设备句柄参数的函数必须要在通道收到UBOX_EVENT_DEVICE_PLUG_IN事件后才能调用。UBOX_EVENT_DEVICE_PLUG_OUT 设备拨出功能:通知应用程序设备拨出。参数:uboxHnd是设备句柄eventID:UBOX_EVENT_DEVICE_PLUG_OUTUBOX_EVENT_ALARM 报警功能:设备报警,软件要重新启动,否则不能录音和放音。Param为7,不要做任何特殊处理。参数:uboxHnd:设备句柄eventID:UBOX_EVENT_ALARMparam1:工作异常的原因,有四种情况:1-----未能找到ubox的MIC设备 2-----未能打开ubox的MIC设备 3-----未能打开ubox的放音设备 4-----设备故障,设备工作不正常,软件退出,检查设备驱动程序是否安装好。UBOX_WIN7_AUDIO_EXCEPTION=5,//Vista和win7audio设备故障,需要重新调用ubox_close,然后调用ubox_openUBOX_ALARM_RE