Asteriskmanager+API(中文文档).doc

Asterisk manager API（AMI）文档(中文版) 一种简单的key: value协议用于已连接的管理客户端和asteriskＰＢＸ之间的信息传递。每行都用回车换行（\r\n）来结束。 命令集功能介绍 概述 协议特点 在发送命令前，你必须建立一个连接。 下面是以php脚本语言所建立起来的连接 #!/usr/bin/php -q ?php $timeout = 100; $ipaddr = ; $ipport = 5038; $socket = fsockopen($ipaddr,$ipport,$errno,$errstr,$timeout); if (!$socket) { echo $errstr ($errno) br\\n; } else { echo connect IP:($ipaddr) success; echo socket ($socket); 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); ? 程序运行后显示如下： [root@uccp_2 test]# ./test.php connect IP:() successsocket (Resource id #4)Asterisk Call Manager/1.1 Response: Success Message: Authentication accepted 在认证后，数据包任何时间都可以在两个方向上互相传输。 数据包第一行为Action时表明是由管理客户端发送到asterisk，第一行为Event或Response表明有asterisk发送到管理客户端。数据包内各行顺序可以变化，对数据包没有影响。 回车换行由于区分每一行，空行（两个连续回车换行）用于表明命令结束，Asterisk开始处理命令。 数据包类型 数据包的类型通过一下几种关键字来划分 Action:一个由管理客户端发送到Asterisk的数据包，请求执行特定的动作。只有有限的几种动作供客户端使用，每个动作是由Asterisk服务器上的模块所决定的。一次只能执行一个动作，该动作数据包包含了动作名称以及执行所必需的参数。 Response:Asterisk对管理客户端动作的响应。 Event: 有关Asterisk核心或扩展模块发生事件的信息。 建立管理连接和用户身份验证 为了与Asterisk进行管理通话，管理客户端必须建立到Asterisk服务器侦听端口（一般是5038）的TCP/IP连接，并使用登陆动作进行身份验证。这就要求在Asterisk服务器上创建用户账户，用户账户在/etc/asterisk/manager.conf中配置。账户由允许登陆的主机，登录密码以及被授予的权限列表组成。 登录和身份验证的经理，你必须发送一个 登录 行动，用您的用户名和秘密（密码作为参数）。 Here is an example:下面是一个例子：(允许10.0.65.*主机进行连接) Action: login Username: admin Secret: secret cat manager.conf [general] displaysystemname = yes enabled = yes webenabled = no port = 5038 ;httptimeout = 60 bindaddr = displayconnects = yes timestampevents = yes [freeiris] secret = freeiris deny=/ permit=/ writetimeout = 100 read = system,call,log,verbose,command,agent,user write = system,call,log,verbose,command,agent,user 你还可以通过Events: off阻止事件数据包发送到你的连接。例如： Action: login Username: admin Secret: secret Events: off 动作数据包： 向Asterisk发送动