常见问题解决办法

来自VoIP88 Wiki
2012年9月17日 (一) 21:11James.zhu (讨论 | 贡献)的版本

(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳转到: 导航, 搜索

目录

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/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 ,找到 <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 后,即可听到你自己设置的保持音乐。

个人工具
    ͨƼ
产品链接