一、 Freeswtich介绍以及各模块介绍

二、Freeswtich常用的配置
1、dialplan
介绍：
在freeswitch中比较重要的一个部分就是diaplan了，diaplan拨号计划简单的来说就是一种号码规则（类似于就是一个路由表，可以理解成 Spring Cloud Gateway中的路由配置，匹配到对应的路由，执行下一步操作），他可以根据自己定义的规则，设置对应did（目标号码）或者设置匹配的规则，每一步如何实现，都在这里设置实现的。
拨号计划由多个context（多xml配置文件）组成，每个context中有多个extension（多个路由，或者说多个匹配规则）。所以context就是多个extension的逻辑集合，它相当于一个分组。一个context的extension和其他context中的extension在逻辑上是隔离的。

配置方式：
例如freeswtich安装在/usr/local/,那dialplan路径就在/usr/local/freeswitch/conf/dialplan，系统默认有两个拨号计划配置文件，分别是public
和default，最常用的是public。

接下来我们打开一个public看下格式，

<include>  <!—固定格式标签-->
  <context name="public">   <!—dialplan名称 -->
   <extension name="test">   <!—单个拨号计划、路由名称 -->
        <!—匹配规则，该规则说明所有被叫号码（destination_number）都可以匹配到 –
         condition field表示你需要匹配的信息是取什么参数进行匹配，expressio：写正则表达式>
        <condition field="destination_number" expression="^(.*)$"> 
        <!—匹配完成后，执行lua脚本 -->
        <!—action  #执行具体的APP或者API动作，一个action通常有两个属性，一个是application代表要执行的APP、另一个是data就是 #APP的参数，当APP没有参数时，data也可以省略-->  <action application="lua" data="95_cu，stomer.lua"/>
      </condition>
    </extension>
  </context>
</include>

注：一些参考例子
① 匹配主叫规则

   <extension name="test"> 
        <condition field="caller_id_number" expression="^(.*)$"> 
          <action application="answer"/>
        </condition>
   </extension>

② 匹配被叫规则

   <extension name="test"> 
        <condition field="destination_number" expression="^(.*)$"> 
            <action application="answer"/>
        </condition>
   </extension>

③ 匹配对端ip

   <extension name="test"> 
        <condition field="network_addr" expression="^(127.0.0.1)$"> 
          <action application="answer"/>
        </condition>
   </extension>

④匹配主被叫和对端ip

   <extension name="test"> 
       <condition field="network_addr" expression="^(127.0.0.1)$" />
        <condition field="caller_id_number" expression="^(18649760218)$"/> 
        <condition field="destination_number" expression="^(01086469999)$"> 
        <action application="answer"/>
        </condition>
   </extension>

⑤一些常用的action
（1）播放欢迎音

<action application="playback" data="/tmp/test.wav"/>

（2）通用录音

<action application="record_session" data="/home/${uuid}.wav"/>

（3）通话接通

（4）桥接通话
1）、直接用ip端口外呼

<action application="bridge" data="sofia/external/${destination_number}@172.16.246.38:5080"/>

2）、使用gateway方式呼叫, gatewayName是动态的，在profile里配置的网关

3）、使用轮训组方式呼叫,使用xhsbc这个轮训组，profile为xhsbc

<action application="bridge" data="sofia/gateway/${distributor(xhsbc ${sofia(profile test gwlist down)})}/${destination_number}/>

（5）在通道中set一些需要用到的参数，将vccid为1007写入通道变量中，将msg为1007写入通道变量中

<action application="set" data="vccid=1007"/>
<action application="set" data="msg=1007"/>

freeswitch提供匹配的参数很多，以下三个是目前最经常用到的参数：
destination_number ：被叫号码
caller_id_number：主叫号码
network_addr ：对端ip地址

常用的dialplan APP
set #用于设置一个通道变量

<action application="set" data="my_var=123456"/>

info #打印全部的通道变量

<action application="info"/>

answer #用于应答一路呼叫，FreeSWITCH做被叫时，如果想给主叫放音，则必须应答后才可以，有些app（如conference或fifo）
#等会隐含应答，因而不需要明确的应答，但有些app（如playback和ivr等）不会隐含应答，因而需要明确的应答

<action application="answer"/>

bridge #负责桥接另一条腿（b-leg），它的参数是一个呼叫字符串，bridge操作是阻塞的，它会一直等到b-leg释放后才继续往下走

<action application="bridge" data="user/1000"/>
<action application="bridge" data="sofia/external/${destination_number}@172.16.246.38:5080"/>

sleep #设置可以等待/暂停的一段时间，单位默认为毫秒

playback用于给channel放音，它的参数是声音文件的路径

#播放多个文件，可以串联操作，如下

<action application="playback" data="/tmp/test1.wav"/>
<action application="playback" data="/tmp/test2.wav"/>

#或者通过file_string协议来串联，如下"!"是文件名的分隔符

#另外通过mod_shout模块，也可以支持本地或远程http或者shout cast服务器上的.mp3格式的文件，如下

<action application="playback" data="http://localhost/test1.wav"/>
<action application="playback" data="shout://localhost/test2.wav"/>

2、profile
介绍
简单的说就是在在freeswtich配置不同的ip和端口，每一个profile都拥有一个xml文件以及一个对应的文件夹，文件夹下存放的就是gateway了

配置方式：
例如freeswtich安装在/usr/local/,那profile路径就在/usr/local/freeswitch/conf/sip_profiles，系统默认有两个profile，分别是external
和internal，最常用的是external。

接下来我们打开一个profile看下，

3、gateway
介绍
，FreeSWITCH里Gateway（网关）的概念。网关又成协议转换器，通常都是进行协议转换。这里说的网关指的是语音网关，如常用的SIP网关，负责SIP协议和七号信令或ISDN PRI（模拟信号）之间的转换。但FreeSWITCH中的网关有时候不一定是真的网关，也可以是另外一个SIP Server（如另一个FreeSWITCH， Asterisk等）。但最终会有一个设备或系统，将SIP转换成模拟信号。简化一下过程，我们认为FreeSWITCH送到的就是真的网关。
配置方式
例如freeswtich安装在/usr/local/,那gateway路径就在/usr/local/freeswitch/conf/sip_profiles/{profile}，我们用xhsbc这个profile来举例
对接的网关大致分2种，一种网关为注册式网关，一种为非注册式网关,，一下讲的是非注册方式

<include>  <!—固定格式标签-->
        <gateway name="yzxhsbc01">  <!—gateway名称-->
                <!—对端ip端口-->
                <param name="realm" value="172.16.246.38:5080"/>
				<!—默认udp -->
                <param name="register-transport" value="udp"/>
				<!—内部使用不需要填写账号 -->
                <param name="username" value=""/>
				<!—内部使用不需要填写密码 -->
                <param name="password" value=""/>
				<!—发送心跳的间隔时间，单位为ms-->
                <param name="ping" value="10" />
				<!—发送心疼最大次数-->
                <param name="ping-max" value="3"/>
 				 <!—发送心疼最小次数-->
				<param name="ping-min" value="1"/>
				<!—指定在SIP消息中的源用户信息，一般写该服务器内网地址-->
                <param name="from-domain" value="172.16.246.40"/>
                <!--仅对注册式有效，注册的有效时间，达到了这个时间后，会重新对中继进行注册-->
                <param name="expire-seconds" value="3600"/>
           	 <!--顾名思义，是否使用from头域中的主叫信息，默认是false的，如果设置后，就可以使用from头域里的主叫信息了-->
                <param name="caller-id-in-from" value="false"/>
                <param name="register" value="false"/>
        </gateway>
</include>

4、distributor.conf
介绍
网关轮询模块，我们一般叫他dis组，

修改代码根目录中 /usr/local/freeswitch/conf/modules.conf，将applications/mod_distributor注释打开，然后执行mod_distributor && make mod_distributor-install，最后生成mod_distributor.so

配置方式：
例如freeswtich安装在/usr/local/,那profile路径就在/usr/local/freeswitch/conf/ distributor.conf.xml

<configuration name="distributor.conf" description="Distributor Configuration">
  <lists><!—固定格式标签-->
		
<list name="iccpsn"><!—distributor名称 -->
      <node name="iccpsn01" weight="1"/> <!—配置的网关名称 ，weight ：表示权重，配置0，标识屏蔽该节点，-->
      <node name="iccpsn02" weight="1"/> 
</list>

  </lists>
</configuration>

在配置中，list 就是一个distributor组，node填写的是gateway的名称，weight填写的是这个组的轮询权重，distributor组不和普通的负载机制一样，他会根据保持的session数进行负载，如果有设置权重的话，他会将按照这个权重对session进行定量的负载，避免出现长短电话而导致的服务器负载不均产生。

5、amqp模块
Freeswtich支持将通话事件推送到rabbitmq上，目前在用是rabbitmq的fanout，其他模式应该也是支持
例如freeswtich安装在/usr/local/,那profile路径就在/usr/local/freeswitch/conf/ amqp.xml

<configuration name="amqp.conf" description="mod_amqp">
  <producers>
    <profile name="default">
      <connections>
        <connection name="primary">
			<!—mq设备ip-->
          <param name="hostname" value="172.16.246.45"/>
			<!—virtualhost"->
          <param name="virtualhost" value="fsbc"/>
			<!—连接mq账号"->
          <param name="username" value="fsbc"/>
			<!—连接mq密码"->
          <param name="password" value="fsbc_0591_..."/>
			<!—连接mq端口，一般是5672"->
          <param name="port" value="5672"/>
          <param name="heartbeat" value="0"/>
        </connection>
      </connections>
      <params>
			<!—交换机名称"->
        <param name="exchange-name" value="iccp_cdr_exchanges"/>
		<!—交换机类型"->
        <param name="exchange-type" value="fanout"/>
        <param name="reconnect_interval_ms" value="1000"/>
        <param name="send_queue_size" value="88888"/>
        <param name="enable_fallback_format_fields" value="1"/>
        <param name="format_fields" value="FreeSWITCH-Hostname,Event-Name,Event-Subclass,Unique-ID"/>
		<!—freeswtich挂机事件"->
        <param name="event_filter" value="SWITCH_EVENT_CHANNEL_DESTROY"/>
      </params>
    </profile>
  </producers>
</configuration>

6、lua在freeswtich使用
1、首先是在拨号计划中配置好需要调用的lua脚本

<extension name="test"> 
        <condition field="destination_number" expression="^(.*)$"> 
        <!—匹配完成后，执行lua脚本 -->
<action application="lua" data="test.lua   22"/>
      </condition>
</extension>

2、在脚本中进行业务逻辑处理

输出日志
local test = "test";
--输出info日志
freeswitch.consoleLog("INFO", test);
--输出error日志
freeswitch.consoleLog("err", test);
--输出debug日志
freeswitch.consoleLog("debug", test);	
获取通道中的变量
-- 获取通道变量中的主叫
local callerNumber=session:getVariable("caller_id_number");
-- 获取通道变量中的被叫
local calledNumber=session:getVariable("destination_number");
-- 获取通道变量中的uuid，每通通话都是唯一的
local uuid=session:getVariable("uuid");
--注：获取通道中的变量方式session:getVariable("{变量}");

脚本接收外部传入参数
--传入第一个参数
local argv1 = argv[1];
--传入第二个参数
local argv2 = argv[2];
--...
--注：传入的参数不能为空，为空下一个参数会填充


脚本简单的一些set操作
--将通话接听
session:answer();
--播放ivr音
session:execute("playback", "/home/test.wav");
--将vccid为1007set到通道变量中
session:execute("set", "vccid=1007");
--通话录音
session:execute("record_session", "/home/record.wav")

进行外呼操作
--定义参数
local called="18649760218"
（1）第一种方式
--呼叫18649760218号码，简单的用ip端口外呼方式，lua脚本拼接参数是用..
session:execute("bridge", "sofia/external/"..called.."@172.16.246.38:5080")
--使用13000000000为主叫进行外呼
session:execute("bridge", "{origination_caller_id_number=13000000000}sofia/external/"..called.."@172.16.246.38:5080")
--呼叫18649760218号码，使用gateway方式呼叫, gatewayName是动态的，在profile里配置的网关
session:execute("bridge", "sofia/gateway/{gatewayName}/"..called.."")
--使用13000000000为主叫进行外呼
session:execute("bridge", "{origination_caller_id_number=13000000000}sofia/gateway/{gatewayName}/"..called.."")
--呼叫18649760218号码，使用轮训组方式呼叫,使用xhsbc这个轮训组，profile为xhsbc
session:execute("bridge", "sofia/gateway/${distributor(xhsbc ${sofia(profile test gwlist down)})}/"..called.."")
--使用13000000000为主叫进行外呼
session:execute("bridge", "{origination_caller_id_number=13000000000}sofia/gateway/${distributor(xhsbc ${sofia(profile test gwlist down)})}/"..called.."")

（2）第二种方式，将呼叫命令提取出来，单独定义
local command="{origination_caller_id_number=13000000000}sofia/external/"..called.."@172.16.246.38:5080";
session:execute("bridge", command)

（3）第三种方式，将呼叫命令提取出来，单独定义，并且拆分多个内容
local ostrs = {};
ostrs[1] = "{maxDuration=3600,origination_caller_id_number=13000000000";
ostrs[2] = ",vccid=1007";
ostrs[3] = ",servicekey=1007";
ostrs[4] = "}";
ostrs[5]="sofia/external/"..called.."@172.16.246.38:5080";
--将上述所有指令进行整合
ostr0 = table.concat(ostrs);
--最后是这样的
ostr0="{maxDuration=3600,origination_caller_id_number=13000000000,vccid=1007,servicekey=1007}sofia/external/"..called.."@172.16.246.38:5080";
--最后进行外呼操作
session:execute("bridge", ostr0)

调用另一个脚本使用bgapi命令
local str1="str1";
local str2="str2";

--注意：传入的参数，两个参数之间要空格
commad = "bgapi lua test.lua "..str1.." "..str2.."";
api:executeString(commad);


使用uuid方式进行放音
api = freeswitch.API();
-- 获取通道变量中的uuid，每通通话都是唯一的
local uuid=session:getVariable("uuid");
local callCaller = "uuid_broadcast " .. uuid .. " /home/test.wav";
api:executeString(callCaller);


将某些操作封装成方法
function playback()
	session:execute("playback", "/home/test.wav");
end

--执行这个方法
playback();

--判断文件是否存在
function exists(recordHintTone)
    local path="/usr/local/freeswitch/sounds/en/us/callie/";
    local exists=loadConfig(path..recordHintTone);
    if exists  then
        return "true";
    else
        return "false";

    end
end

--执行这个方法
local exists=exists("test.wav");

lua脚本get请求url
（1）没有返回值
require "curl"
--请求完整路径（包含请求参数）
local requestUrl = "http://172.16.251.71:8091/forward/eventInfo?vccid=1007";
c:setopt(curl.OPT_URL, requestUrl)
c:perform()
freeswitch.consoleLog("INFO", record_id.."|"..callStatus.."|状态推送成功\n");

（2）有返回值，返回json字符串
require "curl"
local cjson = require "cjson"
c = curl.easy_init()
--主函数
function main()
    
    requestUrl="http://172.16.251.71:8091/forward/eventInfo?vccid=1007";
    freeswitch.consoleLog("INFO", "请求url|"..requestUrl.."\n")
    c:setopt(curl.OPT_URL, requestUrl)
    c:setopt(curl.OPT_WRITEFUNCTION, function(buffer)
        freeswitch.consoleLog("info", "打印日志: "..buffer.."\r\n");
		--将字符转转换成json
        result =  cjson.decode(buffer);
		--获取code参数
        local code= result["code"];
        return #buffer
    end)
    c:perform()
end