freeswitch dialplan 笔记

????我建了一个 Freeswitch 内核研究 交流群， 45211986， 欢迎加入, 另外，提供基于SIP的通信服务器及客户端解决方案。

Freeswitch包含xml 格式dialplan,asterisk likedialplan以及外部语言接口的dialplan，

Dialplan放在conf/dialplan目录，由三个主要文件组成：

default.xml—The primary FreeSWITCHDialplan configuration

public.xml—Handles calls coming in toFreeSWITCH from another location

features.xml—A special context for handlingspecific dialing features

default/—Files in this directory getincluded in the default context

public/—Filesin this directory get included in the public context

Xml格式dialplan从高到低分group ,Context,extenstion,级别.Group是Context的集合，

每个Context一个或者多个extenstion的组合，是一个逻辑上的概念，extension  实际上也是一个逻辑上的概念，他并不是传统pbx上分机的概念，一个extension 代表一个小的，根据被叫号码指定的一个功能集合，一个extension被其name唯一标示，freeswitch默认配置包含三个Context， 名字分别为default，public和features,default为主dialplan，注册到freeswitch的分机会被路由到此context,大部分都在这里实现，public是从外部(未注册)或者那些未认证的客户端呼叫到freeswitch时采用的Context,features context是一些呼叫特性的实现，每个extension是根据条件执行的一系列application，一般是根据被叫号码指定的一系列规则，这些application 构成了可编程pbx的基础，context, extension,application(action)关系如下：

每个进入freeswitch的呼叫都在freeswitch里预先定义了其 context,DialPlan,及extenstion,这些规则指定了如何路由这个呼叫，系统默认xml dialplan的context为default.

/usr/local/freeswitch/conf/dialplan/default.xml

为freeswitch内部分机（验证）的默认dialplan,Context name 为default，里面包含许多例子，

此文件同时包括/usr/local/freeswitch/conf/dialplan/default/*.xml目录下的所有文件，

所以如果想在default context下添加自己的dialplan,令写一个xml放在 default目录即可。

另外，如果想添加自己的context,可以在/usr/local/freeswitch/conf/dialplan/ 添加一个xml文件，

与default.xml类似,/usr/local/freeswitch/conf/dialplan/public.xml为非注册到freeswitch的终端呼入的dialplan,Context 名为 public，/usr/local/freeswitch/conf/dialplan/public/目录可以添加context为public的extension.

在xml配置文件里包含其他目录下文件的方法为用宏X-PRE-PROCESS，如下例子包含default目录下的所有xml文件到此xml文件。

<X-PRE-PROCESS cmd="include"data="default/*.xml"/>

Freeswitch默认提供了大量测试demo,根据被叫号码对应不同功能，列表如下:

这些功能的实现默认都在default.xml中。

Xml dialplan大量使用兼容perl的正则表达式，大多用在${destination_number}的比较上，

常用的如

^789  --------------------------匹配与789开头的

789$ ---------------------------匹配以789结尾的

 \d-------------------------------匹配 0-9任意数字

^\d$----------------------------以任意数字开头的

^\d{3}$ ---------------------匹配以三个数字开头的

^(\d{5})$--------------------匹配以五个数字开头的，并把变量保存到$1中

^(9\d{10}|123)$ 匹配以123开头或者以9，加上10个数字开头

 等等。

另外，freeswitch提供控制台命令regex,可以测试指定字符串是否与某个模式匹配，

格式为regex 字符串|模式，如：

freeswitch@internal> regex1234|^\d{4}

返回true.

亿恩-天使(QQ:530997) 电话 037160135991 服务器租用，托管欢迎咨询。

服务器租用/服务器托管中国五强！虚拟主机域名注册顶级提供商！15年品质保障！--亿恩科技[ENKJ.COM]