API工具使用.docx

1、API工具使用EasyApi 简介功能说明Keygoe 是一个独立的设备，可以单独的运行。对于复杂的业务系统，用户可以在 Keygoe 上进行开发，从而构建出独有的、个性化的业务应用。为满足此类用户的需求，东进在 Keygoe 上提供了编程接口，其开发包称为 EasyAPI，下面简要地进行介绍。EasyAPI 提供了一组函数。通过这组函数，应用程序能够与 Keygoe 交互，也能够得到 Keygoe 返回的事件，从而控制 Keygoe 系统。EasyAPI 目前支持的操作系统包括：Microsoft Windows 2000 Professional/Server/Advanced Serve

2、rMicrosoft Windows XP ProfessionalMicrosoft Windows 2003 ServerEasyAPI 对一种新操作系统的支持，只需要进行兼容性测试，而不需要进行驱动程序的开发。EasyAPI 还将推出 Linux 操作系统的版本、Microsof Windows Vista 的版本等。EasyAPI 目前支持的编程语言为 C/C+，但在安装盘中提供了 Java，C#，Delphi第 1 章 概述1-3语言形式的头文件。使用 Microsoft Visual C+系列的以及使用 C+ Builder 等 C/C+的用户可以直接使用安装盘上的头文件开发。对于

3、使用其它语言的用户，需要将函数、数据结构等按照所使用语言的格式进行封装或改写，再进行开发。Keygoe 系统通过 XMS_ctsOpenDevice 将设备与流程对应起来，在 Open 设备时 Keygoe 流程执行模块为该设备选择空闲的服务流程，用户在后续的 API 调用中，必须使用 Open 成功之后的完整 DeviceID。Keygoe 系统通过 XMS_ctsCloseDevice 解除设备与流程之间的关系。关闭设备完成后，当需继续使用该设备进行操作时，将返回错误事件。 绑定：就是物理设备之间进行输入输出。不能跨DSP。LINK：时隙交换，可以跨DSP。文件队列放音（XMS_PLAY_

4、TYPE_FILE_QUEUE）：启动一个指定路径的文件放音。当使用的语音通道设备正在放音时，当前命令指定的文件将被放入放音队列，放音队列最多不能超过 255。SS7 组网有两种方式：直联和准直联。直联工作方式指两个信令点之间的信令消息，通过直接连接两个信令点的信令链路进行传递。准直联工作方式指信令消息经过两个或多个串接的信令链路传送，中间需要经过一个或多个信令转接点。信令点准直连的复杂组网，界面配置选择“标准模式”即可。1，硬件：PC与一台pcs1Ud0系列的设备接在同一局域网中，1U上接了内线，外线，录音模块，并配有两台模拟话机。2，启动配置界面进行配置，因为准备使用模拟电话测试，所以只需

5、在DSP0第三个E1上开30路模拟话路，模块只需添加DSP,流程，媒体即可，其他有需要再填也可以。EasyAPI 屏蔽了各种信令接口的处理细节，向用户提供的是统一的标准呼叫处理接口。如用户调用 XMS_ctsMakeCallOut()即可以实现各种接口的呼出，包括TUP、ISUP、PRI、AnalogTrunk 和 AnalogUser 等各种接口3，要使用工具，首先要在C:DJKeygoeSamples文件夹下找到XMSApi_Test应用程序和XMSApi_Test.INI配置文件。先对配置文件进行编辑。注意修改IP和端口，最后保存。4，启动API工具，XMSApi_Test 程序可演示各

6、 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 d

7、ate:发送信令数据 send app date: 发送APP数据media control interface：媒体控制列表init play index: 初始化播放序列build play index:新建播放序列join to conf:加入会议 leave from conf:离开会议 clearconf:结束会议 使用例子1，呼叫内线话机，拨通并放音。例子2，两台内线座席互拨。例子3，外线呼外线。 外线接KEYGOE外线模块对应接口上。打开这个外线通道，并给这个通道LINK一个VOC资源。主叫方呼叫这个外线号马，呼叫后点ANSWERCALLIN，摘机。双向键切换到VOC，再点PLA

8、Y，这个通道就可以放音了，主叫方能听到这个语音。例子4，外线呼叫内线。呼叫流程为外线先呼叫外线模块，answer以后，将外线模块和选中的内线模块双向link起来，用双向键切换，然后对应可以内线话机直接摘机通话。或者LINK以后对内线话机振铃后再摘机。例子5，使用传真功能。将DevID_Fax与DevID_Voc1进行绑定（不是LINK，只是都添加到DEV中，双向键可以切换），DevID_Fax将借用DevID_Voc1语音通道的时隙，两者一起完成传真收发。将座席USER和DevID_Voc1进行双向LINK建立时隙连接，以便对DevID_Fax的传真声音可以被座席USER听到；座席USER的传真声音可以被DevID_Fax收到。例子六，建立会议，并录音。