java jtapi_JTAPI 入门 （二）

CallObserver

○　Call 事件侦听接口，实现此接口。我们可以侦听到 Call 所发出的所有事件。在实际开发中，必须要实现此接口，或者其子接口。因为，这是介入进行处理操作的基础。

ConnAlertingEv  : 这是振铃事件

ConnDisconnectedEv : 这是挂机事件

ConnFailedEv ： 这是拨号失败的事件，使用这个事件，可以在拨号失败之后处理后事。。 　　　　　○　Call Control Extension 扩展接口： CallControlCallObserver   --- 在实际开发当中，我们会实现这个接口，而不是 CallObserver 。因为可以得到更完整的事件。

CallCtlConnAlertingEv： 振铃事件。。要注意，CallObserver 虽然也有 ConnAlertingEv ，但是这个事件能够得到更多的状态和数据信息，自然也就更好。

CallCtlConnDisconnectedEv： 这是挂机事件。。。不过，如果不需要更多信息，用 ConnDisconnectedEv 可以少输入几个字母。。^-^

CallCtlConnDialingEv： 就是按键输入事件，可以使用方法 getDigits() 来获取输入的按键。这是一次性的获取，有时不是很靠谱，所以在用时，最好先试一下好不好使。

在 Cisco JTAPI 中，提供另外的一些事件来处理按键，在后面有说

CallCtlConnEstalishedEv： 拿起话筒事件。。。这个事件，在一些处理中非常有用。不过，由于拨号双方都会拿起话筒，所以会有两个这样的事件，在用时要分清楚。

CallCtlConnOfferedEv:  在使用 Cisco CTI Port 和 CTI RoutePoint 这样的逻辑话机时，就要在这个事件进行 accept 操作。

.... 更多

Terminal

○　表示一个终端设备，包括逻辑终端和物理终端。如物理话机，SoftPhone，手机。。甚至对讲机等

○　主要方法包括：

addObserver() ： 添加 Terminal 层面的事件侦听器

addCallObserver() ： 添加  Call 事件侦听器 (见 CallObserver)

getAddresses() : 获取此话机的所有 Address (即号码对象)，一台可用话机，通常会有一或多个号码

getName()：话机的唯一名称，在 Cisco 中。物理话机通常是一个 MAC 地址，而在逻辑话机，会是一个由字母数字组成的名称。

getProvider() ： 获取 Provider

○　Cisco 实现类： CiscoTerminal   --- 同样将提供更多丰富的功能

getIPV4Address() : 获得 Terminal 的 IP 地址。。。这个地址也可以通过 AXL API 获取

pickup()：呼叫代答

sendData() ： 推送信息到 Phone 中显示，可以用来推送一些即时提示信息

○　Cisco 的虚拟逻辑话机： CtiPort   -- 可以作为一台物理话机使用

◆　是 CCM 内部的一台虚拟话机

◆　每个 CtiPort 只能起一个 Call

◆　通常用来播放语音提示。例如，控制一个 CtiPort 拨打某个指定号码，然后播放一段已经录制好的语音。

◆　CtiPort 对应的类： CiscoMediaTerminal

register() : 注册使用 CtiPort  --- 要指定语音编码协议等

setRTPParams() : 设置 RTP 语音流的参数(如端口等)

○　Cisco 虚拟逻辑总机：  Cti RoutePoint   --- 可以作为一台总机使用，同时接入多个呼叫请求

◆　是 CCM 内部的虚拟话机

◆　能够并发接入多路呼叫。。。CCM 8.x 以上，每个 CTI RoutePoint 可以并发接入多达 4 千个呼叫 (服务器物理性能允许的情况下)

◆　可以实现语音呼叫处理逻辑。。。例如，简单的 Call Center 的语音流程。。实际上 Cisco Call Center Server 就是使用 CTI RoutePoint 来实现语音流程

◆　Cti RoutePoint 对应的类： CiscoRouteTerminal

register() : 注册使用 CtiPort  --- 要指定语音编码协议等

setRTPParams() : 设置 RTP 语音流的参数(如端口等) 　　　　　　　　◆　 在方法提供上，似乎没什么特别之外，其他差异是在事件处理上。当使用 accept 接入时，呼叫将进入一个内部队列，排队等待处理。所以 RoutePoint 能够处理多个呼叫。

TerminalObserver

○　Terminal 层面的事件侦听接口。。能够接收到 Terminal 层面的事件，例如语音流方面。不过，由于 Terminal 与底层实现的相关性较强，所以标准并没有太多内容

○　Cisco 实现类： CiscoTermEv     --- Cisco 提供了比较多的底层事件支持，并且如果要使用 CTIPort 或 CTI RoutePoint 的话，就必须用到这些事件。

CiscoMediaOpenLogicalChannelEv :   为 CTIPort 或 CTI RoutePoint 设置语音参数，例如  RTP URL ( IP + 端口号)

CiscoRTPInputStartedEv : 开始接收对方的语音输入(语音流)，在本事件中，可以得到 RTP URL，这样我们可以将语音流定向到其他目地的，例如文件。

CiscoRTPInputStoppedEv: 停止语音输入事件，可能是挂机，又或者转接，会议之类的操作，停止了语音输入。

CiscoRTPOutputStartedEv: 开始向对方输出语音流

CiscoRTPOutputStoppedEv: 停止向对方输出语音流。

在使用上述事件时，要留意： CiscoRTPInputStartedEv 与 CiscoRTPOutputStartedEv 的触发，并没有顺序。也就是，不要假设顺序。

Connection

○　Connection 是连接 Call 与 Address 的连接对象。

disconnect() : 断开连接，相当于挂机

getCall(): 获得所关联的 Call

getAddress()： 获得所关联的 Address

○　Call Control Extension 扩展：  CallControlConnection  --- 提供更多的方法

accept(): 接入来电。对于一些特殊的 Terminal 有特定的用途。例如 Cisco CTIPort & CTI RoutePoint ，就必须明确使用本方法来接入来电。当然，新版本

的 Cisco CCM (如 8.x 之后)，可以在 CCM 配置层面，进行 auto accept 操作。不过，编程的灵活性就没了。

reject():  拒绝接入来电。

redirect() ： 重定向到另一个地址。。。例如，判断是某些特定的号码，然后转向到另一些号码(类似号码自动分派)

○　Cisco 的扩展： CiscoConnection

CiscoConnection 是对 CallControlConnection 进行扩展。最重要的功能，就是提供更丰富 redirect() 方法功能，例如配合 CCM 中 CSS 进行更加细致的分隔和重定向

也就是说，可以制定更加丰富和复杂的呼叫路由。

TerminalConnection

○　TerminalConnection 是连接 Connection 与 Terminal 的连接对象。意味着 TerminalConnection 不能单独存在，必须依附于 Connection

answer():  接听来电。特别是对于 Cisco CTIPort & CTI RoutePoint 这样的逻辑话机，必须使用本方法来接听来电。

getTerminal(): 获取关联的 Terminal

getConnection() ： 获取关联的 Connection

○　Call Control Extension 扩展： CallControlTerminalConnection

hold(): 暂时  “hold”住通话

○　Cisco 的扩展/实现：  CiscoTerminalConnection ---提供一些较底层或特有的方法，例如:  startRecording() 。。启动 Cisco CCM 的 BIB 方式录音功能。

2.4 开发过程常用事件

由于我们要靠事件来介入整个呼叫流程，所以了解和研究事件，就成为开发学习的主要任务。如果不清楚有那些事件，在某个阶段会触发那些事件，那就意味着你什么也做不了。下面列出开发常用事件，以供参考：

如果是 Cisco CTi Port & CTI RoutePoint 的编程，用到的事件还会多。例如： CallCtlConnOfferedEv 事件，我们的 CTI Port & CTI RoutePoint 必须在这个事件中进行一个 accept() 动作，用来接受拨打入来的电话，否则对方就无法拨入而听到忙音。

(待续...)