API工具使用讲述.docx

EasyApi 简介 功能说明 Keygoe 是一个独立的设备，可以单独的运行。对于复杂的业务系统，用户可 以在 Keygoe 上进行开发，从而构建出独有的、个性化的业务应用。为满足此 类用户的需求，东进在 Keygoe 上提供了编程接口，其开发包称为 EasyAPI， 下面简要地进行介绍。 EasyAPI 提供了一组函数。通过这组函数，应用程序能够与 Keygoe 交互，也 能够得到 Keygoe 返回的事件，从而控制 Keygoe 系统。 EasyAPI 目前支持的操作系统包括： Microsoft Windows 2000 Professional/Server/Advanced Server Microsoft Windows XP Professional Microsoft Windows 2003 Server EasyAPI 对一种新操作系统的支持，只需要进行兼容性测试，而不需要进行驱 动程序的开发。 EasyAPI 还将推出 Linux 操作系统的版本、Microsof Windows Vista 的版本等。 EasyAPI 目前支持的编程语言为 C/C++，但在安装盘中提供了 Java，C#，Delphi 第 1 章 概述 1-3 语言形式的头文件。 使用 Microsoft Visual C++系列的以及使用 C++ Builder 等 C/C++的用户可以直 接使用安装盘上的头文件开发。对于使用其它语言的用户，需要将函数、数据 结构等按照所使用语言的格式进行封装或改写，再进行开发。 Keygoe 系统通过 XMS_ctsOpenDevice 将设备与流程对应起来，在 Open 设备 时 Keygoe 流程执行模块为该设备选择空闲的服务流程，用户在后续的 API 调 用中，必须使用 Open 成功之后的完整 DeviceID。 Keygoe 系统通过 XMS_ctsCloseDevice 解除设备与流程之间的关系。关闭设备 完成后，当需继续使用该设备进行操作时，将返回错误事件。 绑定：就是物理设备之间进行输入输出。不能跨DSP。 LINK：时隙交换，可以跨DSP。 文件队列放音（XMS_PLAY_TYPE_FILE_QUEUE）：启动一个指定路径的 文件放音。当使用的语音通道设备正在放音时，当前命令指定的文件将被 放入放音队列，放音队列最多不能超过 255。 SS7 组网有两种方式：直联和准直联。 直联工作方式指两个信令点之间的信令消息，通过直接连接两个信令点的信令链路进行传递。 准直联工作方式指信令消息经过两个或多个串接的信令链路传送，中间需要经 过一个或多个信令转接点。信令点准直连的复杂组网，界面配置选择“标准模式”即可。 1，硬件：PC与一台pcs1Ud0系列的设备接在同一局域网中，1U上接了内线，外线，录音模块，并配有两台模拟话机。 2，启动配置界面进行配置，因为准备使用模拟电话测试，所以只需在DSP0第三个E1上开30路模拟话路，模块只需添加DSP,流程，媒体即可，其他有需要再填也可以。 EasyAPI 屏蔽了各种信令接口的处理细节，向用户提供的是统一的标准呼叫处 理接口。如用户调用 XMS_ctsMakeCallOut()即可以实现各种接口的呼出，包括 TUP、ISUP、PRI、AnalogTrunk 和 AnalogUser 等各种接口 3，要使用工具，首先要在C:\DJKeygoe\Samples\文件夹下找到XMSApi_Test应用程序和 XMSApi_Test.INI配置文件。 先对配置文件进行编辑。注意修改IP和端口，最后保存。 4，启动API工具，XMSApi_Test 程序可演示各 API 函数、事件的功能。 Close device :关闭设备 reset device：重置设备 Get device list:获取每一个DSP上可用设备资源列表 Get board info : 获得板卡信息 get device state：获得设备状态 link device:链接设备 CTXLINK：过机链接 Unlink device:分离设备 register:注册 alert call:提示对端振铃 answer call in:应答 摘机（模拟呼入时用） Set param:设置参数 get param:获取参数 send io date:发送IO数据 send sig date:发送信令数据 send app date: 发送APP数据 media control interface：媒体控制列表 init play index: 初始化播放序列 build play index:新建播放序列 join to  HYPERLI