配置文件目录结构

2020-11-26 09:12:25.385814 [WARNING] sofia_reg.c:2874 Can't find user [1234@192.168.2.200] from 192.168.2.14
You must define a domain called '192.168.2.200' in your directory and add a user with the id="1234" attribute
and you must configure your device to use the proper domain in it's authentication credentials.

freeswitch完整xml文档
configuration 配置
dialplan 拨号计划
chatplan 聊天计划
directory 用户目录
phrase 分词

vars.xml

vars.xml主要通过X-PRE-PROCESS指令定义了一些全局变量， 如

#将domain设置为local_ip_v4  ,$$为全局变量 ，$为临时变量
<X-PRE-PROCESS cmd="set" data="domain=$${local_ip_v4}"/>
<X-PRE-PROCESS cmd="set" data="domain_name=$${domain}"/>
<X-PRE-PROCESS cmd="set" data="hold_music=local_stream://moh"/>
<X-PRE-PROCESS cmd="set" data="use_profile=internal"/>

系统自动变量
可通过global_getvar命令API查看变量的值

 global_getvar sound_prefix
 global_getvar local_ip_v4

实际上params和variables可以出现在user节点 中，也可以出现在group或domain中。当它们有重复时，优先级顺序由 高到低依次为user、group、domain。

diaplan完整结构

<?xml version="1.0"?>
#文件
<document type="freeswitch/xml">
    #段
    <section name="dialplan" description="Regex/XML Dialplan">
         #上下文
         <context name="default">
             #扩展--路由表中的表项
             <extension name="Test Extension">
             </extension>
         </context>
    </section>
</document>
condition--测试条件  action--动作

第196页

2020-11-26 12:37:34.900610 [INFO] mod_dialplan_xml.c:637 Processing 1000 <1000>->1234 in context default
Dialplan: sofia/internal/1000@192.168.2.200 parsing [default->unloop] continue=false
Dialplan: sofia/internal/1000@192.168.2.200 Regex (PASS) [unloop] ${unroll_loops}(true) =~ /^true$/ break=on-false
Dialplan: sofia/internal/1000@192.168.2.200 Regex (FAIL) [unloop] ${sip_looped_call}() =~ /^true$/ break=on-false
Dialplan: sofia/internal/1000@192.168.2.200 parsing [default->Echo Test] continue=false
Dialplan: sofia/internal/1000@192.168.2.200 Regex (PASS) [Echo Test] destination_number(1234) =~ // break=on-false
Dialplan: sofia/internal/1000@192.168.2.200 Action answer() 
Dialplan: sofia/internal/1000@192.168.2.200 Action echo()

遇到Dialplan的问题，按F8键打开详 细的Debug级别的日志，尝试打一个电话，并从Log中绿色的行开始看 起[7]
正则表达式

测试条件

break有以下几个值

on-false 匹配失败停止，默认匹配 但 继 续 处 理 其 他 的 extension if if
on-true 成功停止，不成功继续 -if els if
always 不管是否匹配都停止
never 不管是否匹配都继续

反动作”（Anti-Action） if else

但有些情况下，Dialplan中会有多个extension满足匹配规则，而我 们 希 望 所 有 对 应 的 Action 都 能 得 到 执 行 ， 这 时 我 们 就 要 使 用 continue=”true”参数了。

在Action上增加了一个inline属性

满足这样条件的App有： check_acl 、 eval 、 event 、 export 、 enum 、 log 、 presence 、 set 、 set_global、lcr、set_profile_var、set_user、sleep、unset、nibblebill、 verbose_events、cidlookup、curl、easyroute、odbc_query。

关于set和export的区别我们在第5章已经讲过了。这里再重复一 次：set是将变量设置到当前的Channel上，即a-leg。而export则除具备 set的功能外，也将变量设置到b-leg上。当然，这时b-leg还不存在。所 以在这里它对该Channel的影响与set其实是一样的。因此，使用set完全 是多余的。但是除此之外，export还设置了一个特殊的变量，叫 export_vars，它的值是dialed_extension。所以，实际上面的第二行就等 价于下面的两行

6.4常用Dialplan App

1.set 设置一个通道变量

<action application="set" data="my_var=123456"/>

2.echo 回声

<action application="echo"/>

3.info 在日志中打印全部通道变量

<action application="info"/>

4.answer

<action application="echo"/>

5.bridge 负责桥接令一条腿

<action application="bridge" data="user/1000"/>

6.playback 给Channel放音

<action application="playback" data="/tmp/test.wav"/>

7.sleep

<action application="sleep" data="1000"/>

8.ring_ready 回180消息

<action application="ring_ready" data="1000"/>

9.pre_answer回183消息

<action application="ring_ready" data="1000"/>
<action application="playback" data="/tmp/music.wav"/>

10.read实现播放声音并且顶戴接收DTMF按键
min：最少收号位数。
·max：最大收号位数。
·sound file：要播放的声音文件。
·variable name：收到用户按键后存到哪个变量里。
·timeout：等待每一位的输入超时毫秒数。
·terminators：收号小于min位时，按该键可以提前结束，通常 是“#”。
11.play_and_get_digits yuread类似比read更高级

SDP部分

13.3.2DID

号码1000就是一个DID。