usb盒动态库开发文档

《usb盒动态库开发文档》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、(一)概述USB盒有以下几种类型：Fi3001B（1路USB录音盒）、Fi3002B（2路USB录音盒）、Fi3101A（1路USB语音盒,带耳麦和电话机）、Fi3102A（2路USB语音盒），其中Fi3101,Fi3002和Fi3102在window2000不能工作。如果想要Fi3001在windows2000工作，必须要换动态库，在目录fi3001_lib下的两个动态库。所有USB盒采用统一的编程接口Phonic_ubox.dll。Phonic_ubox.dll通过回调函数通知发生的事件，其函数说明和事件的定义参考头文件

2、phonic_ubox.h。编程时第一个要调用的函数是ubox_open(UBoxEventNotifyProcproc,UBOX_WORK_MODEmode)，用于设置事件回调函数，并启动USB盒。事件回调函数原形如下：typedefvoid(CALLBACK*UBoxEventNotifyProc)(UBOX_HANDLEuboxHnd设备句柄，一个合法的设备句柄是不等于-1的整数，这个值对于不同的PC机的USB端口的值是不同的，多个USB设备通过它来区别,inteventID事件，参考UBOX_EVENT的定义,uns

3、ignedlongparam1下面几个参数不同的事件，其含义不同,unsignedlongparam2事件参数2,unsignedlongparam3事件参数3,unsignedlongparam4事件参数4);其简单开发流程：1.先调用ubox_open函数；2.如果USB录音盒设备已插入，会有设备插入事件UBOX_EVENT_DEVICE_PLUG_IN通知上层程序；3.电话振铃,主叫号码,摘机，挂机、按键和都会用事件通知上层程序；4.一般在摘机事件触发时调用ubox_record_file开始录音，在挂机事件触发时调用

4、ubox_stop_record停止录音；5.拨号调用ubox_send_dtmf，号码发送完毕，应用程序会收到UBOX_EVENT_CALLOUTFINISH事件。由于有彩铃，无法正确判断对方是否摘机，所以底层没有做检测对方摘机功能。但是具有检测对方挂机忙音功能，当底层检测到挂机忙音，会送UBOX_EVENT_DEVICE_BUSY_TONE事件给应用程序。6.程序退出时要调用用ubox_close（）关闭设备。(二)UBOX_EVENT事件UBOX_EVENT_DEVICE_PLUG_IN设备插入功能：通知应用程序检测到

5、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_

6、DEVICE_PLUG_OUTUBOX_EVENT_ALARM报警功能：通知应用程序设备出现工作异常。参数：uboxHnd:设备句柄eventID:UBOX_EVENT_ALARMparam1:工作异常的原因,有四种情况:1-----未能找到ubox的MIC设备2-----未能打开ubox的MIC设备3-----未能打开ubox的放音设备4-----设备故障,设备工作不正常，软件退出，检查设备驱动程序是否安装好。UBOX_EVENT_DEVICE_ERROR设备错误功能：通知应用程序设备错误。参数：uboxHnd:设备句柄e

7、ventID:UBOX_EVENT_DEVICE_ERROR设备错误,需要软件重新启动，不然接收不到主叫号码UBOX_EVENT_LINE_RINGING振铃功能：通知应用程序线路振铃参数：uboxHnd:设备句柄eventID:UBOX_EVENT_LINE_RINGINGparam1、param2、param3、param4未使用UBOX_EVENT_LINE_RING_STOP停振功能：通知应用程序线路停振。参数：uboxHnd:设备句柄eventID:UBOX_EVENT_LINE_RING_STOP说了明：电话机振

8、铃一般是振1秒，停振4秒的一个周期。UBOX_EVENT_LINE_HOOK_UP事件挂机功能：通知应用程序线路挂机。参数：uboxHnd:是设备句柄eventID:UBOX_EVENT_LINE_HOOK_UPUBOX_EVENT_LINE_HOOK_OFF事件摘机功能：通知应用程序线路