Freeswitch常見問題解決辦法

FreeSwitch下配置DID的方法

首先介绍下什么是DID? 翻译为中文为“直接向内拨号”，该服务是由电话公司提供的，它使用户能够直接拨打PBX或VOIP系统中的分机号码，而无需求助于总机或自动话务系统。

现在要实现这样一个功能 - 通过手机或座机拨打一个号码（例如：01088888888），可以直接联系到VOIP系统(FreeSwitch系统)的1008这个用户。如下图所示：

手机/座机 -------------------> 01088888888 ---------------> VOIP系统 ----------------> 1008

分两步实现：

（1） 配置网关

在 \conf\sip_profiles\external 中添加一个XML文件，名为：gw-DID.xml。内容如下：

              <include>
                      <gateway name="gw-DID">
                            <param name="realm" value="27.54.226.74"/>  // sip provider 提供的服务器IP
                            <param name="username" value="88888888"/>// sip provider 提供的DID账号
                            <param name="password" value="12345678"/> // sip provider 提供的DID账号密码
                            <param name="proxy" value="27.54.226.74"/>  // sip provider 提供的服务器IP
                            <param name="register" value="true"/>
                            <param name="expire-seconds" value="600"/>
                            <param name="ping" value="30"/>
                            <param name="sip-trace" value="true"/>
                      </gateway>
                </include>

（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/[email protected],sofia/sip/[email protected]"/>
                           </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/[email protected]|sofia/sip/[email protected]"/>
                           </condition>
                       </extension>

在 FS_CLI.exe 中运行 reloadxml 即可。

 

在FreeSwitch中修改主叫显示名称

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

需求：

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

配置：

进入 \conf\directory\default\*.xml

(1) 编辑 1000.xml ,找到 <variable name="effective_caller_id_name" value="1000"/>，修改为 <variable name="effective_caller_id_name" value="zhangsan"/>；

(2) 编辑 1000.xml ,找到 <variable name="effective_caller_id_name" value="1001"/>，修改为 <variable name="effective_caller_id_name" value="lisi"/>；

通过 FS_CLI.exe 运行 reloadxml 即可。

 

FreeSwitch中修改注册用户的密码

在FreeSwitch系统中，所有用户的密码默认为 1234，该设置在 \conf\vars.xml 中，如下所示：<X-PRE-PROCESS cmd="set" data="default_password=1234"/>

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

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

<param name="password" value="$${default_password}"/>，即可找到他们之间的联系。若需要修改某用户的密码，直接修改 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 中，找到 <groups> 标签，然后添加如下内容即可，

                  <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 <conf-id> 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 中添加如下内容，
                 <directory name="moh_test" path="$${sounds_dir}/music/MOH_TEST">
                    <param name="rate" value="8000"/>
                    <param name="shuffle" value="true"/>
                    <param name="channels" value="1"/>
                    <param name="interval" value="20"/>
                    <param name="timer-name" value="soft"/>
                  </directory>
(3)  在  \conf\vars.xml 中添加如下内容，
                <X-PRE-PROCESS cmd="set" data="moh_test=local_stream://MOH_TEST"/>
(4) 在 \conf\dialplan\default 中添加一个名为 moh_test_call.xml 的文件，内容如下： 
               <include>
                  <extension name="moh_test_call">
                    <condition field="destination_number" expression="^96646$"/>
                       <action application"playback" data="${moh_test}"/>
                    </condition>
                  </extension>
                 </include>

（5）改变了默认的音乐文件后，需要重新加载  mod_local_stream 模块，在 FS_CLI.exe 中运行 reload mod_local_stream 即可生效。 
（6）在 FS_CLI.EXE 中运行 reloadxml 或 按F6，即可生效。

通过某一IP 话机拨打 96646 后，即可听到你自己设置的保持音乐。