freeswitch的mod_dailplan_xml模块分析报告.docVIP

mod_dialplan_xml模块分析 一、mod_dialplan_xml介绍 1、描述 ????dialplan包含四个模块，mod_dialplan_directory|mod_dialplan_asterisk|mod_dialplan_xml|mod_dialplan_yaml。freeswitch默认是加载mod_dialplan_xml，即配置文件是采用XML文件格式。XML文件格式非常灵活，而且可以用第三方软件编辑XML文件，而且也可以手工编辑因为XML非常简单。这也是freeswitch采用mod_dialplan_xml为默认模块的原因。在配置文件中，采用了正则表达式匹配字段。本文的重点是解析配置文件的格式和API/APP接口。 2、XML文件格式解析 ????XML dialplan 本质上是被用于呼叫路由，当一个session需要路由时，会解析dialplan，将要执行的应用程序按顺序保存在switch_caller_extension结构链表里，然后再顺序的执行应用程序。配置文件被放在conf/dialplan/目录下，里面有default|public目录，default下可以存放多个以数字开头的xml文件，如：01_.xml。这些文件按数字顺序被加载。如果你想扩展拨号计划，而且想第一个被加载，可以将文件命名为00_xxx.xml。 ????文件包含5个元素，context|extension|condition|action|anti-action。格式如下： ????context name=xxx????????!包含多个extension????????extension name=xxx1????????????!多个condition????????????condition name=xxxx expression=xxxx????????????????!多个action????????????????action application=xxxx data=xxxx/????????????????anti-action application=xxxx data=xxxx/????????????/condition????????/extension????????extension field =xxxx????????/extension????/context （1）condition filed 包含以下关键字： rdnis 重定向号码 destination_number 被呼叫号码 dialplan? 拨号计划模块的名称 例如：XML就是代表mod_dialplan_xml caller_id_name? 访问者名称 caller_id_number 访问者电话号码 ani 自动号码识别 aniii 呼叫设备类型 uuid 当前呼叫唯一标识 source 接收呼叫的模块名称如：sofia chan_name 当前通道的名称 network_addr VOIP 的IP地址 year 公历年 yday 一年包含的天数 mon 月份（1-12） mday 一个月包含的天数 week 星期 mweek 一个月包含星期数（1-6） wday 一个星期包含的天数 hour 小时（0-23） minute 分钟 minute-of-day? 一天包含的分钟（1-1440） ????filed 还可以设置成api${api(args)}函数或变量${variable}。????cond api:????condition field=${cond(${my_var} 12?? YES?: NO)} expression=^YES$????variables:????condition field=destination_number expression=^${some_destination}$ （2）action application ????可以是API/APP，其中以inline方式执行的只有下面这些接口。 \o Acl ????check_acl|eval|event|export|log|presence|set|set_global|set_profile_var|set_user|sleep|????unset|verbose_events|cidlookup|curl|easyroute|easyroute|enum|lcr|nibblebill|odbc_query????例如：action inline=true application=set data=some_var=s