freeswitch python模块

概述

freeswitch支持多种语言的业务开发,包括C/C++,java,python,js,lua,Golang等等。

freeswitch在使用python做业务开发时,有俩种接入方式,一种是ESL接口,另一种是mod_python模块。

python的ESL接口是通过socket套接字与freeswitch进行命令交互,包括发送命令、命令响应和事件回调等,类似于在外部增加一个第三方模块控制fs行为。

ESL接口部分会在后续的章节中详细介绍。

今天我们要介绍的是fs内部的mod_python语言支持模块,该模块允许我们使用python脚本开发fs呼叫控制流程。


环境

centos:CentOS  release 7.0 (Final)或以上版本

freeswitch:v1.8.7

GCC:4.8.5


安装mod_python模块

freeswitch的源码安装部署请参照之前的文章

freeswitch源码安装时,默认不安装mod_python模块,需要我们进入目录编译安装。

cd  /root/freeswitch-1.8.7/src/mod/languages/mod_python

make  install


cd  /usr/local/freeswitch/mod

ll  -tr

-rwxr-xr-x. 1 root root  753208 9月  14 10:41 mod_python.so

-rwxr-xr-x. 1 root root    1360 9月  14 10:41 mod_python.la


python脚本

增加testapi.py脚本

vi  /usr/local/freeswitch/scripts/testapi.py

import freeswitch

def fsapi(session,stream,env,args):

    stream.write("hello")

    freeswitch.consoleLog("info","test")


增加testapp.py脚本

vi  /usr/local/freeswitch/scripts/testapp.py

import freeswitch

def handler(session, args):

    session.answer()

    freeswitch.console_log("info","testCall\n")

    session.streamFile("local_stream://moh")

    freeswitch.msleep(3000)

    session.hangup()


配置启动

修改freeswitch模块加载配置文件

cd  /usr/local/freeswitch/conf/autoload_configs

vi  modules.conf.xml

<!-- Languages -->

<load module="mod_python"/>


修改dialplan拨号计划

cd  /usr/local/freeswitch/conf/dialplan

vi  public.xml

<include>

  <context name="public">

    <extension name="test">

      <condition>

        <action application="python" data="testapp"/>

      </condition>

    </extension>


启动freeswitch

cd  /usr/local/freeswitch/bin

./freeswitch  -nonat

2021-09-14 10:57:06.392800 [NOTICE] mod_python.c:551 Python Framework Loading...

2021-09-14 10:57:06.405965 [CONSOLE] switch_loadable_module.c:1540 Successfully Loaded [mod_python]

2021-09-14 10:57:06.405982 [NOTICE] switch_loadable_module.c:292 Adding Application 'python'

2021-09-14 10:57:06.406012 [NOTICE] switch_loadable_module.c:315 Adding Chat Application 'python'

2021-09-14 10:57:06.406030 [NOTICE] switch_loadable_module.c:338 Adding API Function 'pyrun'

2021-09-14 10:57:06.406046 [NOTICE] switch_loadable_module.c:338 Adding API Function 'python'


测试

在freeswitch命令行中输入命令,使用python调用API接口

freeswitch@localhost.localdomain> python  testapi

2021-09-14 11:13:56.068722 [NOTICE] mod_python.c:212 Invoking py module: testapi

2021-09-14 11:13:56.088701 [INFO] switch_cpp.cpp:1443 test

hello

在日志打印中,我们可以看到mod_python模块调用了testapi脚本,并打印了“test“和”hello“。

注意事项,python调用命令中,python脚本的后缀“.py“要去掉。

通过其他sip server发送呼叫请求到本机,查看日志:

2021-09-14 11:24:40.988720 [NOTICE] switch_channel.c:1114 New Channel sofia/external/10011@192.168.0.110 [73b09c9b-6a62-4372-839b-4c076af7dfc2]

2021-09-14 11:24:40.988720 [INFO] mod_dialplan_xml.c:637 Processing 10011 <10011>->10012 in context public

2021-09-14 11:24:40.988720 [NOTICE] mod_python.c:212 Invoking py module: testapp

2021-09-14 11:24:40.988720 [NOTICE] sofia_media.c:92 Pre-Answer sofia/external/10011@192.168.0.110!

2021-09-14 11:24:40.988720 [NOTICE] switch_cpp.cpp:685 Channel [sofia/external/10011@192.168.0.110] has been answered

2021-09-14 11:24:40.988720 [INFO] switch_cpp.cpp:1443 testCall

2021-09-14 11:24:40.988720 [WARNING] mod_local_stream.c:870 Unknown source moh, trying 'default'

2021-09-14 11:24:40.988720 [ERR] mod_local_stream.c:878 Unknown source default

2021-09-14 11:24:43.988724 [NOTICE] switch_cpp.cpp:733 Hangup sofia/external/10011@192.168.0.110 [CS_EXECUTE] [NORMAL_CLEARING]

2021-09-14 11:24:44.008687 [NOTICE] switch_core_session.c:1744 Session 2 (sofia/external/10011@192.168.0.110) Ended

2021-09-14 11:24:44.008687 [NOTICE] switch_core_session.c:1748 Close Channel sofia/external/10011@192.168.0.110 [CS_DESTROY]

在日志打印中,我们可以看到在dialplan拨号计划的执行过程中,通过mod_python调用了“testapp“,testapp.py脚本中应答了这通呼叫,打印日志”testcall“,并在3秒后挂机。


总结

freeswitch做业务开发时,支持多种语言接入,很方便,用户可以根据自己的技能栈来选择接入方式和语言。

但是,不同语言在呼叫性能上肯定有差异,这个就需要用户自己来测试并评估实际使用中的差别了。



空空如常

求真得真

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 205,033评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,725评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,473评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,846评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,848评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,691评论 1 282
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,053评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,700评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,856评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,676评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,787评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,430评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,034评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,990评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,218评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,174评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,526评论 2 343

推荐阅读更多精彩内容

  • 概述 之前的文章中,我们讲解了freeswitch的源码基本结构,如何新增一个插件式模块,以及如何在模块中新增一个...
    求真得真阅读 669评论 0 0
  • 概述 之前的文章中,我们讲解了freeswitch的源码基本结构,如何新增一个插件式模块,以及如何在模块中新增一个...
    求真得真阅读 1,917评论 0 0
  • 1.查看网关注册状态 sofia status 2.桥接(未实践) http://wiki.freeswitch....
    幽澜先生阅读 6,160评论 0 0
  • 目录 1. 安装freeswitch├── 1.1 相关地址├── 1.2 安装基础包├── 1.3 安装依赖包├...
    Jetsly阅读 66,878评论 8 25
  • 一、模块接口 FreeSWITCH的大部分功能是通过加载外部的模块来实现的。模块通过一个数据结构向外部暴露了自己的...
    火星凯撒阅读 1,755评论 0 1