概述
freeswitch是一款简单好用的VOIP开源软交换平台。
fs中有非常多的接口和通道变量,使用方式多变。
官方文档有时候也仅仅是介绍了最基本的使用方法和格式。
环境
centos:CentOS release 7.0 (Final)或以上版本
freeswitch:v1.6
GCC:4.8.5
execute_on_xxxx
fs提供了一系列的execute_on_xxxx通道变量,供使用者设置,常见的如下。
execute_on_answer
execute_on_pre_answer
execute_on_media
execute_on_ring
execute_on_tone_detect
execute_on_originate
execute_on_post_originate
execute_on_pre_originate
execute_on_pre_bridge
execute_on_post_bridge
每一个通道变量对应呼叫流程中的状态,符合呼叫状态即会调用。
比如execute_on_media,当收到183或200之后,有媒体通道建立成功,则调用对应的APP。
用法,execute_on_media特别适合做录音的启动点,可以把早期媒体和正常通话都录下来。
<action application="export" data="execute_on_media=app + params"/>
但是某些场景下,我们需要在一个状态时调用多个APP,比如当有媒体进入的时候,我们希望同时开启录音和音频检测。
<action application="export" data="execute_on_media=record_session ${record_file}.wav"/>
<action application="export" data="execute_on_media=spandsp_start_dtmf"/>
这样的配置在实际业务流程中,由于execute_on_media是通道变量,后一个会覆盖前一个,最后只会执行一个“spandsp_start_dtmf”的APP。
源码
查看switch_channel.c的源码,execute_on的函数如下,参数2“variable_prefix”为“execute_on_media”。
SWITCH_DECLARE(switch_status_t) switch_channel_execute_on(switch_channel_t *channel, const char *variable_prefix)
{
switch_event_header_t *hp;
switch_event_t *event, *cevent;
int x = 0;
switch_core_get_variables(&event);
switch_channel_get_variables(channel, &cevent);
switch_event_merge(event, cevent);
for (hp = event->headers; hp; hp = hp->next) {
char *var = hp->name;
char *val = hp->value;
if (!strncasecmp(var, variable_prefix, strlen(variable_prefix))) {
if (hp->idx) {
int i;
for (i = 0; i < hp->idx; i++) {
x++;
do_execute_on(channel, hp->array[i]);
}
} else {
x++;
do_execute_on(channel, val);
}
}
}
switch_event_destroy(&event);
switch_event_destroy(&cevent);
return x ? SWITCH_STATUS_SUCCESS : SWITCH_STATUS_FALSE;
}
可以看出,execute_on的处理流程中,会把event的全部headers遍历一遍,对于每个header,对headername和variable_prefix进行比较。
匹配则检查header的idx,idx不为0的时候,对header下的array字段轮询调用do_execute_on。
这里有两种配置方案可以实现我们需要的多次execute_on_media。
第一种,比较明显,利用header的idx,对execute_on_media设置多个值。
<action application="export" data="execute_on_media[0]=log::execute_on_media[0]"/>
<action application="export" data="execute_on_media[1]=log execute_on_media[1]"/>
第二种,隐藏方案,strncasecmp只比较固定长度。
<action application="export" data="execute_on_media-1=log::execute_on_media[0]"/>
<action application="export" data="execute_on_media-2345=log execute_on_media[1]"/>
测试方案
测试方案使用第一种配置方案,dialplan如下。
<action application="export" data="execute_on_media[0]=log::execute_on_media[0]"/>
<action application="export" data="execute_on_media[1]=log execute_on_media[1]"/>
测试结果
发起呼叫,dialplan的流程日志如下。
2023-11-22 17:54:46.345184 [NOTICE] sofia_media.c:92 Pre-Answer sofia/external/10011@10.55.55.138!
EXECUTE sofia/external/10011@10.55.55.138 log(execute_on_media[1])
2023-11-22 17:54:46.345184 [DEBUG] mod_dptools.c:1742 execute_on_media[1]
...
2023-11-22 17:54:46.345184 [DEBUG] sofia.c:7084 Channel sofia/external/10011@10.55.55.138 entering state [early][183]
2023-11-22 17:54:46.345184 [DEBUG] switch_ivr.c:623 sofia/external/10011@10.55.55.138 Command Execute log(execute_on_media[0])
EXECUTE sofia/external/10011@10.55.55.138 log(execute_on_media[0])
2023-11-22 17:54:46.345184 [DEBUG] mod_dptools.c:1742 execute_on_media[0]
总结
execute_on大部分源码在switch_channel.c中。
思考为什么测试结果中,先执行log1,再执行log0。
空空如常
求真得真