API工具使用.docx

API工具使用.docx

《API工具使用.docx》由会员分享，可在线阅读，更多相关《API工具使用.docx（22页珍藏版）》请在冰豆网上搜索。

API工具使用

EasyApi简介

功能说明

Keygoe是一个独立的设备，可以单独的运行。

对于复杂的业务系统，用户可

以在Keygoe上进行开发，从而构建出独有的、个性化的业务应用。

为满足此

类用户的需求，东进在Keygoe上提供了编程接口，其开发包称为EasyAPI，

下面简要地进行介绍。

EasyAPI提供了一组函数。

通过这组函数，应用程序能够与Keygoe交互，也

能够得到Keygoe返回的事件，从而控制Keygoe系统。

EasyAPI目前支持的操作系统包括：

MicrosoftWindows2000Professional/Server/AdvancedServer

MicrosoftWindowsXPProfessional

MicrosoftWindows2003Server

EasyAPI对一种新操作系统的支持，只需要进行兼容性测试，而不需要进行驱

动程序的开发。

EasyAPI还将推出Linux操作系统的版本、MicrosofWindowsVista的版本等。

EasyAPI目前支持的编程语言为C/C++，但在安装盘中提供了Java，C#，Delphi

第1章概述

1-3

语言形式的头文件。

使用MicrosoftVisualC++系列的以及使用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函数、事件的功能。

Closedevice:

关闭设备resetdevice：

重置设备Getdevicelist:

获取每一个DSP上可用设备资源列表

Getboardinfo:

获得板卡信息getdevicestate：

获得设备状态linkdevice:

链接设备CTXLINK：

过机链接Unlinkdevice:

分离设备register:

注册alertcall:

提示对端振铃answercallin:

应答摘机（模拟呼入时用）

Setparam:

设置参数getparam:

获取参数sendiodate:

发送IO数据sendsigdate:

发送信令数据sendappdate:

发送APP数据

mediacontrolinterface：

媒体控制列表

initplayindex:

初始化播放序列

buildplayindex:

新建播放序列

jointoconf:

加入会议leavefromconf:

离开会议clearconf:

 结束会议

使用例子1，呼叫内线话机，拨通并放音。

例子2，两台内线座席互拨。

例子3，外线呼外线。

外线接KEYGOE外线模块对应接口上。

打开这个外线通道，并给这个通道LINK一个VOC资源。

主叫方呼叫这个外线号马，呼叫后点ANSWERCALLIN，摘机。

双向键切换到VOC，再点PLAY，这个通道就可以放音了，主叫方能听到这个语音。

例子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收到。

例子六，建立会议，并录音。