如果你在某个运营商拥有SIP账号,你就可以配置上拨打外部电话了。该SIP账号(或提供该账号的设备)在 FreeSWITCH 中称为SIP网关(Gateway)。添加一个网关只需要在 conf/sip_profiles/external/ 创建一个XML文件,名字可以随便起,如gw1.xml。
<gateway name="gw1">
<param name="realm" value="SIP服务器地址,可以是IP或IP:端口号"/>
<param name="username" value="SIP用户名"/>
<param name="password" value="密码"/>
<param name="register" value="true" />
如果你的SIP网关还需要其它参数,可以参阅同目录下的 example.xml,但一般来说上述参数就够了。你可以重启 FreeSWITCH,或者执行以下命令使用之生效。
FS> sofia profile external rescan reloadxml
然后显示一下状态:
FS> sofia status
如果显示 gateway gw1 的状态是 REGED ,则表明正确的注册到了网关上。你可以先用命令试一下网关是否工作正常:
FS> originate sofia/gateway/myDefaultGateway/015005600327 &echo()
以上命令会通过网关 gw1 呼叫号码 xxxxxx(可能是你的手机号),被叫号码接听电话后,FreeSWITCH 会执行 echo() 程序,你应该能听到自己的回音。
从某一分机上呼出
如果网关测试正常,你就可以配置从你的SIP软电话或portaudio呼出了。由于我们是把 FreeSWITCH 当作 PBX 用,我们需要选一个出局字冠。常见的 PBX 一般是内部拨小号,打外部电话就需要加拨 0 或先拨 9 。当然,这是你自己的交换机,你可以用任何你喜欢的数字(甚至是字母)。 继续修改拨号计划,创建新XML文件: conf/dialplan/default/call_out.xml :
<extension name="call out">
<condition field="destination_number" expression="^0(\d+)$">
<action application="bridge" data="sofia/gateway/gw1/$1"/>
其中,(\d+)为正则表达式,匹配 0 后面的所有数字并存到变量 $1 中。然后通过 bridge 程序通过网关 gw1 打出该号码。当然,建立该XML后需要在Fs-Con中执行 reloadxml 使用之生效。
Authentication AND Authorization
Authentication is the process of identifying a user.
Authorization is the process of determining the level of access of a user.
Freeswitch 添加用户步骤:
1), \conf\directory\default 添加一个xml文件,拷贝其他作为参考。
2),修改\conf\dialplan\default.xml 找到 Local_Extension,修改正则表达式
<condition field="destination_number" expression="^(10[01][0-9]|1100)$">
使得新添加的用户立即生效,
Reloadxml
Freeswitch查看目前有哪些分机已经注册:
sofia status profile internal reg
Freeswitch 拨打分机,当被叫分机不在线时,按键#号,可以跳过语音提示,直接留言。
用户如果需要听语音留言,可以拨号 4000, 按照语音提示输入 分机号和 密码,通过认证后即可收听语音留言。
配置Freeswitch的group,当用户拨打组的分机号时, 组内所有的分机都会ringing,
其中一个用户接听后,其他的用户都会stop ringing。同一个用户可以属于多个group
示例:\conf\dialplan\default.xml 配置信息;
<extension name="group_dial_billing">
<condition field="destination_number" expression="^2002$">
<action application="bridge" data="group/billing@${domain_name}"/>
Group的配置信息:\conf\directory\default.xml
<group name="billing">
<user id="1005" type="pointer"/>
<user id="1006" type="pointer"/>
<user id="1007" type="pointer"/>
<user id="1008" type="pointer"/>
<user id="1009" type="pointer"/>
重新加载外部SIP账户信息:
Sofia profile External restart ReloadXml (该操作会中断所有正在进行的通话)
查看外部SIP账户注册状态:
Sofia Status
仅重新加载指定的外部SIP账户信息,而不是全部:
Sofia profile rescan ReloadXML
dialplan 中可以使用的条件变量:condition
condition就是决定当然呼叫是否要在这个extension中处理的一个模式匹配标签。
语法:
<condition field="[{field_name}|variablename∣{variable_name}|variablename∣{api_func(api_args ${var_name})}]" expression="{expression}" break="[on-true|on-false|always|never]">
<action application="app name" data="app arg"/>
<anti-action application="app name" data="app arg"/>
condition>fileld和expression是必须的,break是可选的。
有一些内部变量可以用:
•context Why can we use the context as a field? Give us examples of usages please.
•rdnis Redirected Number, the directory number to which the call was last presented.
•destination_number Called Number, the number this call is trying to reach (within a given context)
•dialplan Name of the dialplan module that are used, the name is provided by each dialplan module. Example: XML
•caller_id_name Name of the caller (provided by the User Agent that has called us).
•caller_id_number Directory Number of the party who called (caller) -- can be masked (hidden)
•ani Automatic Number Identification, the number of the calling party (caller) -- cannot be masked
•aniii The type of device placing the call ANI2
•uuid Unique identifier&nb, sp;of the current call? (looks like a GUID)
•source Name of the FreeSWITCH module that received the call (e.g. PortAudio)
•chan_name Name of the current channel (Example: PortAudio/1234). Give us examples when this one can be used.
•network_addr IP address of the signaling source for a VoIP call.
•year Calendar year, 0-9999
•yday Day of year, 1-366
•mon Month, 1-12 (Jan = 1, etc.)
•mday Day of month, 1-31
•week Week of year, 1-53
•mweek Week of month, 1-6
•wday Day of week, 1-7 (Sun = 1, Mon = 2, etc.)
•hour Hour, 0-23
•minute Minute (of the hour), 0-59
•minute-of-day Minute of the day, (1-1440) (midnight = 1, 1am = 60, noon = 720, etc.)
除了上面的变量外,还可以使用自定义的变量variable,以及一些api函数{variable},以及一些api函数variable,以及一些api函数{api(args)}
这些变量可以在field及expression里。
condition是不能嵌套的,但可以将多个condition堆在一起,并设置break为on-false(默认值),这样的效果与嵌套一样。
示例1,利用cond API函数:
<condition field="{cond({my_var} > 12 ? YES : NO)}" expression="^YES$">
<action application="log" data="INFO ${my_var} is indeed greater than 12"/>
<anti-action application="log" data="INFO ${my_var} is not greater than 12"/>
condition>示例2, 嵌套效果:
<extension name="To PSTN">
<condition field="fdnis" expression="9541231234"/>
<condition field="destination_number" expression="(.*)">