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,添加如下内容：

                                                                                                                           通过 FS_CLI 输入 reloadxml 即可。 

通过FreeSwitch同时呼叫多个用户

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

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

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

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

                                                                                                                                                在 FS_CLI.exe 中运行 reloadxml 即可。  

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

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

在 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 ,将如下两条设置去掉注释即可，

       即：                             

在 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 中，找到 标签，然后添加如下内容即可，

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

FreeSwitch中添加新用户

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

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

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

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

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

                                                          为 -》                                                

（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 的文件，内容如下：                                                                                                          

(2) 新建一个拨码计划

            在 \conf\dialplan\default 中新建一个名为 call_gw_test.xml 的文件 ，内容如下：                                                                                                                                                                   

(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 中，如下所示：

      [录像]                                                                                                    [播放录像]                                                                                                

FreeSwitch的录音功能

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

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

实现：

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

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

找到下面的语句：

在其下，添加：

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

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

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

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

具体用法如下：

(1）播放本地文件

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

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 中的内容，如下所示：

                                                                                                             ...... 

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 ，内容如下：

                                                           // 静音                          // 解除静音                         // 增加门限                       //                         // 降低门限                         // 提高讲话音量                       // 讲话音量设置为0                         // 降低讲话音量                      // 提高收听音量                     // 收听音量设置为0                        // 降低收听音量                                // 退出会议                              

FreeSwitch中的会议功能（3）

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

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

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

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

    // 未设置主持人          // 设置了主持人           如何设置会议密码？方法如下：          // 设置入会密码为 1234           如何既设置主持人，又设置会议密码？方法如下：         

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 的文件，内容如下：