吴伟贤のBlog

转自：http://www.8000hz.com/archives/20.html

Starting FreeSWITCH

转自：http://www.8000hz.com/archives/14.html

第二章：Building and Installation

在windows环境上FreeSWITCH需要两个主要的要求。以下：
1. Microsoft Visual C++ 2008 (or 2008 Express Edition)
2. A fle decompression utility（解压缩工具）
在windows上编译和构建FreeSWITCH用到Microsoft Visual C++ 2008
(MSVC) 或 Visual C++ 2008 Express Edition (MSVCEE).

转自：http://www.8000hz.com/archives/7.html

Architecture  of  FreeSWITCH

如图

转自：http://www.8000hz.com/archives/113.html

编码协商

介绍:
编码协商是一个比较令人困惑的主题. 如果你不熟悉SDP(会话描述协议),那么就更加多了一层神秘的面纱. 如果你对编码协商不太熟悉(或你对你所读到的和经历的有些困惑), 下面的这个简短的介绍也许对你有些许帮助.

首先, 当我们谈编码协商时是在谈什么?  我们在讨论通话中的每一个leg选择使用哪个编码的过程. FreeSWITCH支持很多种编码.大部分的SIP终端也是支持多种编码的. 每一个leg只能使用一种编码, 所以编码协商的过程中会进行筛选和选择要使用的一个编码.正是这个筛选过程会导致混淆. 这个过程是如何工作的? 如何才能对它进行修改?  本章内容就是帮你来解决这些疑惑.

FreeSWITCH的编码协商

FreeSWITCH支持编码协商的两种模式: 早期(early)和延后(late).

早期协商  就表示, FreeSWITCH和终端间的编码协商越早越好, 甚至早于FreeSWITCH发送媒体前(像振铃)或接通呼叫. 早期协商在一通电话还没有进入拨号方案前就进行.

延后协商  表示直到进入到拨号方案中再进行协商, 这样就有更多的信息可以收集. 这些额外的信息可以用于影响协商过程. 让我们演示早期协商和延后协商的区别.

假设有这个环境:

—-   Alice的电话支持G722和PCMU
—-   Bob的电话支持 PCMU和PCMA
—-   FreeSWITCH 的outbound “codec prefs” 是 G722, G722.1,PCMU,PCMA,G729
(这个是FS在外呼时携带的编码列表)

看看下面的这两个呼叫流程. 瞧瞧你是否能搞懂何时A Leg进行协商:

Early Negotiation(早期协商)

Alice(A) 拨打 Bob(B)

A 呼叫FS, 提供两种编码: G722和PCMU
FS看到这两个编码后, 立即为A leg 选择G722编码
FS呼叫B, 提供G722, G722.1, PCMU,PCMA,G729
B看到这些编码后, 选择了PCMU
FS接通A和B
FS会在G722和PCMU之间进行转码

延后协商, 同时设置了 inherit codec 

Alice(A) 拨打 Bob(B)

A 呼叫FS, 提供两种编码: G722和PCMU
FS看到这两个编码后, 并不会立即选择一个.
FS呼叫B, 提供G722和PCMU两种编码
B看到这两种编码后选择PCMU
FS现在为A leg选择PCMU
FS 接通A和B
A和B使用PCMU进行通讯(没有额外的编解码)

注意, 不同点就是在于何时决定A leg的编码.当使用早期协商时,FreeSWITCH会立即选择一个codec(G722). 它并不会关心外呼的leg(B leg). 所以A leg  就使用G722. 在决定好Aleg使用的编码后, FreeSWITCH 将通话进到拨号方案中, 当然最终会使用bridge到bob的电话. 要桥接呼叫, FreeSWITCH呼叫B leg然后提供一个比较大的编码列表. 这个列表就是FreeSWITCH的”outbound codec prefs”.(这个列表可以自己定义, 后面再说这个.)  Bob的电话看到了所有的编码, 然后选择了第一个匹配的, 在这个案例中是PCMU. 此时两个leg都协商完毕:

A leg使用G722
B leg 使用PCMU

只要Bob的电话返回一个回铃信号, 两个leg就桥接到一起了. FreeSWITCH需要在G722和PCMU之间进行转码. 平常这没啥问题, 你更希望两个电话使用相同的编码, 这样会降低CPU的使用. 这就是为什么 延后协商 要出现.

正如你能看到的, 当FreeSWITCH不知道B leg的编码时设置A leg的编码, 那么就容易让两端不匹配.  编码不匹配并不总是个坏事, 但很多情况下两个leg使用相同的编码是比较好的, 省资源嘛. 使用 延后协商和一个叫”继承编码”的技术, 我们可以强制A leg使用和B leg一样的编码.  (这个实现过程会在其他的细节中讲述, 在这里,我们先只说说这个基本的概念).

在我们的第二个呼叫流程示例中, FreeSWITCH得到了A leg后并不立即协商出个编码.  取而代之的是, FreeSWITCH在A leg执行完拨号方案前并不会进行协商编码.  在这个示例中, 拨号方案最后会bridge到bob的电话. 在bridge的过程中, FreeSWITCH和bob的电话协商出了一个编码—在这个示例中是PCMU. 一旦在B leg上协商出了编码, FreeSWITCH 返回给Alice的电话, 通知它应该使用PCMU编码. 现在, 两个leg中都使用相同的编码, 这正是我们想要的.

这就是 早期协商和延后协商的不同. 只需要记住这一点: 仅仅开启 延后协商 并不会自动强制A leg 继承 B leg 的编码.  开启延后协商仅是允许使用 “继承编码” 作为编码协商的一种方法. 延后协商还允许其他的一些编码协商的策略. 继续阅读下文了解FreeSWITCH中编码协商的更具体介绍.

Early Negotiation parameters
早期协商的参数

disable-transcoding      禁止转码

这个参数你可以会设置到外呼的SIP Profile中.这个参数会强制发送到B leg的编码和与A协商出来的编码一致(送单一编码, A协商成啥就送啥).

开启禁止转码, 添加以下行到你想设置的SIP profile中:

<param name="disable-transcoding" value="true"/>

注意: 常见的一个误解是, 这个参数会禁用FS的转码功能.  这是错误滴.

这个参数仅仅是转换外呼的编码和呼入的编码相同, 所以就不需要转码了.

相同的效果也可以通过设置  absolute_codec_string 变量为呼入的编码来实现.

这个参数(当延后协商关闭时才生效)会获取A leg协商出来的编码, 然后把它作为和B leg协商的唯一编码(忽略任务其他的编码)如果B leg 不能接受这个编码, 通话结束.

absolute_codec_string

这个是一个通道变量, 你可以在拨号方案中进行设置, 要在bridge之前设置.
这个参数可以设置发送到B leg时的编码列表, 不考虑别的.

以下是个例子:

<action application="export" data="nolocal:absolute_codec_string=PCMA,PCMU"/>
<action application="bridge" data="sofia/gateway/mygateway/mynumber"/>

或

<action application="bridge" data="{absolute_codec_string='PCMA,PCMU'}sofia/gateway/mygateway/mynumber"/>

请确保使用单引号来括住逗号(‘PCMA, PCMU’) 防止它把编码列表分割成变量.

注意: 这个参数可以无视disable-transcoding参数. 所以如果你在外呼的SIP Profile中关闭了转码, 你可以在拨号方案中使用absolute_codec_string 设置让外呼的编码和主叫呼入的编码不相同,转码一样会发生.

codec_string

它是一个通道变量, 你可以在拨号方案中使用, 在Bridge前设置.
使用这个变量设置的编码会覆盖你Profile中的outbound-codec-prefs 参数.

示例:

<action application="export" data="nolocal:codec_string=PCMA,PCMU"/>
<action application="bridge" data="sofia/gateway/mygateway/mynumber"/>

或

<action application="bridge" data="{codec_string='PCMA,PCMU'}sofia/gateway/mygateway/mynumber"/>

codec_string 和 absolute_codec_string 的区别
codec_string是覆盖Profile中的outbound-codec-prefs参数的, 所以如果设置 disable-transcoding 为true, 则codec_string就无效果了, 但absolute_codec_string无视disable-transcoding参数.

Early Negotiation + Disable Transcoding:

<param name="disable-transcoding" value="true"/>

如果SOFIA PROFLE中参数disable-transcoding设置为true, 呼叫到B leg的INVITE消息将会只包含A LEG协商出来的编码.

A leg中的变量”codec_string”控制呼叫B Leg时携带哪些编码.

变量”absolute_codec_string”功能也类似, 但它实现了一个编码的隐式列表. 同时它会从编码列表中禁用其他行为中添加到A leg的编码, 相当于它是绝对的, 只要在Bridge前,设置它, 其他的都得失效.

Late Negotiation

延后协商(需要配置参数开启)

<param name="inbound-late-negotiation" value="true"/>

1.  进入拨号方案前不会进行编码匹配
2.  当A leg接通时协商才发生
3.  延后协商会允许你将通话路由到一个脚本, 然后检查SDP和使用通道变量”codec_string”重写可接受的编码

inherit_codec

<action application="set" data="inherit_codec=true"/>

inherit_codec=true (延后协商开启后才适用) 时当B leg 接通时才会进行编码协商, 同时会将B leg 协商出来的编码传到 A leg, 所以A 和 B就会使用相同的编码(如果A leg支持协商出来的编码); 否则, 它将会使用任何A leg可以支持的编码.

ep_codec_string

只有在SIP Profile中开启了延后协商才有效果. 这个变量是一个可读的字符串, 它包含了主叫终端提供的编码. 这个可以很容易的在拨号方案中解析.

<action application="export" data="codec_string=${ep_codec_string}"/>

Proxy Media

如果你的SDP包含携带不同ptime设置的编码, 同时SDP中携带了ptime参数, 那么sofia不会为单个编码发送ptime的属性值.

2010-10-18 11:47:52.234322 [WARNING] sofia_glue.c:213 Codec G723 payload 4 added to sdp wanting ptime 30 but it's already 20 (G729:18:20), disabling ptime.

Examples
以下的拨号方案示例可以允许你在使用proxy_media模式时允许你改变编码的优先顺序同时享受到proxy_media模式带来的低CPU使用. 这个有点像openser/opensips/kamailio 模块textops中的substr().

<context>
  <extension name="sdp_mangler">
    <!-- Set some defaults for this call -->
    <condition field="destination_number" expression="^(\d+)$" break="on-false">
      <action application="set" data="transfer_to=${destination_number} XML fail"/>
    </condition>

    <!-- Here we check for G729 if found we are going make sure we have it first in preference order -->
    <condition field="${switch_r_sdp}" expression="/(.*)(m=audio \d+ RTP\/AVP)(?=[ \d]+18|18[ \d]+)([ \d]*)(.*)/s" break="never">
      <action application="set" data="codec_mangle= 18"/>
      <action application="set" data="transfer_to=${destination_number} XML public_proxy"/>
    </condition>

    <!-- Here we check for PCMU to add it back into the SDP if we want -->
    <condition field="${switch_r_sdp}" expression="/(.*)(m=audio \d+ RTP\/AVP)(?=[ \d]+0|0[ \d]+)([ \d]*)(.*)/s" break="never">
      <action application="set" data="codec_mangle=${codec_mangle} 0"/>
    </condition>

    <!-- Here we rebuild our SDP Moving G729 up front-->
    <condition field="${switch_r_sdp}" expression="/(.*)(m=audio \d+ RTP\/AVP)([ \d]+)(.*)/s" break="never">
      <action application="set" data="switch_r_sdp=$1$2${codec_mangle} 101$4"/>
    </condition>

    <condition>
      <action application="transfer" data="${transfer_to}"/>
    </condition>
  </extension>
</context>

switch_r_sdp:

<action application="set">
<![CDATA[switch_r_sdp=(sdp here)
 ]]>
</action>

Disable G.729b on outbound
外呼时禁用G729B编码

<extension name="disable-annexB" continue="true">
  <condition field="${switch_r_sdp}" expression="/(.*)(m=audio \d+ RTP\/AVP)(.*)( 18 )(.*)/s">
     <action application="export" data="sip_append_audio_sdp=a=fmtp:18 annexb=no"/>
  </condition>
</extension>

Codec Negotiation when proxy media enabled
Proxy Media 开启后的编码协商

Correct正确

<extension name="test_proxy_media">
  <condition field="source" expression="mod_sofia">
    <action application="answer"/>
    <action application="playback" data="ivr/ivr-welcome_to_freeswitch.wav"/>
  </condition>
</extension>

Not correct 不正确

<extension name="test_proxy_media">
  <condition field="source" expression="mod_sofia">
    <action application="playback" data="ivr/ivr-welcome_to_freeswitch.wav"/>
  </condition>
</extension>

原文地址:   http://wiki.freeswitch.org/wiki/Codec_negotiation

另见:

• Codecs
• Proxy     Media
• Trans Coding Issues
• SDP Manipulation
• Codec Related in Channel Variables

转自：http://www.8000hz.com/archives/mod_flite.html

轻量级的TTS–mod_flite

有些时候你需要一个快速, 简单和免费的TTS, 用于快速的测试.  在FreeSWITCH中你可以使用mod_flite来进行简单的TTS测试.
但在专业的, 生产环境中, 它就不适合了, 它满足快速,简单免费的标准.

Getting ready

有一个电话和一个文本编辑器, 就可开始mod_flite的测试了.  记住, 在Windows上默认mod_flite就已经编译了,但没有自动加载.
在Linux/Unix系统上, 你需要执行以下步骤.

How to do it…

如果你在windows上使用,就直接跳到第3步. 如果你在Linux/Unix平台, 那就需要以下步骤来开启mod_flite:

1. 打开源码目录下的 modules.conf , 取消#asr_tts/mod_flite 行的注释.
2. 保存退出. 安装:
make mod_flite-install
3. 如果你希望启动FreeSWITCH的时候就加载mod_flite, 在文件conf/autoload_configs/modules.conf.xml 中取消这一行注释.
<!– <load module=”mod_flite”/> –>
4. 保存退出. 进入到fs_cli中, 执行命令 load mod_flite.

此时mod_flite已经激活并且可以使用了. 现在我们添加一个用于测试的简单拨号方案:

1. 打开文件 conf/diaplan/default/01_Custom.xml 文件, 添加以下行:

<extension name="mod_flite example"> 
  <condition field="destination_number" expression="^(5008)"> 
    <action application="answer"/> 
    <action application="sleep" data="500"/>
    <action application="speak"
        data="flite|kal|Hello world. This is a FreeSWITCH test."/> 
  </condition> 
</extension>

2. 保存退出. 通过fs_cli执行reloadxml命令.

现在已经可以测试TTS了, 拨打号码5008, 听到了什么!

How it works…

FreeSWITCH有一个叫speak的拨号方案应用, 它可以用于访问任何安装的TTS引擎. 它接受管道分割的参数.注意拨号方案中的这一行:

<action application="speak"
        data="flite|kal|Hello world. This is a FreeSWITCH test."/>

第一个参数是TTS引擎, 第二个参数是指定声音.最后一个参数就是要读出的文字了.  sleep应用是可选的, 但在很多情况下接通后等待一下让媒体流连接也是很必要的. (如果总是会漏掉前几个字, 就是需要sleep一下).

|||||请不要把speak和say搞混了. say应用是方便”说” 日期, 时间, 数量, 金额等, 它是使用预先录好的声音.|||||||||

Flite 中有四种不同你声音你可以尝试: awb,kal,rms,slt.

其实我觉得都不好听.

参见
使用mod_tts_commandline的高级TTS

转自：http://www.8000hz.com/archives/112.html

Receiving faxes

收传真

上一篇说到了发传真, 现在咱就说说收传真.

Getting ready 

最简单的方式, 收一个传真只需要你把一个通话路由到一个执行rxfax应用的extension就成了. 结合上一篇, 我们可以使用FreeSWITCH服务器作为传真的发送者和接收者.因为是测试, 我们就使用在发传真时用到的示例文件: /tmp/txfax-sample.tiff.

How to do it…

执行以下步骤去完成一个简单的传真发送和接收:
1.    打开fs_cli
2.    执行命令:

originate loopback/9178 &txfax(/tmp/txfax-sample.tiff)

观察控制台, 最终传真的发送应该会成功完成.

How it works…

我们使用了默认配置文件中的fax_receive extension来接传真:

这个extension是非常简单的:

<extension name="fax_receive">
  <condition field="destination_number" expression="^9178$">
    <action application="answer" />
    <action application="playback" data="silence_stream://2000"/>
    <action application="rxfax" data="/tmp/rxfax.tif"/>
    <action application="hangup"/>
  </condition>
</extension>

接收到的传真保存在 /tmp/rxfax.tif. 文件名是可以随意更改的. 例如, 如果你在freeswitch的主安装目录中有一个子目录专门用来存传真, 你可以改拨号方案为:

<action application="rxfax" data="${base_dir}/faxes/${uuid}.tif"/>

每个接收到的传真都会有一个唯一的文件名, 保存在faxes子目录.

There’s more…

接收传真通常只是大系统或程序的一部分. 以下的内容有一些关于处理入站传真的有用的信息.

Detecting inbound faxes  检测入站传真

比方说你的应用是自动接听来电, 播放声音, 让主叫选择他们要呼叫的被叫号码.(企业IVR吧). 偶尔会来个传真. 不要断开, 你可以检测到传真, 然后把通话转到一个传真处理的extensions上去.添加这个extension到你处理呼入的拨号方案:

<extension name="fax detect" continue="true">
  <condition>
    <action application="set"
            data="execute_on_fax_detect=execute_extension handle_
incoming_fax"/>
  </condition>
</extension>

现在添加一个实际上处理入站传真的extension:

<extension name="fax_receive">
  <condition field="destination_number" 
             expression="^handle_incoming_fax$">
    <action application="playback" data="silence_stream://2000"/>
    <action application="rxfax" 
            data="${base_dir}/faxes/${uuid}.tif"/>
    <action application="hangup"/>
  </condition>
</extension>

现在你的系统就可以自动处理入站传真了.

Processing a received fax  处理接收到的传真

一旦一个传真接收完毕, 很少只是让它呆在某个目录里. 通常你想让一个人看到这份传真.
通常的做法就是把TIFF文件转到PDF, 然后把PDF作为邮件附件发送出去. 此外, 当用户看到主叫的ID信息放到邮件的主题栏时感觉非常爽. 记住, 你必须得在系统上配置一个没问题的邮件传输代理MTA才行. 更改接收传真的extension为这样:

<extension name="fax_receive">
  <condition field="destination_number" 
             expression="^handle_incoming_fax$">
    <action application="set"
            data="api_hangup_hook=system  
                  ${base_dir}/scripts/emailfax.sh 
                  ${fax_remote_station_id}   
                  ${base_dir}/faxes/${uuid}.tif"/>
    <action application="playback" data="silence_stream://2000"/>
    <action application="rxfax" 
            data="${base_dir}/faxes/${uuid}.tif"/>
    <action application="hangup"/>
  </condition>
</extension>

注意, 我们添加了一个 api_hangup_hook到接收传真的extension. 这样的话通话结束的时候emailfax.sh就会执行. 在文本编辑器中创建脚本文件添加下面这些内容:

#!/bin/bash
#
# $1 is the calling fax machine's station ID
# $2 is filename 
mutt -n -f /dev/null -F ~/.muttrc -a $2 -s "Fax from $1" user@domain.
com < /dev/null

一定得用一个真实的可用的邮件地址替换 user@domain.com . 最后, 创建.muttrc文件在home目录,然后添加以下行:

set from = 'sender@domain'
set realname = 'Organization or business name'
set folder = /dev/null

接收到的传真现在就会被发送指定的用户, 同时还会带上发来传真的号码.

很多脚本像Perl, Python和ruby都有可以让你发邮件的库. 可以把emailfax.sh换为你自己的邮件发送脚本.

转自：http://www.8000hz.com/archives/103.html

Send Faxes

发送传真

FreeSWITCH可以将一份电子文档传送到一个普通的传真机.但只能传TIFF格式的文档, 不过呢,很多格式都可以转到TIFF(本小方法中会讨论一些通用且免费使用的转换工具).

准备工作

简单来说, 发送传真需要准备一些东西, 如TIFF文档, 网关和一台目标传真机(测试的话可以下载一个测试文档http://files.freeswitch.org/txfax-sample.tiff).

把你的TIFF文档放到一个指定的路径. 在我们的例子中使用的是/tmp/txfax-sample.tiff. 网关就是可以让你连接到外部世界(PSTN),传真机就是用来接受你传真的啦.如果你没有网关或传真机, 你仍然可以通过使用默认拨号方案中的fax_receive extension很方便的去尝试本文内容.

如何开始

大多数情况下,发送传真你需要外呼到你的传真机(A leg),然后执行txfax拨号方案应用(diaplan application). 使用以下步骤来完成一个简单的传真发送:

1.    打开fs_cli.
2.    执行以下命令:

originate loopback/9178 &txfax(/tmp/txfax-sample.tiff)

观察控制台, 不出意外的话传真会发送成功.

工作原理

originate命令用于创建传真呼叫中的外呼leg. 在这个例子中, 从字面上看,我们在FreeSWITCH服务器中使用loopback通道发起了一通呼叫. 目标分机号码是”9178”. 在实际的应用中,当然,我们会拨打一个外部号码.例如, 我们可以这样做:

originate sofia/gateway/my_gw/18005551212 &txfax(/tmp/txfax-sample.tiff)

在以上两个例子中, 一旦A leg 接听, txfax应用就被调用. 如果一切正常,传真会顺利的传送并且会收到一个文件/tmp/rxfax.tiff.

不止这些

检查被叫是否是传真并做出反应

在有些情况下, 你可能就是自动打电话然后直接发送传真,假设对方是传真机上. 可能你更想是检测到对方是传真机的时候再发传真,如果不是传真机就正常通话. 这个需要可以配合通道变量execute_on_fax_detect 来实现. 瞧瞧这个拨号方案片断:

<extension name="fax detect test">
  <condition field="destination_number" expression="1234">
    <action application="export" 
            data="execute_on_fax_detect='execute_extension 9178'"/>
    <action application="bridge" data="loopback/9664"/>
  </condition>
</extension>

以上拨号方案中我们告诉系统如果检测到传真信号就执行extension(9178), 否则就正常接通电话和播放保持音乐.

你可以在你的拨号方案中用以下这个”理论”进行调整以适应你的需求.

——-只需创建一个处理传真的extension, 使用execute_on_fax_detect检测传真信号,如果检测到传真信号就用execute_extension去执行处理传真的extension.

检测传真问题

传真出问题是很普遍的, 尤其是在VOIP的环境下.
当传真发送失败时,出于某种原因吧,FreeSWITCH可以帮助我们发现出了什么问题. 如果你使用XML CDRs记录通话记录, 每个传真呼叫的CDR中中都会有一些通道变量,不管传真发送成功或失败. 以下就是一个示例:

<fax_v17_disabled>0</fax_v17_disabled>
<fax_ecm_requested>1</fax_ecm_requested>
<fax_filename>/tmp/txfax.tif</fax_filename>
<fax_success>1</fax_success>
<fax_result_code>0</fax_result_code>
<fax_result_text>OK</fax_result_text>
<fax_ecm_used>on</fax_ecm_used>
<fax_local_station_id>SpanDSP%20Fax%20Ident</fax_local_station_id>
<fax_remote_station_id>SpanDSP%20Fax%20Ident</fax_remote_station_id>
<fax_document_transferred_pages>1</fax_document_transferred_pages>
<fax_document_total_pages>1</fax_document_total_pages>
<fax_image_resolution>8031x3850</fax_image_resolution>
<fax_image_size>24111</fax_image_size>
<fax_bad_rows>0</fax_bad_rows>
<fax_transfer_rate>14400</fax_transfer_rate>

使用这些信息去检查传真问题.

有用的软件

有许多开源和免费的软件(FOSS)包, 可帮助我们去处理PDF和TIFF文件. FreeSWITCH社区成员已经成功的使用Ghost Script(http://pages.cs.wisc.edu/~ghost/)对PDF和PostScript文件转换到其他格式或将其他文件转换为PDF和PostScript文件.
通常的应用就是在发送传真前将PDF文件转换到TIFF格式. 下面的命令就可以把PDF转换为一个标准分辨率的TIFF文件.

gs -q -r204x98 -g1728x1078 -dNOPAUSE -dBATCH -dSAFER -sDEVICE=tiffg3 
-sOutputFile=txfax.tiff -- txfax.pdf

产生更高分辨率的TIFF文件, 使用以下命令:

gs -q -r204x196 -g1728x2156 -dNOPAUSE -dBATCH -dSAFER -sDEVICE=tiffg3 
-sOutputFile=txfax.tiff -- txfax.pdf

Ghost Scripts executable(gs)非常适合SHELL脚本.(参数贼多呗).

另参见
> 请参阅本章中的 接收传真
> 请参阅第3章中的使用XML CDRs

转自：http://www.8000hz.com/archives/101.html

Creating conferences
创建会议室

FreeSWITCH擅长让多方连接到一个”会议室”, 可以听到彼此说话. 默认的配置已经有一些会议的示例, 我们可以从它学起. 请记住在FreeSWITCH中并不需要显示地去”创建”一个会议室  ———-  拨号方案中的conference应用会为我们做好一切.

Getting ready

除了有一个文件编辑器外, 你还需要至少两部电话用于测试, 最好是有一个或两个人,那样就可以检验你的电话会议是否工作正常. 同时, 你已经安装了FreeSWITCH默认的配置文件,声音文件和音乐文件.

How to do it…

遵循以下步骤:

1.    拨打号码 3000,然后听. 你将会加入到一个标准的电话会议室. 还有如果会议室中仅有你一个人,你就只能在里面听保持音乐了.
2.    使用另一个电话拨打3000, 两个人就在同一个会议室了.
3.    拨打3000加入更多的成员.

Freeswitch默认的拨号方案已经预定义了一些会议室并且已经可以使用了(注意, 直到至少一个人拨入, 会议才算真正的开启).
默认的拨号方案有以下会议号码:

采样率表示会议中允许成员最大的采样率. 例如如果你有一个使用G722编码,16kHz采样率的话机加入会议室3000, 在发送到其他参会成员前,你的声音会被重新采样为8khz. 如果你拥有多个支持宽带音频的电话, 然后一定要去使用一个高采样率的会议室以获取更高的声音质量.

如果你仅仅需要几个人进入到一个会议室中可以彼此说话, 那么用默认拨号方案中的那些会议就好了, 顶多就是把会议室号码改成你想要的.

There’s more…
会议模块还支持不少功能的, 比如 来电控制和会议主持人. 继续阅读获取有关使用这些功能的信息.

Caller controls  主叫控制

在一个会议中你可以给参会者很多的控制权限. 最普通的就是如下:

>   Talk volume:  主叫发送的声音的音量(这就是, 麦克风增益控制)
>   Listen volume: 你听到的声音音量.
>   Energy threshold: 将主叫的声音认为是他是在说话的最小音量. 当主叫在一个比较嘈杂的环境中时, 提高这个值的大小可以消减背景噪音.

查看默认的主叫控制配置, 打开 conf/autoload_configs/conference.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"/>
    <control action="vol talk dn" digits="1"/>
    <control action="vol listen up" digits="6"/>
    <control action="vol listen zero" digits="5"/>
    <control action="vol listen dn" digits="4"/>
    <control action="hangup" digits="#"/>
  </group>
</caller-controls>

这个主叫控制组的名字是”default”, 而且它不能修改(名字不能修改, 内容随便你). 不过, 你可以定义你自己的主叫控制 ,然后把它们添加到你的会议定义中.

每一种会议都需要在conference.conf.xml文件中的<profiles>章节中添加一个”配置文件”.

假设你创建了一个主叫控制组名字叫”custom”. 在会议配置文件添加这一行就可以让这种会议使用你创建的主叫控制了:

<param name="caller-controls" value="custom"/>

现在所有加入到会议的成员都要使用你指定的主叫控制了.

Conference moderator and PIN
会议主持人和密码

一些会议室有一个”会议主持人”的概念, 他对会议有一定程度的控制权. 在Freeswitch中, 会议主持人就是一个普通会议成员,他是否加入会议室会对会议产生影响.

会议主持人影响会议的两大主要方法如下:

>    所有的成员必须等待, 主持人不来会议不开始
>    主持人离开整个会议结束(所有参会成员都踢出会议室)

通过修改拨号方案中conference 应用的参数来创建一个会议主持人.
对比下面两行”

<action application="conference" data="$1@default"/>
<action application="conference" data="$1@default+flags{moderator}"/>

注意我们添加”+flags{moderator}”就将主叫设置为会议主持人了. 你可以使用逗号分割来添加多个参数, 例如, “+flag{moderator,mute}”.

给会议室添加一个密码也类似. 上面列出的两个会议室可以这样来添加一个密码:

<action application="conference" data="$1@default+1234"/>
<action application="conference" data="$1@default+1234+flags{moderator}"/>

在这两个例子中, 会议室密码都是”1234”, 如果他或她不能输入正确的会议室密码就别想加入到会议.

转自：http://www.8000hz.com/archives/89.html

Music on hold
保持音乐

保持音乐(MOH)是现代电话系统中常见的功能. FreeSWITCH可以让你有许多不同的保持音乐选择.

Getting ready

如果你需要自定义MOH, 你需要一些音乐文件. 而且, 如果你想用在保持音乐中的文件格式是MP3,那么你需要一个可以把MP3转成标准WAV文件的工具. 网站 http://www.mpg123.de上有一个免费的工具. 你还需要一个文件编辑器以及一个注册到你FreeSWITCH上的电话.

How to do it…

首先从FreeSWITCH的下载站点安装默认的保持音乐. Linux/unix用户在FreeSWITCH的源码目录中执行以下命令:

make cd-moh-install

在windows上, 声音文件已经作为MSVC解决方案文件的一部分且编译时自动安装好了.

一旦声音文件安装完毕, 你可以通过拨打9664来确定他们是否安装正常.(不需要reloadxml或系统重启).

How it works…

刚才执行的make命令安装了8KHz, 16kHZ, 32kHZ和48kHZ采样率的保持音乐文件(windows编译时同样安装了).
default拨号方案中的extension 9664会播放默认的保持音乐给主叫. 音乐是由模块mod_file_stream提供的. 通过添加其他的流就可以在你的系统上自定义保持音乐了.

There’s more…

让我们创建一个可选的保持音乐源和测试它.
把你想使用的MP3或WAV文件拷贝到FreeSWITCH服务器上的一个新子目录中.
在这个例子中, 我们会下载几首无版权费用的音乐以及一个声音片断, 还有我们会使用mpg123工具把它们转换为WAV格式.

首先创建一个保存我们新声音文件的目录. 在Linux/Unix做法如下:

mkdir /usr/local/freeswitch/sounds/music/custom1
cd /usr/local/freeswitch/sounds/music/custom1

拷贝你的MP3文件到这个目录中. 或者你可以下载一些免版权的音乐:

wget http://music.incompetech.com/royalty-free/Skye%20Cuillin.mp3
wget http://music.incompetech.com/royalty-free/Parisian.mp3
wget http://music.incompetech.com/royalty-free/credits%20sounder.mp3

现在转换MP3文件到WAV文件格式和删除原始的MP3文件.

for i in *.mp3; do mpg123 -m -r 8000 -w "`basename "$i" .mp3`".wav "$i";
done
rm *.mp3

现在你有了一些可以用作声音源的8kHz的WAV文件. 下一步就是创建实际文件流.

打开文件conf/autoload_configs/local_stream.conf.xml, 然后添加以下新的流定义”

<directory name="custom1" path="$${sounds_dir}/music/custom1">
  <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>

保存文件退出.打开conf/dialplan/default/01_Custom.xml和添加以下extension:

<extension name="hold_music">
  <condition field="destination_number" expression="^96642$">
    <action application="playback" data="${custom1}"/>
  </condition>
</extension>

保存文件退出. 最后我们需要创建一个全局变量${custom1},在任何地方播放我们自定义的保持音乐时都可以使用它. 打开conf/vars.xml文件, 添加以下行:

 <X-PRE-PROCESS cmd="set" data="custom1=local_stream://custom1"/>

保存文件退出. 进入fs_cli然后执行reloadxml或按F6.
当改动本地流定义时你需要重新加载local_stream模块, 在fs_cli中执行:

 reload mod_local_stream

模块重新加载好, 执行以下命令:

 show_local_stream

在本地流列表中应该会有你的新”custom1”流:

custom1,/usr/local/freeswitch/sounds/music/custom1

现在你可以拨打 96642, 然后你可以听到你的新音乐源.
你可以使用 ${custom1} 作为保持音乐(MOH),回铃音和呼转回铃音的源.
例子:

<action application="set" data="ringback=${custom1}"/>
<action application="set" data="transfer_ringback=${custom1}"/>
<action application="set" data="hold_music=${custom1}"/>

——————————————————————————————————————-

转自：http://www.8000hz.com/archives/80.html

Creating XML IVR menus
创建XML互动式语音菜单

FreeSWITCH包含一个 用于创建和主叫进行交互IVR菜单 的系统，简单但很灵活。
在本方法中，我们会创建一个和Freeswitch默认配置的demo IVR 非常相似的自定义语音菜单。

Getting ready

为了测试，我们需要一个文本编辑器和电话。我们会在你拨打5002时收听到创建的自定义菜单。自定义菜单使用FreeSWITCH声音文件中的通用欢迎辞。

How to do it…

<menu name="simple_greeting" 
      greet-long="ivr/ivr-generic_greeting.wav" 
      greet-short="ivr/ivr-generic_greeting.wav" 
      invalid-sound="ivr/ivr-that_was_an_invalid_entry.wav" 
      exit-sound="voicemail/vm-goodbye.wav" 
      confirm-attempts="3" 
      timeout="10000" 
      inter-digit-timeout="2000"
      max-failures="3" 
      max-timeouts="3" 
      digit-len="4"> 
  <entry action="menu-exec-app" digits="9" 
         param="directory default ${domain}"/> 
  <entry action="menu-exec-app" 
         digits="/^(10[01][0-9])$/" 
         param="transfer $1 XML features"/> 
  <entry action="menu-top" digits="*"/>
</menu>

<extension name="sample greeting">
  <!-- Good morning 12am to 11:59 --> 
  <condition hour="0-11" break="never"> 
    <action application="set" data="tod=morning" inline="true"/> 
  </condition> 
  <!-- Good afternoon 12pm to 17:59 --> 
  <condition hour="12-17" break="never"> 
    <action application="set" data="tod=afternoon" inline="true"/> 
  </condition> 
  <!-- Good morning 18:00 to 23:59 --> 
  <condition hour="18-23" break="never"> 
    <action application="set" data="tod=evening" inline="true"/> 
  </condition> 
  <condition field="destination_number" expression="^5002$"> 
    <action application="answer"/> 
    <action application="sleep" data="1000"/> 
    <action application="playback" 
            data="ivr/ivrgood_${tod}.wav"/> 
    <action application="sleep" data="500"/> 
    <action application="ivr" data="simple_greeting"/>
  </condition> 
</extension>

<extension name="sample greeting"> 
  <condition field="destination_number" expression="^5002$"> 
    <action application="answer"/> 
    <action application="ivr" data="simple_greeting"/> 
  </condition> 
</extension>

<extension name="set_tod" continue="true">
  <!-- Good morning 12am to 11:59 --> 
  <condition hour="0-11" break="never"> 
    <action application="set" 
            data="tod=morning" 
            inline="true"/> 
  </condition> 
  <!-- Good afternoon 12pm to 17:59 --> 
  <condition hour="12-17" break="never"> 
    <action application="set" 
            data="tod=afternoon" 
            inline="true"/>
  </condition> 
  <!-- Good morning 18:00 to 23:59 --> 
  <condition hour="18-23" break="never"> 
    <action application="set" 
            data="tod=evening" 
            inline="true"/>
  </condition>
</extension>

greet-long="phrase:simple_greeting:long" 
greet-short="phrase:simple_greeting:short"

<macro name="simple_greeting">
  <input pattern="^(long)$" break-on-match="true"> 
    <match> 
      <action function="sleep" 
              data="1000"/> 
      <action function="play-file" 
              data="ivr/ivr-good_${tod}.wav"/> 
      <action function="sleep" 
              data="500"/> 
      <action function="play-file" 
              data="ivr/ivr-generic_greeting.wav"/> 
      <action function="sleep" 
              data="500"/> 
      <action function="play-file" 
              data="ivr/ivr-to_repeat_these_options.wav"/> 
      <action function="sleep" 
              data="250"/> 
      <action function="play-file" 
              data="voicemail/vm-press.wav"/> 
      <action function="sleep" 
              data="100"/> 
      <action function="play-file" 
              data="ascii/42.wav"/> 
</match>
  </input> 
  <input pattern="^(short)$"> 
    <match> 
      <action function="play-file" 
              data="ivr/ivr-generic_greeting.wav"/> 
      <action function="sleep" 
              data="500"/> 
      <action function="play-file" 
              data="ivr/ivr-to_repeat_these_options.wav"/> 
      <action function="sleep" 
              data="250"/> 
      <action function="play-file" 
              data="voicemail/vm-press.wav"/> 
      <action function="sleep" 
              data="100"/> 
      <action function="play-file" 
              data="ascii/42.wav"/> 
    </match> 
  </input> 
</macro>