pdt系统二次开发接口设计方案(编辑修改稿)

pdt系统二次开发接口设计方案(编辑修改稿)内容摘要：

S I P _ C A L L _ R EL E AS E_ R EQ( B Y E )P D T 系统二次开发程序 PDT 系统二次开发接口 设计方案 第 13 页 共 32 页 Ha 版权所有 侵权必究 API 二次开发接口方案优缺点 优点： 1) API作为传统的二次开发接口的表现形式，很容易被二次开发者接受； 2) API作为二次开发接口， 对 PDT系统的内部信息能够很好的封装， API服务与 PDT系统可以用任何自定义的私有协议进行通信，对二次开发用户具有很好的透明性； 3) API对二次开发接口的 业务类 与 管理类 功能，均可定义对应的 API实现。 缺点： 1) API作为二次开发接口的表现形式，必然需要给用户提供类似于 Windows系统的 dll文件，让用户进行二次开发。 根据 API提供的文件的不同，就需要对二次开发用户所用的操作系统和开发工具进行限制； 2) API的可扩展性有一定的不足，且对于版本管理有一定的要求，而且新提供版本以后，二次开发程序大多需要重编译，而对 于 SIP、 XML二次开发方案则能很好的规避这种缺陷。 API 二次开发接口方案 简述 设计思路要点 API二次开发接口方案预先定义一组结构和函数，以文件的形式提供给二次开发者使用。 API二次开发接口方案以二次开发程序调用函数，系统利用回调函数返回事件数据完成交互。 二次开发用户程序与 PDT系统的通信关系图如下： P D T 系 统用 户 程 序F u n c t i o n ( P a r a m e t e r s )连 接 ： R T P / R T C P （ 业 务 类 用 户 面 ）A P I 文 件( d l l / s o 等 )C a l l B a c k F u n c t i o n ( E v e n t D a t a )业 务 类 控 制 面 管 理 类 API二次开发接口方案在 PDT 系统内部的提供方式示意图： PDT 系统二次开发接口 设计方案 第 14 页 共 32 页 Ha 版权所有 侵权必究 管 理 类 数 据 库（ D B ）管 理 类 网 管 服 务（ N M S ）业 务 类 控 制 面（ C C C ）业 务 类 数 据 面（ H S W ）A P I 封 装数 据 库 连 接A P I 封 装A P I 封 装透 传二 次 开 发 接 口 服 务S N M PR T PP D T 集 群 系 统二次开发用户程序A P ID S ST C PS I P API 定义 函数格式： PDT_主功能名 _子功能名 ( 参数列表 ) 回调函数格式： PDT_CALLBACK_FUNCTION ( 事件类型 , 成功标志 , 事件数据 ) 事件类型有两种： 1） 调用函数的响应事件 事件类型名：函数名 _Ack 2） PDT 系统主动上报的事件 事件类型名： PDT_主功能名 _子功能名 _Ind 用户不需要调用函数响应的事件 PDT_主功能名 _子功能名 _Req 用户需要调用函数进行响应的事件 API方式的交互原理图： PDT 系统二次开发接口 设计方案 第 15 页 共 32 页 Ha 版权所有 侵权必究 二次开发用户程序PDT集群系统请 求 （ 调 用 函 数 ）响 应 （ 回 调 函 数 ）命 令 （ 回 调 函 数 ）回 应 （ 调 用 函 数 ）R T P API方案各函数事件实际的例子 详见 API二次开发方案 “ FOACSU 单呼场景 ”中的应用。 典型处理流程简述 为便于说明 API二次开发接口方案设计思路，特描述 12个典型场景。 FOACSU 单呼场景 PDT 系统二次开发接口 设计方案 第 16 页 共 32 页 Ha 版权所有 侵权必究 P D T 系统获取话权情况二次开发程序P D T 系统 A PI 服务二次开发程序获取话权情况被叫摘机被叫拒绝主叫取消系统拒绝呼叫 主叫挂机系统允许呼叫 主叫振铃333alt111alt2222alt R T P / R T C P 发送语音 ( 二次开发程序 )M S C A P I Ca l lC a l l Ba c k F u n ct i o n ( 事件类型 , 事件成功标志 , 事件数据 , . . . )( 事件类型 = P D T _ C C _ T X G R AN T _ I n d。 事件成功标志 = S u c c e ss。 事件数据 = T X _ G R AN T , 授权目的号码 )C a l l Ba c k F u n ct i o n ( 事件类型 , 事件成功标志 , 事件数据 , . . . )( 事件类型 = P D T _ C C _ M A I N T _ A ck。 事件成功标志 = S u c c e ss。 事件数据 = T X _ G R AN T , 授权目的号码 )C a l l Ba c k F u n ct i o n ( 事件类型 , 事件成功标志 , 事件数据 , . . . )( 事件类型 = P D T _ C C _ T X G r a n t _ I n d。 事件成功标志 = S u c c e ss。 事件数据 = E N _ P T T )P D T _ C C _ M A I N T ( P T T _ O N , . . . )P D T _ C C _ M A I N T ( P T T _ O F F , . . . )C a l l Ba c k F u n ct i o n ( 事件类型 , 事件成功标志 , 事件数据 , . . . )( 事件类型 = P D T _ C C _ M A I N T _ A ck。 事件成功标志 = S u c c e ss。 事件数据 = E N _ P T T )P D T _ C C _ C a l l Se t u p ( 被叫号码 , 呼叫类型 , . . . )C a l l Ba c k F u n ct i o n ( 事件类型 , 事件成功标志 , 事件数据 , . . . )( 事件类型 = P D T _ C C _ C a l l C o n n e c t _ I n d。 事件成功标志 = S u c c e ss。 事件数据 = C a l l e d C o n n e ct )C a l l Ba c k F u n ct i o n ( 事件类型 , 事件成功标志 , 事件数据 , . . . )( 事件类型 = P D T _ C C _ C a l l C a n c e l _ I n d。 事件成功标志 = S u c c e ss。 事件数据 = C a l l e d R e f u se C a l l )C a l l Ba c k F u n ct i o n ( 事件类型 , 事件成功标志 , 事件数据 , . . . )( 事件类型 = P D T _ C C _ C a l l Se t u p _ A ck。 事件成功标志 = F a i l。 事件数据 = S y s t e mR e f u s e C a l l )C a l l Ba c k F u n ct i o n ( 事件类型 , 事件成功标志 , 事件数据 , . . . )( 事件类型 = P D T _ C C _ C a l l Se t u p _ A ck。 事件成功标志 = S u c c e ss。 事件数据 = C a l l R i n g i n g )C a l l Ba c k F u n ct i o n ( 事件类型 , 事件成功标志 , 事件数据 , . . . )( 事件类型 = P D T _ C C _ C a l l C a n c e l _ A ck。 事件成功标志 = S u c c e ss )P D T _ C C _ C a l l C a n c e l ( 取消原因 , . . . ) PDT 系统二次开发接口 设计方案 第 17 页 共 32 页 Ha 版权所有 侵权必究 XML 二次开发接口方案设计思路 XML 二次开发接口方案出发点 XML具有很强的 开放性，使得许多软件生产商提供的软件产品支持 XML，使得 XML成为不同用户的异构应用系统之间的数据交换的标准语言，具备了数据交换的透明性、各个用户只要保证自己的信息系统提供的数据符合 XML规范，就不用担心数据接收方的解码问题。 XML不依赖于实现语言和运行环境，且具有很强的可读性和易用性，利用 XML作为二次开发接口方案具有很明显的优点。 对于目前 PDT系统 业务类 的 采用的 SIP协议 和网管类 采用 的 SNMP协议 ， XML都可以以嵌入 SIP与 SNMP的方式兼容， 而且 XML很容易扩展一些 SIP、 SNMP等标准协议不容易扩展的内容， 故引发出 XML二次开发接口方案。 更对分析可参见“ 方案由来 ”章节。 P D T 系统获取话权情况二次开发程序P D T 系统 A PI 服务被叫挂机主叫挂机333alt33alt11alt22alt R T P / R T C P 接收语音 ( 二次开发程序 )C a l l Ba c k F u n ct i o n ( 事件类型 , 事件成功标志 , 事件数据 , . . . )( 事件类型 = P D T _ C C _ T X G R AN T _ I n d。 事件成功标志 = S u c c e ss。 事件数据 = T X _ G R AN T , 授权目的号码 )C a l l Ba c k F u n ct i o n ( 事件类型 , 事件成功标志 , 事件数据 , . . . )( 事件类型 = P D T _ C C _ C a l l C a n c e l _ I n d。 事件成功标志 = S u c c e ss。 事件数据 = C a l l e d C a n c e l )C a l l Ba c k F u n ct i o n ( 事件类型 , 事件成功标志 , 事件数据 , . . . )( 事件类型 = P D T _ C C _ C a l l C a n c e l _ A ck。 事件成功标志 = S u c c e ss )P D T _ C C _ C a l l C a n c e l ( 挂机原因 , . .。