应用开发手册

深圳友邻通讯设备有限公司前台接口控件V2.0第1页/共37页应用开发手册深圳友邻通讯设备有限公司深圳友邻通讯设备有限公司前台接口控件V2.0第2页/共37页目录一．录音服务系统介绍………………………………………………3第一节功能简介……………………………………………………………3第二节结构概述……………………………………………………………3二．前台开发控件安装………………………………………………5第一节前台开发控件说明…………………………………………………5第二节前台开发控件注册…………………………………………………5第三节服务器DCOM配置…………………………………………….…6三．功能实现……………………………………………….…..……9第一节初始化设置……………………………………………。……..…….9第二节录音控制……………………………………………………..……..9第三节查询…………………………………………………………..…….11第四节调听录音………………………………….……………..……11四．附录…………………………………………………..……12附录一AgentBx.OCX接口…………………….….…………………….…15附录二CTIBtn.OCX接口……………….…….………………………...…21深圳友邻通讯设备有限公司前台接口控件V2.0第3页/共37页一．录音服务系统介绍第一节功能简介DVS-数据语音同步系统作为一种提高客户服务中心服务质量的工具，主要具备以下一些功能：通话录音对话务员与客户通话的全过程进行录音：通话开始时，由TCM通过接口，发出录音开始命令，通知DVS开始录音；通话结束时，由TCM通知DVS停止录音，同时DVS把呼叫信息保存到通话记录中，作为日后检索该次录音的条件。录音回放前台应用通过接口，向DVS提出查询请求，服务器返回符合条件的记录。同时可以通过软电话拨号到DVS服务器的放音分机，实现录音的回放。数据保存DVS提供18/36/72G的硬盘作为语音数据的暂时存储空间。如果用户认为有必要保存语音数据，可以通过我方提供的备份应用程序备份到磁带。第二节结构概述DVS的逻辑结构图如下：其中各个部分的功能描述如下：录音控制服务器（DvsRecordServer.exe）：DVS的总控单元，其功能是与TCM进行消息通讯，控制其他单元实现录音流程的TCM前台DVS（DataVoiceSynchronization）-语音同步系统录音控制服务器屏捕控制服务器放音服务器DVS录音控制程序语音卡控制程序语音信号卡驱动程序，API深圳友邻通讯设备有限公司前台接口控件V2.0第4页/共37页控制和前台应用放音过程中DVS放音分机的摘挂机通知。屏捕控制服务器（DvsScreenServer.exe）：管理与前台应用之间的连接和放音控制。DVS录音控制程序（DvsRecordClient.exe）：通过COM接口操作语音信号卡实现录音的操作。放音服务器（DvsPlayServer.exe）：通过COM接口操作语音信号卡实现放音的操作。深圳友邻通讯设备有限公司前台接口控件V2.0第5页/共37页二．前台开发控件安装第一节前台开发控件说明DVS录音服务系统给前台查询放音提供了开发接口。开发接口是AgentBx.ocx和CTIBtn.ocx，使用以上两个OCX控件所需要的相关支持文件有：AgentBx.OCX需要注册CTIBtn.OCX需要注册AgentCommProj.exe需要注册PrjServer.exe需要注册Midas.Dll拷至系统system32目录下（c:\windows\system32或c:\winnt\system32）(相应的接口文档请看附录)AgentBx.OCX会通过AgentCommProj.exe与DVS服务器通讯，AgentBx.OCX也直接与录音服务器上的PrjServer.exe连接，PrjServer.exe访问数据库，把查询结果返回到AgentBx.OCX。当需要放音时，AgentBx.OCX会通过AgentCommProj.exe访问录音服务系统请求放音。CTIBtn.OCX是前台给DVS服务器发CTI消息的的控件，DVS服务器所有的录放音动作都由CTI消息来起动。Midas.dll是前台访问PrjServer.exe所需要的库，在C:\电话录音系统\AgentReg下有，直接拷贝到前台system32目录下就行。如果前台的开发环境是VB，Delphi,C++Builder时，以上两个控件就可以满足前台的查询和放音。如果前台开发环境是PowerBuilder的情况下还需要AgentOcxExe.exe（需要注册）AgentEOcxXcontrol.ocx（需要注册）两个文件，开发接口是AgentEOcxXcontrol.ocx。AgentBx.ocx不再作为接口被使用在开发环境中，但作为支持文件必须存在。在开发环境中使用AgentEOcxXcontrol.ocx。CtiBtn.ocx使用上无区别。第二节前台开发控件注册第一种方法:直接在前台电脑上安装前台应用系统，安装后前台开发和使用所需得接口文件以及相关的支持文件都会存放在所需目录下，并自动注册。第二种方法:在录音服务系统安装完成后，在C:\电话录音系统\AgentReg下就有AgentBx.OCX、CTIBtn.OCX和AgentCommProj.exe三个文件，如果需要深圳友邻通讯设备有限公司前台接口控件V2.0第6页/共37页AgentEOcxXControl.ocx的话我们会另外提供。注册这三个接口，先把它们拷贝到前台电脑上，如：C:\Agent\下，然后注册。对于AgentCommProj.exe来说，只要运行一遍再关闭就已经注册成功了。对于AgentBx.OCX和CTIBtn.OCX则在运行栏上运行RegSvr32C:\Agent\AgentBx.ocx”如果系统提示注册成功即可。前台还需要运行一下PrjServer.exe，AgentBx.OCX才能调用PrjServer.exe。PrjServer.exe在服务器的“C:\电话录音系统\ServerReg”下。所以也需要把PrjServer.exe拷贝到前台电脑上，并运行一遍再关闭。第三节服务器DCOM配置首先将winnt下的Guest用户打开。AgentBx.OCX与PrjServer.exe之间是通过DCOM建立连接的，所以在服务器端必须进行DCOM配置。在服务器端的运行栏内输入DCOMCNFG，运行后就会去现下图，PrjServer.exe对应的对象是AgentQueryObject,所以我们需要对AgentQueryObject进行配置。双击AgentQueryObject就会出现配置界面如下图：深圳友邻通讯设备有限公司前台接口控件V2.0第7页/共37页首先配置安全性，点击选中安全性页面，选择使用自定义访问权限，然后编辑访问权限。点击“编辑”后，会出现权限编辑窗口，把原有深圳友邻通讯设备有限公司前台接口控件V2.0第8页/共37页的用户都删除掉，然后添加图中所示的六个用户或用户组就可以了。同理，选择“使用自定义启动权限”，并编辑它，编辑的结果与上图一样。“使用自定义配置权限”不做改动。如果前台系统就在服务器本机上，就不需要以上的DCOM配置。深圳友邻通讯设备有限公司前台接口控件V2.0第9页/共37页三．功能实现第一节初始化设置1．连接Dvs系统：录音，放音都是由DVS录音服务系统来控制完成的，但录音服务系统什么时候开始录音、放音，什么时候停止录音、停止放音完全由CTI的电话消息来控制。在做DEMO的时候，没有CTI，我们用CTIBtn.OCX来给DVS服务器发CTI消息。功能要实现首先要保证前台机器与DVS服务器之间的网络是通的，而且它们的IP地址在同一网段。实现数据查询，只需要连接到服务器并知道数据服务器名即可。而要实现放音除了连接到服务器外，还需要前台登录，也就是把本地分机号传给服务器。首先把前台机器上的AgentCommProj.exe调起，然后通过AgentCommProj.exe去访问DVS服务器。首先将AgentBX.OCX的AgentName置为空，将AgentConn置为True,就可以将AgentCommProj.exe调起：AgentName:=’’;AgentConn:=True;其次要与Dvs系统连接，需要调用AgentBx.SetConn方法，设置了DVS服务器的地址和端口号(6677555)后。SetConn方法AgentBx.SetConn(“192.1.1.1”,6677555);等待5秒钟左右，OnServerConn事件触发表示和Dvs系统连接成功。AgentCommProj.exe（Agent通讯站）应用程序被调起，这时在任务栏的右边多了一个图标，图标为一台电脑，当连接服务器成功后，这个图标就变成了两台重叠的电脑。反过来，这一变化也可以说明前台与DVS连接成功。前台登录通过LogIn（AgentID,Extention:WideString）方法，其中AgentID是人员的登录标识，可以任意指定。而Extention（分机号）必须是前台话务员所使用的分机。登录后等待OnLogInSucc事件，事件触发表示前台登录成功。OnBreak事件触发，表示和Dvs系统连接断开，此时AgentCommProj.exe会自动尝试从新和Dvs建立连接，并在连接后从新自动以上一次登陆参数登陆。第二节查询要查询数据，必须和录音服务器上的应用服务程序PrjServer.exe,建立连接。AgentBx.OCX的ComputerName赋为录音服务器的机器名，再将Connected置为True，就可以和PrjServer.exe连接：AgentBx.ComputerName:=“RecordServer”;AgentBx.Connected:=True;查询录音信息（记录）通过AgentBX.OCX的QuerySysRecord方法来实现，该方法的参数是查询的条件，请参考附录，其中UniqueGuid是每个记录的唯一标识，而UniqueId是与业务表的关联，在没有业务存在的情况下，我们无须使用该参数，赋空值即可。同理，深圳友邻通讯设备有限公司前台接口控件V2.0第10页/共37页WorkType也赋空值。该方法使用结束后，查询的数据都到了前台机器的内存中，查询的返回值就是查询得到的记录数。我们需要使用QuerySsyDateField（RecordSysNo,RecordSysIndex:integer）方法来读取每个记录的每个字段值，这些值都以字符串的形式返回。第三节调听录音DVS服务器放音需要四个条件，一，登陆成功。二，查出了相关纪录。三，拨通放音分机。四，通知DVS系统，放音建立。以上条件都成功，就可以调用AgentBX.OCX的play方法来播放。在play之前，我们要先为第三个条件做好准备。放音分机和听音分机都可以由CTI消息通知DVS服务器，但播放的记录我们就自己选择。首先，使用AgentBX.OCX的LoadSelectFile(RecordSysNo,RecordWorkTypeNo:integer;PlayVoice,PlayData:WordBool)方法来Load一个记录对相应的文件，其中RecordSysNo就是QuerySysRecord查出的纪录的索引号，从1开始到QuerySysRecord的返回值之间的值。而RecordWorkTypeNo是用于业务的，不需要时置为0，PlayVoice是指播放语音，置为True,PlayData是指播放屏捕数据，这项功能还没有开通，所以置为False:LoadSelectFile(n,0,True,False);//播放第一n次记录这时，我们已经load了一个文件，然后用话务员的分机拨放音分机号，振铃一声后DVS服务器将该分机摘机。如果安装了