Asterisk+manager+Interface(CN).doc

### Asterisk Manager Interface (AMI) 详解 #### 一、概览 Asterisk Manager Interface (简称 AMI)，是Asterisk系统中的一个重要组件，它为开发者提供了远程管理和监控Asterisk实例的能力。通过AMI，我们可以实现诸如接听、挂断电话、获取电话状态等操作。本文档将详细介绍AMI的基本原理、连接机制、数据包格式以及如何使用PHP脚本来建立与Asterisk的连接并执行一些基本命令。 #### 二、AMI工作原理 AMI是一种基于文本的协议，采用简单的“键值对”格式进行通信。客户端和Asterisk PBX之间通过TCP/IP流进行数据交换。每条命令或事件都以`\r\n`结束，空行（即连续两个`\r\n`）表示一条完整命令或事件的结束。这种方式使得数据的解析变得简单而高效。 #### 三、连接与认证 ##### 3.1 建立连接 要与Asterisk进行管理通信，首先需要通过TCP/IP协议建立连接。默认情况下，Asterisk监听在5038端口上。以下是一个使用PHP脚本建立连接的例子： ```php #!/usr/bin/php-q <?php $timeout=100; $ipaddr="127.0.0.1"; $ipport="5038"; $socket=fsockopen($ipaddr,$ipport,$errno,$errstr,$timeout); if(!$socket) { echo "$errstr($errno)<br/>\n"; } else { echo "connect IP:($ipaddr) success<br/>socket(Resource id #4)<br/>"; fputs($socket,"Action: login\r\n"); fputs($socket,"UserName: admin\r\n"); fputs($socket,"Secret: admin\r\n"); fputs($socket,"Events: off\r\n\r\n"); while(!feof($socket)) { echo fgets($socket, 128); } } fclose($socket); ?> ``` ##### 3.2 用户身份验证 连接成功后，需要通过发送“Login”动作来进行身份验证。这一步骤需要提供用户名和密码。这些凭证必须与在`/etc/asterisk/manager.conf`文件中定义的用户匹配。以下是一个示例配置段落： ```plaintext [freeiris] secret=freeiris deny=0.0.0.0/0.0.0.0 permit=10.0.65.0/255.255.255.0 writetimeout=100 read=system,call,log,verbose,command,agent,user write=system,call,log,verbose,command,agent,user ``` #### 四、数据包类型 AMI中的数据包主要分为三种类型： 1. **Action**：由管理客户端发送给Asterisk的命令。命令名称位于数据包的第一行，后面跟随一系列参数。 2. **Response**：Asterisk对客户端命令的响应。响应通常包含状态信息，如成功或失败等。 3. **Event**：Asterisk主动向客户端发送的通知，用于报告系统中发生的事件，比如呼叫状态的变化等。 #### 五、命令集功能介绍 ##### 5.1 命令集 AMI支持多种命令，包括但不限于登录、注销、获取状态等。这些命令由Asterisk的核心模块或插件定义，并且可以随时扩展。 ##### 5.2 操作示例 - **登录**：`Action: Login\r\nUsername: admin\r\nSecret: admin\r\nEvents: off\r\n\r\n` - **注销**：`Action: Logoff\r\n\r\n` - **获取通道状态**：`Action: Status\r\n\r\n` #### 六、事件类型 事件是指由Asterisk发出的通知，用于告知客户端系统中发生的各种情况。常见的事件包括： - **新通道创建**：当一个新的通道被创建时触发。 - **通道状态改变**：当通道的状态发生变化时触发。 - **挂断通道**：当通道被挂断时触发。 #### 七、总结 Asterisk Manager Interface (AMI) 提供了一个强大的工具箱，使得开发人员能够轻松地与Asterisk PBX进行交互。通过AMI，不仅可以监控系统的状态，还可以实现对电话呼叫的控制。掌握AMI的基本原理和使用方法对于Asterisk的部署和维护来说至关重要。希望本文档能帮助您更好地理解和使用AMI。