应用开发手册

深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 1 页 共 38 页 应用开发手册应用开发手册 深圳友邻通讯设备有限公司深圳友邻通讯设备有限公司 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 2 页 共 38 页 目录目录 一 一 录音服务系统介绍录音服务系统介绍 3 第一节第一节功能简介功能简介 3 第二节第二节结构概述结构概述 3 二 二 前台开发控件安装前台开发控件安装 5 第一节第一节前台开发控件说明前台开发控件说明 5 第二节第二节前台开发控件注册前台开发控件注册 5 第三节第三节服务器服务器 DCOM 配置配置 6 三 三 功能实现功能实现 9 第一节第一节初始化设初始化设 置置 9 第二节第二节录音控制录音控制 9 第三节第三节查询查询 11 第四节第四节调听录音调听录音 11 四 四 附附 录录 12 附录一附录一 AgentBx OCX 接口接口 15 附录二附录二 CTIBtn OCX 接口接口 21 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 3 页 共 38 页 一 一 录音服务系统介绍录音服务系统介绍 第一节第一节功能简介功能简介 DVS 数据语音同步系统作为一种提高客户服务中心服务质量的工具 主要具备以下一 些功能 通话录音 对话务员与客户通话的全过程进行录音 通话开始时 由 TCM 通过接口 发出录音开始命令 通知 DVS 开始录音 通话结束时 由 TCM 通知 DVS 停止 录音 同时 DVS 把呼叫信息保存到通话记录中 作为日后检索该次录音的条件 录音回放 前台应用通过接口 向 DVS 提出查询请求 服务器返回符合条件的记录 同时可以通过软电话拨号到 DVS 服务器的放音分机 实现录音的回放 数据保存 DVS 提供 18 36 72G 的硬盘作为语音数据的暂时存储空间 如果用户认为有 必要保存语音数据 可以通过我方提供的备份应用程序备份到磁带 第二节第二节结构概述结构概述 DVS 的逻辑结构图如下 其中各个部分的功能描述如下 录音控制服务器 录音控制服务器 DvsRecordServer exe TCM前台 DVS Data Voice Synchronization 语音同步系统 录音控制服务器屏捕控制服务器 放音服务器DVS 录音控制程序 语音卡控制程序 语音信号卡驱动程序 API 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 4 页 共 38 页 DVS 的总控单元 其功能是与 TCM 进行消息通讯 控制其他单元实现录音流程 的控制和前台应用放音过程中 DVS 放音分机的摘挂机通知 屏捕控制服务器 屏捕控制服务器 DvsScreenServer exe 管理与前台应用之间的连接和放音控制 DVS 录音控制程序 录音控制程序 DvsRecordClient exe 通过 COM 接口操作语音信号卡实现录音的操作 放音服务器 放音服务器 DvsPlayServer exe 通过 COM 接口操作语音信号卡实现放音的操作 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 5 页 共 38 页 二 二 前台开发控件安装前台开发控件安装 第一节前台开发控件说明前台开发控件说明 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 时 以上两个控件就可以满足前台 的查询和放音 如果前台开发环境是 Power Builder 的情况下还需要 AgentOcxExe exe 需要注册 AgentEOcxXcontrol ocx 需要注册 两个文件 开发接口是 AgentEOcxXcontrol ocx AgentBx ocx 不再作为接口被使用 在开发环境中 但作为支持文件必须存在 在开发环境中使用 AgentEOcxXcontrol ocx CtiBtn ocx 使用上无区别 第二节前台开发控件注册前台开发控件注册 第一种方法 直接在前台电脑上安装前台应用系统 安装后前台开发和使用所需得 接口文件以及相关的支持文件都会存放在所需目录下 并自动注册 第二种方法 在录音服务系统安装完成后 在 C 电话录音系统 AgentReg 下就有 AgentBx OCX CTIBtn OCX 和 AgentCommProj exe 三个文件 如果需要 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 6 页 共 38 页 AgentEOcxXControl ocx 的话我们会另外提供 注册这三个接口 先把它们拷贝到前台电脑 上 如 C Agent 下 然后注册 对于 AgentCommProj exe 来说 只要运行一遍再关闭就 已经注册成功了 对于 AgentBx OCX 和 CTIBtn OCX 则在运行栏上运行 RegSvr32 C Agent AgentBx ocx 如果系统提示注册成功即可 前台还需要运行一下 PrjServer exe AgentBx OCX 才能调用 PrjServer exe PrjServer exe 在服务器的 C 电话录音系统 ServerReg 下 所以也需要把 PrjServer exe 拷贝到前台电脑上 并运行一遍再关闭 第三节服务器服务器 DCOMDCOM 配置配置 首先将 winnt 下的 Guest 用户打开 AgentBx OCX 与 PrjServer exe 之间是通过 DCOM 建立连接的 所以在服务器端必 须进行 DCOM 配置 在服务器端的运行栏内输入 DCOMCNFG 运行后就会去现下图 PrjServer exe 对 应的对象是 AgentQuery Object 所以我们需要对 AgentQuery Object 进行配置 双击 AgentQueryObject 就会出现配置界面如下图 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 7 页 共 38 页 首先配置安全性 点击选中安全性页面 选择使用自定义访问权限自定义访问权限 然后编辑访问权限 点击 编辑 后 会出现权限编辑窗口 把原有 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 8 页 共 38 页 的用户都删除掉 然后添加图中所示的六个用户或用户组就可以了 同理 选择 使用自定义启动权限使用自定义启动权限 并编辑它 编辑的结果与上图一样 使用自定义配置使用自定义配置 权限权限 不做改动 如果前台系统就在服务器本机上 就不需要以上的 DCOM 配置 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 9 页 共 38 页 三 三 功能实现功能实现 第一节第一节初始化设置初始化设置 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 页 共 38 页 是与业务表的关联 在没有业务存在的情况下 我们无须使用该参数 赋空值即可 同理 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 服务器将该分机摘机 如果安装了 DVS 的 CTI 监视器 就可以用 Agentbx 的 Play 方法放 音 如果没有安装 CTI 监视器 就必须通过 CTIbtn ocx 向 DVS 服务器发放音建立请求 发送成功后才可以放音 放音请求的发送 见第四节录放音控制 第四节第四节录放音控制录放音控制 录放音请求的发送是由 CTIbtn ocx 负责完成 1 Ctibtn ocx 与 DVS 系统的连接 将 Ctibtn 的地址设置为 DVS 服务器的地址 设置端口为 9090 用 Open 方法进行 连接 CTIBtn Address 192 1 1 1 Port 9090 默认值 CTIBtn Open Open 后等待 OnConnect 事件表示连接成功 2 控制消息的发送 连接成功后可以发送控制消息 所有的控制消息的发送都是通过 SendCTIMsg 方法 完成 CTIBTn SendCTIMsg editUnique text CTIEvent ItemIndex 1 InorOut ItemIndex 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 11 页 共 38 页 StrtoInt EditAcdNumber Text StrtoInt EditDNIS text EditAgent Text EditExtension text EditCalling text EditCalled text EditTransId text 详细的参数说明请看附录二 放音时 电话拨通后发放音建立消息 电话挂机后发放音结束消息 发放音消息时 CallID 主叫 为话务员分机号 CalledID 被叫 为放音分机号 Extention 分机 为话务员分机 号 这三项必须填写正确 其余参数根据参数意义和实际需要而填写 录音时 电话接通后发送录音消息 主叫 被叫按实际情况赋值 分机是要录音的话务 员的分机号 这三项必须填写正确 其余参数根据参数意义和实际需要而填写 在 CTIBtn OCX 使用完后 我们可以使用它的 Close 方法把它关闭 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 12 页 共 38 页 四 四 附录附录 附录一附录一 AgentBx OCX 接口接口 前台接口控件 前台接口控件 AgentBx ocx 属性属性 propertyproperty ComputerName WideString 说明说明 数据库服务器的机器名 propertyproperty Connected WordBool 说明说明 标志数据库服务器是否连接成功 当由 false 置为 true 时 会根据 ComputerName 连接数据库服务器 propertyproperty AgentName WideString 说明 说明 Agnet 通讯站机器名 一般为空 默认为本机 propertyproperty AgentConn WordBool 说明 说明 标志是否连接到 Agnet 通讯站 当由 false 置为 true 时 会主动连接 propertyproperty HaveLogIn WordBool 说明 说明 标志话务员是否在 DVS 服务器登录 只读 propertyproperty FileLength integer 只读 说明 说明 当前播放语音长度 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 13 页 共 38 页 propertyproperty Position integer 只读 说明 说明 当前播放语音位置 距起始位置秒数 propertyproperty StepLen integer 说明 说明 步进 退 的单位长度 秒 默认为 10 秒 方法方法 functionfunction QuerySysMultiCondition const FirstTime LastTime MinTime MaxTime WorkType Uniquei d Callid CalledId Agent Extention Acd InorOut Wid eString integer 说明 说明 按参数给出的条件进行综合查询 某参数为空时该条件无效 参数 参数 FirstTime 记录的开始时间大于该时间 LastTime 记录的开始时间小于该时间 MinTime 记录的通话时间大于该时间 MaxTime 记录的通话时间小于该时间 WorkType 业务类型 Uniqueid 唯一标识 业务系统产生 Callid 主叫号 CalledId 被叫号 Agent 话务员标识 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 14 页 共 38 页 Extention 分机号 Acd Acd 组号 InorOut 呼入呼出标志 返回值 返回值 查询到的记录数 functionfunction QuerySysRecord const Lsh UniqueGuid UniqueId FirstTime LastTime MinTime MaxTime WorkType Uniqueid Callid CalledId Agent Extention Acd Ino rOut WideString integer 说明 说明 按参数给出的条件进行综合查询 某参数为空时该条件无效 参数 参数 Lsh 流水号 UniqueGuid 记录标识 录音系统产生 UniqueId 记录标识 业务系统产生 FirstTime 记录的开始时间大于该时间 LastTime 记录的开始时间小于该时间 MinTime 记录的通话时间大于该时间 MaxTime 记录的通话时间小于该时间 WorkType 业务类型 Callid 主叫号 CalledId 被叫号 Agent 话务员标识 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 15 页 共 38 页 Extention 分机号 Acd Acd 组号 InorOut 呼入呼出标志 返回值 返回值 查询到的记录数 functionfunction QuerySysDataField RecordSysNo RecordSysIndex integer WideString 说明 说明 从缓冲区中取出查询结果 参数 参数 RecordSysNo 要取第几条记录 RecordSysIndex 取记录中的第几项内容 返回值 返回值 所取记录的项的内容 记录的结构如下 记录的结构如下 recordrecord 流水号0 唯一标识 录音系统产生 1 唯一标识 业务系统产生 2 话务员 3 主叫号码4 被叫号码5 分机号 6 转接前的 ID7 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 16 页 共 38 页 转接后的 ID8 开始时间 9 结束时间10 通话时间11 ACD 号码12 网络识别码13 呼叫标志 14 EndEnd functionfunction QueryWorkTypeRecord const SysRecordNo integer integer 说明 说明 按查询出的记录号查询子业务 参数 参数 RecordSysNo 查询出的第几条记录 返回值 返回值 整数类型 表示查询到的子业务记录数 functionfunction QueryWorkTypeDataField RecordNo RecordIndex integer WideString 说明 说明 从缓冲区中取出子业务查询结果 参数 参数 RecordWorkType 要取第几条子业务记录 RecordWorkTypeIndex 取记录中的第几项内容 每条记录有 8 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 17 页 共 38 页 项 返回值 返回值 所取记录的项的内容 子业务记录的结构如下 子业务记录的结构如下 recordrecord 唯一标识 1 唯一标识子号 2 手机号码3 业务类型4 业务说明 5 其他数据 6 工作时间 7 EndEnd functionfunction QueryTransf RecordSysNo Integer integer 说明 说明 以所选记录号在上一查询结果中的序号为参数 查询与其有 转 接关系的记录 靠 UniqueId 关联 参数 参数 RecordSysNo 所选记录号在上一查询结果中的序号 从 1 开始 返回值 返回值 查询到的记录数 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 18 页 共 38 页 functionfunction QuerySysTransFDataField RecordNo RecordIndex integer WideString 说明 说明 当进行查转接操作后 从缓冲区中取出查询结果 参数 参数 RecordSysNo 要取第几条记录 RecordSysIndex 取记录中的第几项内容 返回值 返回值 所取记录的项的内容 记录的结构如下 记录的结构如下 recordrecord 流水号0 唯一标识 录音系统产生 1 唯一标识 业务系统产生 2 话务员 3 主叫号码4 被叫号码5 分机号 6 转接前的 ID7 转接后的 ID8 开始时间 9 结束时间10 通话时间11 ACD 号码12 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 19 页 共 38 页 网络识别码13 呼叫标志 14 EndEnd functionfunction GetRecordData const Tablepar integer out Data OleVariant WordBool 说明 说明 取查询结果 Delphi 专用 参数 参数 Tablepar 取数据参数 1 取主记录 2 取子业务记录 data 数据 需要付给 ClientDataSet Data 返回值 返回值 操作是否成功 成功为 True functionfunction SaveWorkTypeData const Uniqueid UniqueIdChild CallId WorkType Explain orth erdata WideString WordBool 说明 说明 存子业务记录 参数 参数 Uniqueid 唯一标识 UniqueIdChild 唯一标识子号 CallId 手机号 WorkType 业务类型 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 20 页 共 38 页 Explain 业务类型说明 Ortherdata 其他业务数据 返回值 返回值 操作是否成功 成功为 True functionfunction SaveUniqueId const Uniqueid WideString WordBool 说明 说明 保存由业务系统产生的唯一标识 参数 参数 Uniqueid 唯一标识 返回值 返回值 操作是否成功 成功为 True ProcedureProcedure LogIn const AgentID Extention WideString 说明 说明 登陆函数 调用该函数用来在 DVS 服务器上登陆 参数 参数 AgentID 登陆标识 用于标识登陆者 Extention 分机号 指登陆机器所在位置的分机号 ProcedureProcedure LogOut 说明 说明 退录 用于向 DVS 服务器发出退录消息 ProcedureProcedure SetConn const Address WideString Port 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 21 页 共 38 页 integer 说明 说明 设置 Agent 通讯站与 DVS 服务器连接的 IP 地址和端口号 参数 参数 Address DVS 服务器的 IP 地址 Port 端口号 默认为 6677555 1 为取默认值 FunctionFunction LoadSelectFile RecordSysNo RecordWorkTypeNo integer PlayVoice PlayData WordBool WordBool 说明 说明 装载需要播放的文件 参数 参数 RecordSysNo 选中的记录号 RecordWorkTypeNo 子业务号 PlayVoice 是否播放文件 目前填 true PlayData 是否播放数据文件 目前填 false 返回值 返回值 装载成功为 True 否则为 False procedureprocedure PlayFile 说明 说明 播放装载的文件 第一次调用前必须先调用 LoadSelectFile procedureprocedure PlayWorkType 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 22 页 共 38 页 说明 说明 播放子业务 必须先调用 LoadSelectFile procedureprocedure Pause 说明 说明 暂停播放 procedureprocedure StepPre 说明 说明 步进 procedureprocedure StepBack 说明 说明 步退 ProcedureProcedure PlayLocation Location Integer 说明 说明 指定播放位置播放 参数 参数 Location 播放位置 距起始位置的秒数 procedureprocedure StopPlay 说明 说明 停止播放 procedureprocedure EndPlay 说明 说明 停止播放 服务器会释放该通道 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 23 页 共 38 页 functionfunction GetLastErr WideString 说明 说明 返回错误信息 返回值 返回值 返回错误信息 事件事件 propertyproperty OnServerConn TNotifyEvent 说明说明 与 DVS 服务器建立连接 propertyproperty OnServerBreak TNotifyEvent 说明说明 与 DVS 服务器连接断开 propertyproperty OnLogInSucc TNotifyEvent 说明说明 登录成功 propertyproperty OnPhoneEvent TAgentXOnPhoneEvent 说明说明 电话事件 TypeType TAgentXOnPhoneEvent procedure Sender Tobject out Event Integer ofof object object 参数 参数 PhoneEventPhoneEvent 电话开始 电话开始 1 1 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 24 页 共 38 页 电话结束 电话结束 1 1 propertyproperty OnVoiceSucc TNotifyEvent 说明说明 放音成功 propertyproperty OnVoiceFail TAgentXOnVoiceFail 说明说明 放音失败 TypeType TAgentXOnVoiceFail procedure Sender TObject out Flag Integer ofof object object 参数 参数 Flag Flag 放音失败 放音失败 1 1 无语音文件 无语音文件 1 1 propertyproperty OnStaChange TAgentXOnStaChange 说明说明 播放状态改变 TypeType TAgentXOnStaChange procedure Sender TObject out FromSta Integer out ToSta Integer ofof object object 参数 参数 FromStaFromSta 改变前的状态 改变前的状态 ToStaToSta 改变后的状态 改变后的状态 状态标志 状态标志 播放 播放 101101 暂停 暂停 102102 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 25 页 共 38 页 停止 停止 103103 前台接口控件 前台接口控件 AgentBx ocx 的使用说明 的使用说明 说明 说明 AgentBxAgentBx 控件是提供给前台查询录音信息并播放录音文控件是提供给前台查询录音信息并播放录音文 件件 在使用在使用 AgentBxAgentBx 控件之前请保正以下三点 控件之前请保正以下三点 1 1 当前 Client 端的计算机与 DVS 数据库服务器在同一子网 内 如 DVS 数据库服务器的 IP 地址为 135 20 22 131 子网掩码为 255 255 255 224 则 Client 端的计算机的 IP 地址为 135 20 22 128 135 20 22 159 子网掩码为 255 255 255 224 就能够保证快速在 DVS 数据库服务器到查询录音信息 2 2 运行程序 AgentCommProj EXE 在系统中注册 不必每次 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 26 页 共 38 页 使用之前都进行注册 只有当 AgentCommProj EXE 的存 放位置改变了 才必须重新注册 3 计算机启动时要登录到网络中 要正确使用 AgentBx 控件查询到录音信息并能够正确播放 查询到的录音文件请按以下步骤操作 第一步 第一步 设置设置 DVSDVS 数据库服务器信息数据库服务器信息 ComputerNameComputerName 数据库服务器的机器名 ConnectedConnected 标志是否连接到数据库服务器 当 由 FalseFalse 置为 TrueTrue 时 会主动连接 当以上属性设置好后进行下一步当以上属性设置好后进行下一步 第二步 连接第二步 连接 DVSDVS 服务器服务器 将属性 ConnectedConnected 附值为 truetrue 控件会根据第一步设 置好的 ComputerNameComputerName 属性 连接数据库服务器 第三步 登录第三步 登录 DVSDVS 服务器服务器 1 将属性 AgentNameAgentName 附值为空 属性 AgentConnAgentConn 附值 为 TrueTrue 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 27 页 共 38 页 2 调用方法 SetAgentConn constSetAgentConn const Address Address WideStringWideString Port Port integerinteger 来设置 Agent 通讯站与 DVSDVS 服务器连接的 IP 地址和端口 号 且自动与服务器进行连 接 其中 AddressAddress DVSDVS 服务器的 IPIP 地址 PortPort 端口号 默认为 66775556677555 1 1 为取默认值 等待 OnServerConnOnServerConn 事件触发 3 调用方法 LogInLogIn const const AgentIDAgentID Extention Extention WideStringWideString 来在 DVSDVS 服务器上登录 建议在 OnServerConnOnServerConn 事件中调用此方法 其中 AgentIDAgentID 登录标识 用于标识登录者 ExtentionExtention 分机号 指登录机器所在位置的分 机号 登录成功属性 HaveLogInHaveLogIn 将为 TrueTrue 第四步 查询录音文件信息第四步 查询录音文件信息 查询录音文件信息 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 28 页 共 38 页 调用函数 QuerySysMultiConditionQuerySysMultiCondition const const StartTimeStartTime EndTimeEndTime MinTimeMinTime MaxTimeMaxTime WorkTypeWorkType UniqueidUniqueid CallidCallid CalledIdCalledId AgAg entent ExtentionExtention AcdAcd InorOutInorOut DeviceTabDeviceTab lele WideStringWideString integerinteger 来查询录音文件信息 其中参数为查询的条件 某参数为 空时该条件无效 其中 StartTimeStartTime 记录的开始录音时间大于该时间 EndTimeEndTime 记录的开始录音时间小于该时间 MinTimeMinTime 记录的通话时间大于该时间 MaxTimeMaxTime 记录的通话时间小于该时间 WorkTypeWorkType 业务类型 UniqueidUniqueid 唯一标识 CallIDCallID CallidCallid 主叫号 CalledIdCalledId 被叫号 AgentAgent 话务员标识 ExtentionExtention 分机号 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 29 页 共 38 页 AcdAcd AcdAcd 组号 InorOutInorOut 呼入呼出标志 DeviceTableDeviceTable 备份设备表 查询备份记录用 函数查询的返回值为符合调用时设定的条件查询到的记录 数 即录音文件数 当调用函数 QuerySysMultiConditionQuerySysMultiCondition 后 就可调用 函数 QuerySysDataFieldQuerySysDataField RecordSysNoRecordSysNo RecordSysIndexRecordSysIndex integerinteger WideStringWideString 来获得查询到的录音信息记录 其中 RecordSysNoRecordSysNo 要取查询到的录音信息中 第几条记录 RecordSysIndexRecordSysIndex 取 RecordSysNoRecordSysNo 所指定 的录音信息记录中的第几项内容 每条记录有 13 项 第五步 播放录音文件第五步 播放录音文件 调用函数 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 30 页 共 38 页 LoadSelectFile RecordSysNoLoadSelectFile RecordSysNo RecordWorkTypeNoRecordWorkTypeNo integerinteger PlayVoice PlayDataPlayVoice PlayData WordBoolWordBool WordBoolWordBool 来装载查询到的记录中记录号为 RecordSysNoRecordSysNo 的录 音文件 其中 RecordSysNoRecordSysNo 选中的记录号 RecordWorkTypeNoRecordWorkTypeNo 子业务号 添 PlayVoicePlayVoice 是否播放文件 目前填 TrueTrue PlayDataPlayData 是否播放数据文件 目前填 FalseFalse 函数 LoadSelectFileLoadSelectFile 的返回值为 TrueTrue 表示装载 成功 FalseFalse 表示装载失败 当调用函数 LoadSelectFileLoadSelectFile 成功后 就可调用方 法 PlayFilePlayFile 来播放 LoadSelectFileLoadSelectFile 函 数装载的 录音文件 在录音文件播放过程中 可以调用方法 PausePause StopPlayStopPlay StepPreStepPre StepBackStepBack 来控制播 放 当调用方法 PlayFilePlayFile 播放录音文件成功 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 31 页 共 38 页 后将会触发事件 OnVoiceSuccOnVoiceSucc 如果失败将会触发 事件 OnVoiceFailOnVoiceFail 在播放录音文件过程中 如 果调用方法 PausePause StopPlayStopPlay StepPreStepPre StepBackStepBack 改变了播 放状态将会触发事件 OnStaChangeOnStaChange 在播放录音文件过程中如果 OnServerBreakOnServerBreak 事件产生就将不能够再进行放音 第六步 退录第六步 退录 DVSDVS 数据库服务器数据库服务器 调用过程 LogOutLogOut 从 DVSDVS 数据库服务器退录 退录成 功属性 HaveLogInHaveLogIn 将为 FalseFalse 第七步 断开与第七步 断开与 DVSDVS 数据库服务器的连接数据库服务器的连接 将属性 ConnectedConnected 附值为 FalseFalse 控件将会自动与 DVSDVS 数据库服务器断开连接 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 32 页 共 38 页 附录二附录二 CTIBtn OCX 接口接口 CTI 控件 控件 CTIBx ocx 属性属性 propertyproperty Connected boolean 说明说明 是否连接到服务器 propertyproperty Area string 说明说明 局号 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 33 页 共 38 页 propertyproperty Address String 说明 说明 服务器 IP propertyproperty Port string 说明 说明 服务器端口号 方法方法 ProcedureProcedure Open 说明 说明 连接服务器 ProcedureProcedure Close 说明 说明 关闭连接 FunctionFunction SendCTIMsg const Unique String Event In Out ACDNumber DNIS Integer const Agent Extension Calling Called TransID String Boolean 说明 说明 发送 CTI 命令 参数 参数 Unique 惟一标示 Event 事件类型 1 开始 深圳友邻通讯设备有限公司 前台接口控件 V2 0 第 34 页 共 38 页 2 结束 3 保持 4 继续 5 转接 6 放音建立 7 放音结束 In Out 呼入呼出标志 Time 时间 ACDNumber ACD Number DNIS 网络识别码 Agent 话务员 ID Extension