SIP电话（一)之程控交换机-FreeSWITCH的使用总结

最近由于项目需要一直在研究Sip电话，Sip电话是基于sip协议的实现voip即网络电话的的功能。那么问题来了？我们打电话都是使用某动，某通，某信的电话卡，这种电话卡是在全国范围内收费的gms卡，如果我们要做一个在网络中可以使用的电话，那该如何实现呢？

假如我要在一个局域网中实现打电话的功能，我需要客户端或者手机终端，需要手机号码，需要一个程控交换机，程控交换机中设置手机号码，及手机号的密码，即用户名，密码。设置好手机号码之后，在客户端或者手机终端中使用已经配置好的手机号码，密码，及程控交换机所在的服务器地址。

程控交换机有很多开源的，刚开始我用的是elastix,项目官网，这个项目是基于cneter os的一个开源项目，使用及命令和使用linux类似。安装完之后，可以通过浏览器访问其所在的地址，然后在打开的页面中进行配置，刚开始使用比较繁琐，资料较少，不建议使用。之后我又找啊找，发现了另外一个非常简单好用的FreeSWITCH，也是一个开源项目.FreeSWITCH项目地址，点击下载安装即可，地址当中是windows平台下的，如果你用的是其他平台的那可以在官网下载即可。安装之后点击运行，即可。（我的安装完之后，点击运行，窗口出现了闪退，刚开始也很郁闷，不过在当天晚上，解决了，你想知道为什么?哈哈哈。。。右键，选择使用管理员权限运行即可。有没有蛋蛋的忧伤席面而来。）

然后我们来说明使用情况

1.首先是账号，默认的有1000-1019这20个账号，密码默认是1234，配置文件在这个目录下：

C:\Program Files\FreeSWITCH\conf\directory\default

其他一些配置比较多就先转载吧。

以下为转载内容

（1） 配置网关

在 \conf\sip_profiles\external 中添加一个XML文件，名为：gw-DID.xml。内容如下： // sip provider 提供的服务器IP // sip provider 提供的DID账号 // sip provider 提供的DID账号密码 // sip provider 提供的服务器IP

（2）配置拨码计划

在 \conf\dialplan 中修改 public.xml,添加如下内容：

<extension name="sipprovider">                          <condition field="destination_number" expression="^88888888$">                              <action application="transfer" data="1008 XML default"/>                        </condition>                 </extension>               通过 FS_CLI 输入 reloadxml 即可。

通过FreeSwitch同时呼叫多个用户

通过FreeSwitch可以对多个终端进行呼叫，依据振铃顺序不同，可以分为：同振 和 顺振 。

同振是指多个终端同时振铃；顺振是指多个终端顺序振铃。

下面实现如下应用， 某用户拨叫 2000 这个接入号码，希望 1000 和 1001 同时振铃，其中任一个接听来话，另一个停止振铃。

（1） 在 \conf\dialplan\default.xml中添加如下内容，

<extension name="group_dial_sim">                            <condition field="destination_number" expression="^2000$">                                <action application="bridge" data="sofia/internal/1000@192.168.0.183,sofia/sip/1001@192.68.0.183"/>                            </condition>                        </extension>              在 FS_CLI.exe 中运行 reloadxml 即可。

下面实现如下应用， 某用户拨叫 2000 这个接入号码，希望 1000 和 1001 顺序振铃，其中任一个接听来话，另一个停止振铃。

2）在 \conf\dialplan\default.xml中添加如下内容，

<extension name="group_dial_seq">                            <condition field="destination_number" expression="^2000$">                                <action application="bridge" data="sofia/internal/1000@192.168.0.183|sofia/sip/1001@192.68.0.183"/>                            </condition>                        </extension>

在 FS_CLI.exe 中运行 reloadxml 即可。

在FreeSwitch中修改主叫显示名称

如果你想通过你的IP话机呼叫其他用户的时候，在对方话机显示能标识你的名称，在FreeSwitch中该怎么配置？

需求：

1000 和 1001 分别是两部话机，1000时张三的话机，1001是李四的话机。若1000发起呼叫，需要在对方话机上显示“zhangsan”；若1001发起呼叫，需要在对方话机上显示“lisi”.

配置：

进入 \conf\directory\default*.xml

(1) 编辑 1000.xml ,找到 ，修改为 ；

(2) 编辑 1000.xml ,找到 ，修改为 ；

通过 FS_CLI.exe 运行 reloadxml 即可。

FreeSwitch中修改注册用户的密码

在FreeSwitch系统中，所有用户的密码默认为 1234，该设置在 \conf\vars.xml 中，如下所示：

若需要修改默认密码的话，直接修改该处即可。

那用户的密码和默认密码怎么关联起来？请看下面的配置文件，以 用户 1000 为例，打开 \conf\directory\default\1000.xml ,找到如下设置：

，即可找到他们之间的联系。若需要修改某用户的密码，直接修改 value 值即可。

修改配置完成后，通过 FS_CLI.exe 运行 reloadxml 即可。

FreeSwitch中用户不经过认证即可注册成功

一般来说，FreeSwitch中的SIP 用户都需要通过用户名和密码进行认证后才能注册成功，并进行通话。若有特殊需要，也可以设置为无认证即可使用，具体设置如下 ：

打开 \conf\sip_profiles\internal.xml ,将如下两条设置去掉注释即可，

即：             <param name="accept-blind-auth" value="true"/>              <param name="suppress-cng" value="true"/>

在 FS_CLI.exe 中运行 reloadxml 即可。

FreeSwitch中添加新组

FreeSwitch中默认有三个组，分别为：sales ，billing，support。 在 \conf\directory\default.xml 中可以查到。

注意： 在 FreeSwitch中，同一个用户可以在不同的分组中存在。官方解释如下 ：

type=”pointer” is a pointer so you can have the same user in multiple groups. It basically means to keep searching for the user in the directory.

若需要添加一个 名为 ZOO的新组，需要在 \conf\directory\default.xml 中，找到 标签，然后添加如下内容即可，

<group name="ZOO">                       <users>                       <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"/>                       </users>                   </group>

在 FS_CLI.exe 中输入 reloadxml,重新加载新的XML文件即可。

FreeSwitch中添加新用户

FreeSwitch 中默认配置了20个用户，分别是： 1000 到 1019。在 \conf\directory\default 目录下有每个用户的XML配置文件。

若想新添加一个用户，可以通过如下步骤进行：

（1）在/conf/directory/default/增加一个用户配置文件.如下所示：

<include>                      <user id="1020">                           <params>                               <param name="password" value="$${default_password}"/>                               <param name="vm-password" value="1020"/>                           </params>                           <variables>                                <variable name="toll_allow" value="domestic,international,local"/>                                <variable name="accountcode" value="1020"/>                                <variable name="user_context" value="default"/>                                <variable name="effective_caller_id_name" value="Extension 1020"/>                                <variable name="effective_caller_id_number" value="1020"/>                                <variable name="outbound_caller_id_name" value="$${outbound_caller_name}"/>                                <variable name="outbound_caller_id_number" value="$${outbound_caller_id}"/>                                <variable name="callgroup" value="techsupport"/>                           </variables>                   </user>              </include>

（2） 修改拨号计划，以使得其他用户可以呼到他。如下所示：

在  \conf\dialplan\default.xml中，修改 如下 语句 -

<extension name="Local_Extension">                       <condition field="destination_number" expression="^(10[01][0-9])$">                     为 -》                    <extension name="Local_Extension">                        <condition field="destination_number" expression="^(10[012][0-9])$">

（3） 在 FS_CLI.exe 中运行 reloadxml,即可生效。

FreeSwitch中配置网关的方法

在VOIP通信系统中，经常要用到网关。那么网关怎么和FreeSwitch在一起配合使用？

有如下需求：

有一虚拟运营商（即：SIP PROVIDER ），提供拨打外线的功能。从该处购买一 SIP 账号，具体配置信息如下：

用户名：user

密码： pass

服务器IP：100. 100.100.100

想通过和该SIP PROVIDER 对接实现拨打外线功能。即：0+要拨打的号码，就送到该SIP PROVIER （说明：此时的 SIP PROVIDER 相当于一网关）。

解决方法：

1）添加一个网关

在 \conf\sip_profiles\external 中添加一个名为GW_TEST.xml 的文件，内容如下：                   <gateway name="GW_TEST">                      <param name="realm" value="100. 100.100.100"/>                      <param name="username" value="user"/>                      <param name="password" value="pass"/>                   </gateway>

(2) 新建一个拨码计划

在 \conf\dialplan\default 中新建一个名为 call_gw_test.xml 的文件 ，内容如下：                   <include>                      <extension name="call out">                         <condition field="destination_number" expression="^0(\d+)$">                            <action application="bridge" data="sofia/gateway/GW_TEST/$1"/>                         </condition>                      </extension>                  </include>

(3) 通过 FS_CLI.exe 运行 reloadxml ，即可生效。

FreeSwitch中的录像功能和播放录像功能

FreeSwitch 系统中的录像功能 和 播放录像功能，系统都默认提供。

按默认配置，通过IP电话拨打9193，即可录像；通过IP电话拨打9194即可播放录像。

同时，我测试了一种有趣的用法，描述如下：

（1） 1000  呼叫 9193 并且发送视频；          （2） 1001 呼叫 9194 ，可以看到 1000 上传的视频，但非实时；          （3） 1002 呼叫 9194， 可以看到 1000 上传的视频，但非实时。

这样看来，一个点播系统，FreeSwitch 默认就支持！稍加改造，就可以变为一套视频直播系统。

实现上述功能的配置文件在 \conf\dialplan\default.xml 中，如下所示：

[录像]            <extension name="video_record">              <condition field="destination_number" expression="^9193$">                  <action application="answer"/>                  <action application="record_fsv" data="/tmp/testrecord.fsv"/>              </condition>            </extension>            [播放录像]            <extension name="video_playback">               <condition field="destination_number" expression="^9194$">                    <action application="answer"/>                    <action application="play_fsv" data="/tmp/testrecord.fsv"/>                </condition>            </extension>

FreeSwitch的录音功能

一般电话系统都可以将本系统内的语音通话录制下来，FreeSwitch 系统中也可以进行语音录制。

需求： 录制系统中的所有通话。

实现：

(1）建立一个文件夹 freeswitch/recordings/archive/ ，用来存储录音文件；

（2）修改拨码计划，打开 \conf\dialplan\default.xml

找到下面的语句：

<extension name="Local_Extension">

<condition field="destination_number" expression="^(10[01][0-8])$">

在其下，添加：

<action application="set" data="RECORD_TITLE=Recording ${destination_number} ${caller_id_number} ${strftime(%Y-%m-%d %H:%M)}"/>                         <action application="set" data="RECORD_COPYRIGHT=(c) 2011"/>                         <action application="set" data="RECORD_SOFTWARE=FreeSWITCH"/>                       <action application="set" data="RECORD_ARTIST=FreeSWITCH"/>                        <action application="set" data="RECORD_COMMENT=FreeSWITCH"/>                        <action application="set" data="RECORD_DATE=${strftime(%Y-%m-%d %H:%M)}"/>                         <action application="set" data="RECORD_STEREO=true"/>      <action application="record_session" data="$${base_dir}/recordings/archive/${strftime(%Y-%m-%d-%H-%M-%S)}_${destination_number}_${caller_id_number}.wav"/>

(3）在 FS_CLI.EXE 中运行 reloadxml 或 按 F6 即可生效。

查询 FreeSwitch 支持的音频文件格式，可以在 FS_CLI.exe 中运行 show file 命令。

FreeSwitch播放语音文件

上一篇介绍了 FreeSwitch 的录音功能，若想回放这些录音，是否可以实现？或者说，通过 FreeSwitch ，是否可以直接播放语音文件？

FreeSwitch 中有一个 playback 的 application ,可以播放语音文件。

具体用法如下：

(1）播放本地文件

<action application="set" data="playback_terminators=none"/>                         <action application="playback" data="sounds/soundfile.wav"/>

（2）播放远程服务器上的文件

<action application="playback" data="${http_get(http://myserver.yo/media/hello_world.wav)}"/>

FreeSwitch中的会议功能（1）

FreeSwitch 默认支持会议功能，有如下特点：

（1） 不需要创建一个会议室的操作，只需要通过 conference 拨码计划就可以实现;

（2） 会议室不真正存在， 直到有人呼入为止；

（3） 会议功能很强大，能实现灵活控制。

这样讲太学术化，来点直观的，步骤如下：

（1） 运行 FREESWITCH 服务器程序；           （2） 注册 1000、1001、1002三部IP话机；           （3） 通过 1000 呼叫 3000，通话建立后， 1000 将听到一段保持音乐；           （4） 通过 1001 呼叫 3000，通话建立后， 1001将能听到1000的声音，1000也能听到1001的声音；           （5） 通过 1002 呼叫 3000，通话建立后，  1002将能听到 1000 和 1001的声音，1001能听到1000和1002的声音，1000也能听到 1001 和 1002 的声音。

那 3000 这个号码是怎么来的？ 请看 \conf\dialplan\default.xml 中的内容，如下所示：

<extension name="nb_conferences">                 <condition field="destination_number" expression="^(30\d{2})$">                    <action application="answer"/>                    <action application="conference" data="$1-${domain_name}@default"/>                 </condition>              </extension>             ......

FreeSwitch中的会议功能（2）

FreeSwitch 提供了一些控制会议成员行为的方法，罗列如下：

（1）Talk volume: The volume of the audio the caller sends (that is, gain control).

与会成员讲话的音量控制；

（2）Listen volume: The volume of the audio the caller hears.

与会成员收听语音的音量控制；

（3）Energy threshold: The minimum energy level of the audio from the caller to be considered talking. Raising the energy level will cut down on background noise when a participant is in a noisy environment.

语音门限控制 。

具体用法，可以查看：\conf\autoload_configs\console.conf.xml ，内容如下：

<caller-controls>                  <group name="default">                    <control action="mute" digits="0"/>             // 静音                    <control action="deaf mute" digits="*"/>      // 解除静音                    <control action="energy up" digits="9"/>     // 增加门限                    <control action="energy equ" digits="8"/>   //                    <control action="energy dn" digits="7"/>     // 降低门限                    <control action="vol talk up" digits="3"/>     // 提高讲话音量                     <control action="vol talk zero" digits="2"/>  // 讲话音量设置为0                    <control action="vol talk dn" digits="1"/>     // 降低讲话音量                    <control action="vol listen up" digits="6"/>  // 提高收听音量                    <control action="vol listen zero" digits="5"/> // 收听音量设置为0                    <control action="vol listen dn" digits="4"/>    // 降低收听音量                     <control action="hangup" digits="#"/>           // 退出会议                </group>             </caller-controls>

FreeSwitch中的会议功能（3）

FreeSwitch中可以设置主持人以及会议密码。设置了主持人后，可以影响会议的开展；设置了会议密码后，与会成员必须输入正确密码才能入会。

主持人对会议的影响主要体现在以下两个方面：

（1）直到主持人入会后，会议才开始；       （2）主持人退出会议后，会议才结束。

那怎么设置主持人？方法如下：

<action application="conference" data="$1@default"/> // 未设置主持人         <action application="conference" data="$1@default+flags{moderator}"/> // 设置了主持人           如何设置会议密码？方法如下：         <action application="conference" data="$1@default+1234"/> // 设置入会密码为 1234           如何既设置主持人，又设置会议密码？方法如下：        <action application="conference" data="$1@default+1234+flags{moderator}"/>

FreeSwitch中的会议功能（4）

FreeSwitch 是否支持视频会议？答案是 支持的！

FreeSwitch 默认只支持与会成员看到当前“嗓门最大”的那个人的视频。

在实际应用中，当讲话人改变时，视频会切换，但切换的时候，视频会有马赛克现象。此问题期待高手解决！

场景描述如下：

三个用户 1000、1001、1002 都注册到同一台服务器。

（1）1000 呼叫 3000，进入会议，同时发送自己的视频，1000 可以看到自己；

（2）1001 呼叫 3000，进入会议，可以看到 1000 的视频。若1001也发送自己的视频，双方看到的视频是当前讲话声音大的一方的视频；

(3）1002 呼叫 3000，进入会议，可以看到当前讲话一方的视频。若 1002 也发送自己的视频，三方看到的视频是当前讲话声音大的一方的视频。

再扩展下思维，能否让 FreeSwitch 实现融屏功能，实现与会各方都能彼此看到自己！那FreeSwitch就更强大了。以下是几个相关的资源简介：

(1）BigBluebutton 这个视频会议项目中用到了 FreeSwitch, 项目主页： http://www.bigbluebutton.org/ 。但对视频的处理只是转发各路视频，没有实现融屏合成一路视频推送到各方显示。

（2）openvcs 是一个开源的 SIP MCU 实现，项目主页：http://code.google.com/p/openvcs/ 。 在 Windows 下实现了融屏的原型设计，但在效率以及并发处理方面，还有许多需要完善的地方。但提供了一个开发 SIP MCU 的思路，这个是很有价值的。

FreeSwitch中的会议功能（5）

邀请手机用户或座机用户入会： 在 FS_CLI.EXE 中运行 类似 conference dial Sofia/gateway/xyz/1234567890 即可。

FreeSwitch中的音乐保持功能

Music on hold(MOH) ，即：音乐保持，在一般电话系统中都存在。FreeSwitch也支持该功能，并且保持音乐可配置。 FreeSwitch默认的配置中，用户通过某IP话机拨打 9664 ，呼叫建立后，就可以听到保持音乐。 查看当前系统中音乐文件的路径，可以通过 FS _CLI.EXE 运行 show_local_stream 来显示。 如果你想修改默认的保持音乐，可以自己添加一些好听的音乐进来，方法如下： （1）在 \sounds\music 新建一个文件夹 MOH_TEST，并拷贝音乐文件进去（WAV文件）；

(2）在 \conf\autoload_configs\local_stream.conf.xml 中添加如下内容， (3) 在 \conf\vars.xml 中添加如下内容， (4) 在 \conf\dialplan\default 中添加一个名为 moh_test_call.xml 的文件，内容如下：