Asterisk AMI 接口整理

目录

一、简介

二、访问形式

 三、AMI接口分类

 四、AMI接口整理    


一、简介

      AMI  (Asterisk Manager Interface)。是Asterisk的管理接口。通过此接口,可以实现对Asterisk系统的监控和控制。
        参见官网:https://wiki.asterisk.org/wiki/pages/viewpage.action?pageId=4817239
        参见AMI教程:http://asterisk-java.org/tutorial/
        Asterisk其他相关总结文档:

二、访问形式

        AMI提供两种方式的访问,TCP形式的和HTTP形式的, 而HTTP形式的又可以分普通连接和TLS连接两种。manager.conf配置文件中有若干AMI的配置,如果使用HTTP形式的接口,还需要配置http.conf文件中的相关配置。

 三、AMI接口分类

        
        AMI提供的的接口分为Event和Action。
        1、Event为从Asterisk服务单向向AMI CLIENT发送的事件通知。
        2、Action为AMI CLIENT发送请求,然后Asterisk给予回复。Action也允许先返回若干Event再返回Action Response的情况。

 四、AMI接口整理    

      Asterisk AMI接口源码下载地址:http://download.csdn.net/detail/manageruser/9912291

      Asterisk AMI在线手册下载地址:http://download.csdn.net/download/manageruser/9912321

package AMIapiBase;

import java.io.IOException;

import org.asteriskjava.manager.TimeoutException;
import org.asteriskjava.manager.action.CommandAction;
import org.asteriskjava.manager.action.ConfbridgeKickAction;
import org.asteriskjava.manager.action.ConfbridgeListAction;
import org.asteriskjava.manager.action.ConfbridgeMuteAction;
import org.asteriskjava.manager.action.ConfbridgeUnmuteAction;
import org.asteriskjava.manager.action.DbDelAction;
import org.asteriskjava.manager.action.DbGetAction;
import org.asteriskjava.manager.action.DbPutAction;
import org.asteriskjava.manager.action.ExtensionStateAction;
import org.asteriskjava.manager.action.GetConfigAction;
import org.asteriskjava.manager.action.GetVarAction;
import org.asteriskjava.manager.action.HangupAction;
import org.asteriskjava.manager.action.MonitorAction;
import org.asteriskjava.manager.action.OriginateAction;
import org.asteriskjava.manager.action.UpdateConfigAction;
import org.asteriskjava.manager.response.ManagerResponse;

public class AMIApp {
	
	public AMIApp(){}
	
	public ManagerResponse AMIAPP_CallExtension(String channel,String exten)
			throws IllegalArgumentException, IllegalStateException, IOException, TimeoutException{
		//实例化命令响应对象
		ManagerResponse response = new ManagerResponse();
		//实例化Originate命令对象
		OriginateAction originate = new OriginateAction();
		
		originate.setActionId(ConnectAMI.getActionID("call"));   	// 设置actionid
		originate.setChannel("SIP/"+channel);						// 设置主叫分机
		originate.setContext("internal");				   	// 设置路由器
		originate.setExten(exten);						// 设置被叫分机
		originate.setPriority(new Integer(1));				// 设置进入dialplan优先级
		originate.setTimeout(new Long(30000));				// 设置呼叫超时
		originate.setCallerId(exten);		
		originate.setAsync(true);  							// 设置异步才会有结果返回
		
		response = ConnectAMI.getConnect().sendAction(originate);
		
		return response;
	}
	// 挂断某个通道
	public ManagerRespon
<think>好的,我现在需要解决用户关于如何使用Python调用AMI Client拨打电话的问题。用户提到了AsteriskAMI接口,我需要先回忆相关知识。 首先,AMIAsterisk的管理接口,允许通过TCP连接发送命令控制Asterisk。用户需要Python的示例代码,所以应该找一个合适的库。记得有一个asterisk-ami的库,或者可能需要使用其他模块? 然后,查看用户提供的引用内容,引用[1]中有一个示例代码,使用了asterisk.ami中的AMIClient和SimpleAction。这应该是正确的方向。代码中的CallSip函数创建了客户端,登录,然后发送Originate动作来拨打电话。需要确认参数是否正确,比如Channel、Exten、Context等。 接下来,我需要检查代码中的关键部分是否正确。比如,AMI服务器的地址、端口、用户名和密码是否正确配置。然后,Originate动作的参数是否合理。例如,Channel应该是SIP/分机号,Exten是目标号码,Context是拨号规则,CallerID是显示的主叫号码。 用户可能遇到的问题包括连接失败,比如IP或端口错误,认证失败,或者Context配置不正确。需要提醒用户检查这些部分。另外,代码中发送了两次action,这可能是个错误,应该只发送一次。 另外,引用[2]提到Asterisk是开源的PBX,支持IVR,这可能和用户的问题无关,但可以确认用户的环境是否正确安装和配置了Asterisk。 总结步骤:导入库,创建客户端并登录,构造Originate动作,发送动作,处理响应。需要确保参数正确,代码示例中的错误(如重复发送)需要修正。同时,提醒用户依赖库的安装,比如使用pip安装asterisk-ami。 可能用户遇到的问题还包括库的版本兼容性,或者AMI权限不足,需要检查Asterisk的manager.conf配置,确保用户有权限发起外呼。此外,Context MAIN_OUTGOING是否正确配置了拨号规则,比如如何路由呼叫。 最后,生成相关问题,帮助用户深入理解,比如如何处理异步响应,错误处理,或者其他AMI操作如监控通话状态等。</think>以下是根据Asterisk官方文档和常见开发实践整理的Python AMI客户端拨号实现方案: ### Python调用AMI Client外呼实现步骤 1. **安装依赖库** ```bash pip install asterisk-ami ``` 2. **核心代码实现** ```python from asterisk.ami import AMIClient, SimpleAction def originate_call(server_ip, port, username, secret, caller_id, target_exten, context): # 创建AMI客户端连接 client = AMIClient( address=server_ip, port=port, timeout=5 ) try: # 登录认证 login_result = client.login( username=username, secret=secret ) if not login_result.is_success(): raise Exception(f"登录失败: {login_result.response}") # 构建外呼动作(关键参数) action = SimpleAction( 'Originate', Channel=f'SIP/{target_exten}', # SIP通道配置 Exten=target_exten, # 目标号码 Context=context, # 拨号规则上下文 Priority=1, CallerID=caller_id, # 主叫显示号码 Timeout=30000 # 超时设置(毫秒) ) # 发送动作并获取响应 future = client.send_action(action) response = future.response return { 'success': response.is_success(), 'message': response.text } except Exception as e: return {'error': str(e)} finally: client.disconnect() # 使用示例 if __name__ == "__main__": result = originate_call( server_ip='10.200.22.79', port=5038, username='lucal', secret='test', caller_id='2100', target_exten='2101', context='MAIN_OUTGOING' ) print(f"执行结果: {result}") ``` ### 关键配置说明 1. **Asterisk服务端配置** 在`/etc/asterisk/manager.conf`需确保配置: ``` [admin] secret = test deny=0.0.0.0/0.0.0.0 permit=10.200.22.79/255.255.255.0 read = system,call,log,verbose,command,agent,user,originate write = system,call,log,verbose,command,agent,user,originate ``` 2. **拨号规则上下文** 在`/etc/asterisk/extensions.conf`需配置`MAIN_OUTGOING`上下文: ``` [MAIN_OUTGOING] exten => _X.,1,Dial(SIP/${EXTEN},30) exten => _X.,n,Hangup() ``` ### 常见问题排查 - **连接失败**:检查防火墙是否开放5038端口,确认AMI服务已启用`asterisk -rx "manager show status"` - **认证错误**:检查manager.conf中的secret和IP白名单设置 - **呼叫无响应**:使用CLI调试`asterisk -vvvvvr`查看实时日志 - **通道建立失败**:确认SIP终端已正确注册到Asterisk[^1]
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值