一直在看<Asterisk,电话未来之路CHN2>这个电子文档,却越看越糊途。于是在N+X次的Baidu后找到这个文档: [separator] =================================================== http://skytony.spaces.live.com/blog/cns!3ADCAF7D549E5C1E!209.entry
配置文件 “extensions.conf” 包含了Asterisk的拨号方案(dial plan)。它的所有操作的控制和执行流程的主要方案。它控制呼入和呼出是如何被处理和路由。这里是你配置连接行为的地方。 "extensions.conf"的内容以“节”的形式组织。它可以静态设置和定义,作为上下文被执行。设置节有general 和 globals 两种形式,由系统管理员完全定义。一种特殊类型的“contexts”是 macros,由用户自定义,命名前缀是“macro-”,这是可重用的模式,如同编程语言里的“过程”。extensions.conf中每一节都由 []中的节名开始。这使得extensions.conf具有和windows世界里传统的ini文件非常相似的结构。 Asterisk v1.2中的新东西: 默认情况下,有一个新的选项“autofallthrough”被设置成了“yes”. 这个设置改变了以前的规则使得遇忙,阻塞,挂起的呼叫被立即终止。如果你正在为IVR写一个extension.你必须使用“WaitExten”应用程序。 [general] extentions.conf文件的顶部,配置几个设置。 [globals] 接着,在[globals]节中,你可以定义全局变量/常量,以及他们的初始值。 Contexts 和 Extensions 在[general]和[globals]之后,extentions.conf文件的剩余部分就是dialplan的定义了。 dialplan是由contexts的集合组成的。每个context是由extensions的集合组成。 Extension 模式 当你在context中定义extension时,你不仅使用文字数字,字母,还要匹配extension模式。 Context包括的内容 一个extension context可以嵌套另一个,参考一下下面的范例: Context "default": Extension Description 101 Mark Spencer 102 Wil Meadows 0 Operator Context "local": Extension Description _9NXXXXXX Local calls include => "default" Context "longdistance": Extension Description _91NXXNXXXXXX Long distance calls include => "local" 这里我们定义三种 extension 第一种content: default 允许拨打三个电话extension: Mark, Wil, and the Operator. 第二种content: local 一个扩展模式:允许拨打7位数字号码(本地呼叫),同时也包括 “default” context,这样也允许用户拨打 Mark,Wil,或者是操作员。 第三种content: longdistance 一种允许拨打长途呼叫的扩展模式。它同时也包括上述的两种模式 (default 和 local) 使用扩展context,你可以谨慎的控制哪些人使用计费服务(内线,市话,长途) 如果一个拨叫号码匹配多个模式,你可以参阅一下“扩展模式的排序” 当Asterisk从一个通道上收到一个呼入连接,Asterisk从context定义中查询通道命令。context根据用户拨打的 extension定义了不同的命令集。例如,如果用户拨打的是“123”,context可以提供提供一套命令集来指导如何去做。如果用户拨“9”, context可以提供另一套命令集来指导做什么,同时context可以提供一套命令集来控制用户拨打的任何以“555”开头的号码。 某些类型的友好连接,比如来自外线的呼入,用户没有拨打extension,在这种情况下,... 比方说,举个例子,你有一个信道“Zap/1”,它连接到你办公室中的一个电话手持设备。假如在Zap信道的的配置文件 (zapata.conf)中,你为Zap信道1定义了context=john.这样当你使用那个手持设备拨打一个号码时,Asterisk在 extension.conf中寻找名为“john”的context,找出它所应该做的(工作)。 在extensions.conf中定义一个名为john的context,应该以下面的样子开始: [john] 每一个context,你需要定义一个或者多个extensions,Asterisk根据不同的号码拨叫用来比较。 每个extension,通过命令集列表告诉了Asterisk应该做什么。 Extensions extension 有两种类型: literal 和 pattern literal extension 可以是一个号码,就像123。它也可以包括出现在传统电话中的标准的符号*和#,因此,12#89*是一个有效的extension.某些电话拨号盘有一些特殊的标着 A,B,C 或者 D 的 DTMF键。extension也可以使用这些字母来定义。实际上,extension的名字可以包含任何字母和数字以及某些标点符号。 extension名字是大小写敏感的?是的。有时是大小写敏感的,有时不是。当用户使用他们的VoIP电话拨打名为"OFFICE"的 extension 时,Asterisk不会执行名为“Office”的extension中定义的命令。另一方面,extension的名字不是大小写敏感的,因此你不能在一个content中 定义仅仅是大小写不同的extension.因此你不能为“OFFICE”extension定义一套程序集,同时为"office"extension也定义一套程序集。 预定义的Extension名称。 Asterisk为特定的目标指定了一些extension名称。
详细信息: Asterisk standard extensions 不同于传统的PBX,extension是和电话,接口,菜单等联系在一起的。在Asterisk中,一个extension是定义成命令执行列表的。就像Dial和GotoIf命令,具有基于不同的条件转到某个地方的能力。
当一个extension被拨叫,标为优先级1的命令被执行,紧接着是2,等等。 这将一直持续到:
extension.conf 文件中的句法,一个extension执行的每一步是下面这个格式的:
exten = extension,priority,Command(parameters)
这里等号也可以用一个箭头来修饰,就是“=〉”,一种在很多例子中经常可以被看到的格式。 好了,假如一个“context”,名为“john”。在每一个context中,你可以定义一个或多个 extension.每一个extension中,你定义一组命令集。你如何定义这些extension和命令?你需要一个文本编辑器来编辑 extensions.conf文件。当然,也可以使用某些不错的工具:GUI tool.
extension中的执行步骤和命令行组件是下面的样子:
注意:特殊情况下,字符串也会被用于指定优先级(参见 Asterisk standard extensions)。
范例 exten=>123,1,Answer exten=>123,2,Playback(tt-weasels) exten=>123,3,Voicemail(44) exten=>123,4,Hangup 这是单个名为“123”的extension的定义。但一个呼叫被安排到 extension 123,Asterisk将自己回答这个呼叫,播放一个名为“tt-weasels”的声音文件,提示用户是否留下语音邮件,然后挂断电话。 应该注意的是,Asterisk没有关注这几行代码在extensions.conf文件中的顺序。你可以以不同的顺序混合这几行代码,就像下面的例子,它与之前的例子没有什么不同,因为Asterisk使用priority来标示每一行的执行顺序。
exten=>123,4,Hangup exten=>123,1,Answer exten=>123,3,Voicemail(44) exten=>123,2,Playback(tt-weasels)
exten=>123/100,1,Answer() exten=>123/100,2,Playback(tt-weasels) exten=>123/100,3,Voicemail(123) exten=>123/100,4,Hangup()
只有当呼入人的ID号为100时,这个extension才被匹配,并且执行接下来的选项。这个也可以通过模式匹配来完成,如下所示: exten=>1234/_256NXXXXXX,1,Answer() and so on ...
只有以256开头的Caller ID才会匹配“1234”这个模式。这在保持本地呼叫时是很有用的。
你甚至可以做这样的事情: exten=>s,1,Answer exten=>s/9184238080,2,Set(CALLERID(name)=EVIL BASTARD) exten=>s,2,Set(CALLERID(name)=Good Person) exten=>s,3,Dial(SIP/goodperson)
定义context的语法关键字有: exten,include,ignorepat以及switch 详见:How Does Asterisk Handle "Match As You Go" Dialing?
这种extension的排序办法存在的一个弊端是-如果你需要插入或删除一个priority时,你必须手动重新全部编号。我正在搞这么一个工具用来处理这件事情,感兴趣的话,可以尝试一下:give it a try
Asterisk1.2以后的版本有一个新的方法处理这件事情。第一个优先级给它编号,接下来的优先级给它命名成“n”. 深入的了解:Asterisk Priorities
变量和表达式 支持变量的结构 ${VARIABLENAME} 使用表达式的结构${EXPRESSION} ,这里表达式可以是常用表达式,比较表达式,加法表达式等等。 标准变量见: Asterisk variables 。表达式的描述见: Asterisk readme.variables
extensions.conf 文件中的全局变量和信道变量的更多信息,见Using Variables in Asterisk Dialplans
载入 在设置发生了改变之后,如果想重新加载拨号方案,无需加载所有的Asterisk配置文件。可以使用extension加载命令:Asterisk CLI
一个大文件还是几个小文件? 当在extension.conf文件中使用 #include<filename> 声明时,包含了其它的文件。用这个办法你可以启动这样一个系统:extensions.conf是主文件,users.conf包含你的本地用户,services.conf包含各种服务-例如会议系统。使用这个方法,拨号方案可能更容易维护。#include<filename>声明不同于include<context>声明。#include声明在所有的配置文件中都可以使用。
转到其它的Asterisk
语法: [iaxprovider] switch=>IAX2/user:[key]@server/context
指定转到其它的服务器。user 和 key 需要在被呼入的服务器的iax.conf文件中定义。
context是被转入的服务器的extensions.conf文件中的context.
从外部控制 extensions.conf
Asterisk extensions from mysql 所有的 .conf 文件都可以使用 #include 声明包含另一个.conf 文件。 使用范例: #include "my-extra-config-file" [globals] ALL= Zap/1&SIP/1000&SIP/1001
[default] exten=>s,1,Answer exten=>s,2,Playback(welcome-message) exten=>s,3,Goto(context-in-include-file,s,1) ;go to include 文件中定义的 context : :
范例: 使用宏创建extension [globals] PHONE1=Zap/1 PHONE2=SIP/6002
[macro-oneline] exten=>s,1,Dial(${ARG1},20,t) exten=>s,2,Voicemail(u${MACRO_EXTEN}) exten=>s,3,Hangup exten=>s,102,Voicemail(b${MACRO_EXTEN}) exten=>s,103,Hangup
[local] exten=>6601,1,Macro(oneline,${PHONE1}) exten=>6602,1,Macro(oneline,${PHONE2}) 本文来自中国asterisk论坛 |
联系客服