freeswitch设置多个execute_on_media

概述

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。

空空如常

求真得真