USB盒控件开发文档.doc

,要使用控件必须先注册,包括动态库一起,,自动帮你注册到系统目录下。该接口支持下面几种类型的产品,统一用此接口。Fi3001B1路USB录音盒(,)Fi3101A带耳麦的USB语音盒(1外1内)(,)Fi3002B2路USB录音盒(,)Fi3102A2路USB外线(,)上面括号内表示:,应用程序必须依赖的库的文件。其简单开发流程:先调用OpenDevice函数;如果USB录音盒设备已插入,会有设备插入事件通知上层程序;电话摘机,振铃,挂机、按键和主叫号码都会有事件通知上层程序;电话录音一般在摘机开始录音,调用RecordFile函数,挂机停止录音;,最后调用CloseDevice()关闭设备,底层程序才会关闭。控件事件PlugIn 设备插入PLugIn(longuboxHandle)功能:设备插入参数:uboxHandle设备句柄不同USB盒的句柄并不是连续的,但对于2路的盒子,其线路1和线路2的句柄值是相邻的。PlugOut 设备拨出PlugOut(longuboxHandle)功能:设备拨出。参数:uboxHandle设备句柄DeviceAlarm 报警DeviceAlarm(longuboxHandle,longparam)功能:设备报警,软件要重新启动,否则不能录音和放音。参数:uboxHandle设备句柄param如下所示:UBOX_ALARM_CAN_FIND_MIC =1, 未能找到ubox的MIC设备 UBOX_ALARM_CAN_OPEN_MIC =2, 未能打开ubox的MIC设备 UBOX_ALARM_CAN_OPEN_PLAY=3,未能打开ubox的放音设备 UBOX_ALARM_DEVICE_ERROR =4, 设备故障DeviceError 设备错误DeviceError(longuboxHandle)功能:设备错误。参数:uboxHandle设备句柄,Ring 振铃Ring(longuboxHandle)功能:电话振铃。参数:uboxHandle设备句柄 对于Fi3101A,可以在振铃调用OpenBuzzerSwitch(uboxHandle,true)方法打开蜂鸣器,通知用户来电,在事件HookOff或者RingCancel下调用OpenBuzzerSwitch(uboxHandle,false)关闭蜂鸣器,。RingStop 停振事件RingStop(longuboxHandle)功能:通知应用程序通道停振。参数:uboxHandle设备句柄,说明:电话机振铃一般是振1秒,停振4秒的一个周期。RingCancle 振铃取消RingCancel(longuboxHandle)功能:振铃取消,当末次振铃停止超过6秒,则触发此事件。未接电话可通过该事件判断参数:uboxHandle设备句柄HookOff 摘机HookOff(longuboxHandle,longparam1)功能:电话摘机。参数:uboxHandle设备句柄Param1=0,表示电话机摘机Param1=6,表示反向摘机,指软件摘机Param1=7,表示正向摘机,指软件摘机Hangup 挂机HangUp(longuboxHandle)功能:电话挂机。参数:uboxHandle设备句柄 HangIng 悬空HangIng(longuboxHandle)功能:线路悬空,线路接口没有连接好。参数:uboxHandle设备句柄说明:只有Fi3001才有这个功能,如果电话线被拨掉,先触发摘机事件,经过20-30秒后再触发悬空事件。CallID事件来电号码CallID(longuboxHandle,LPCTSTRcallerNumber,LPCTSTRcallerTime,LPCTSTRcallerName)功能:通知应用程序来电号码。参数:uboxHandle设备句柄,callerNumber号码callerTime时间callerName姓名DtmfKey事件用户按键DtmfKey(longuboxHandle,longdtmfCode)功能:通知应用程序用户按键。参数:uboxHandle设备句柄, dtmfCode是按键键值,需要类型转换chardtmf=(char)dtmfCode。PlayEnd 放音结