USB盒动态库开发文档.docVIP

概述 USB盒有以下几种类型：Fi3001B（1路USB录音盒）、Fi3002B（2路USB录音盒）、Fi3101A（1路USB语音盒,带耳麦和电话机）、Fi3102A（2路USB 语音盒），其中Fi3101, Fi3002和Fi3102在window 2000不能工作。如果想要Fi3001在windows 2000工作，必须要换动态库，在目录fi3001_lib下的两个动态库。所有USB盒采用统一的编程接口Phonic_ubox.dll。Phonic_ubox.dll通过回调函数通知发生的事件，其函数说明和事件的定义参考头文件phonic_ubox.h。 编程时第一个要调用的函数是ubox_open(UBoxEventNotifyProc proc, UBOX_WORK_MODE mode)，用于设置事件回调函数，并启动USB盒。事件回调函数原形如下： typedef void ( CALLBACK* UBoxEventNotifyProc )( UBOX_HANDLE uboxHnd 设备句柄，一个合法的设备句柄是不等于-1的整数，这个值对于不同的PC 机的USB端口的值是不同的，多个USB设备通过它来区别 , int eventID 事件，参考UBOX_EVENT的定义 , unsigned long param1 下面几个参数不同的事件，其含义不同 , unsigned long param2 事件参数2 , unsigned long param3 事件参数3 , unsigned long param4 事件参数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_HANDLE uboxHnd 是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_OUT UBOX_EVENT_ALARM 报警 功 能：通知应用程序设备出现工作异常。 参 数：uboxHnd: 设备句柄 eventID: UBOX_EVENT_ALARM param1: 工作异常的原因,有四种情况: 1 -----未能找到ubox 的MIC 设备 2 -----未能打开ubox 的 MIC 设备 3 -----未能打开ubox 的放音设备 4 -----设备故障,设备工作不正常，软件退出，检查设备驱动程序是否安装好。 UBOX_EVENT_DEVICE_ERROR 设备错误 功 能：通知应用程序设备错误。 参 数：uboxHnd: 设备句柄 eventID: UBOX_EVENT_DEVICE_ERROR 设备