统一BS软电话程序员开发与维护接口手册（2.1）.doc

PAGE 受控状态： 生效日期： 2006-03-10 拟制： 曹跃军 审核： 批准： 系统维护手册 统一BS软电话程序员开发与维护接口手册2.1 北京合力金桥软件技术有限责任公司 联系人:李晨(市场刘晓丰(技术PAGE ii PAGE i 文档变更记录 序号 变更日期 文档版本号 变更号 变更内容简述 1 2006.03.10 1.0 无 详细介绍接口开发和维护 2 2006.05.31 1.0 新增录放音接口，以“色”加以区别 3 2008.03.07 2.0 在的基础上新增接口：咨询变会议、静态增加技能组信息扩展、动态增加一个技能组、动态删除一个技能组、提交动态技能组变更后的信息.Holly版同步数据在满足系统特定字段外可以用户定制 4 2008.07.31 2.1 在的基础上新增接口:结束整理；业务参数数据接口、CTI系统业务数据操作接口 新增属性：当前坐席密码、呼入呼出方向标识 5 2010.06.28 2.1 在的基础补充事件和事件参数及 目录 TOC \o 1-5 \h \z \u 一、简介 1 1.1文档目的 1 1.2编写人员 1 1.3预计读者 1 1.4术语、定义和缩略语 1 1.5其它相关文档 1 二、统一软电话接口说明 1 2.1产品概述 2 2.1.1 产品组成 2 2.1.2 上层软件开发平台 2 2.2软件设计 3 2.2.1整体描述 3 2.2.2软电话接口方法 3 软电话初始化方法 3 软电话基本接续动作异步处理方法 3 软电话基本数据处理的同步方法 4 软电话线路信息处理的同步方法 5 软电话统计信息处理的同步方法 6 软电话放音方法 7 动态调整坐席所属的技能组信息（事务处理方法）（2.0新增） 7 业务参数数据操作同步方法（2.1新增） 7 CTI系统业务数据操作同步方法（2.1新增） 7 2.2.3软电话属性 8 枚举常量属性 8 .1状态类型 8 .2呼叫类型 9 .3设备类型 9 .4接听电话权限类型 9 .5监控类型 10 .6线路信息挂机标志 10 .7 CTI业务类型 10 软电话基本属性 10 2.2.4软电话事件 11 2.3软电话状态转化图： 13 2.4程序员调用 13 2.5软电话配置说明 15 2.6接口测试 20 三、常见问题说明 21 3.1软件设计遗留问题 21 3.2软电话接口使用常见问题 22 四、使用技巧 22 PAGE 2 PAGE 1 一、简介 1.1文档目的 统一BS软电话是在统一CS软电话的基础上，封装软电话的状态，提供通用的属性和事件处理。不同项目软电话版本不同，即使同一类型的CTI在不同项目实施中也存在不同版本，不利于项目实施、也不利于项目维护；为了能大大提高项目中软电话开发和调试效率，发布本接口。 本文档遵照各个项目的不同，做到调用接口统一、状态控制统一、大部分软电话状态统计数据统一，支持不同CTI来完成软电话统一的； 本文档在于指导程序员在不同项目中实现共享，提供开发统一接口，不能等同应用产品。 1.2编写人员 产品研发项目经理或指定人员。 1.3预计读者 实施、维护、研发部门相关开发程序员。 1.4术语、定义和缩略语 简要介绍用到的术语、定义和缩略语。 多数据基本格式：字段之间用逗号“,”间隔，记录之间用分号“;”间隔 1.5其它相关文档 《统一软电话Bs需求.doc》 《统一软电话cs程序员开发与维护接口手册(2.1).doc》 各CTI版本下具体实现特别说明文档 二、统一软电话接口说明 从产品概述、软件设计、状态转化图、程序员调用、配置说明、接口测试等方面来详细介绍 2.1产品概述 2.1.1 产品组成 本产品包由四个部分组成，分别是：一个接口Activex控件、一个通用接口库和n个中间件（hollyContact、Huawei、genesys……）实现库，软电话配置文件、日志生成库、日志配置文件以及demo测试程序。以文件方式发布。分别是： 接口层文件――UniSoftphone.Ocx、SoftphonePubilcInterface.dll 项目实现层文件――SoftPhoneForHollyCon