python作为脚本语言,使用起来很方便,查了下opensips的文档,支持使用python脚本写逻辑代码。今天整理下CentOS7环境下opensips2.4.9的python模块笔记及使用示例,并提供运行效果视频和配套文件下载。
我将从以下几方面进行展开:
模块安装说明
模块参数说明
模块函数说明
模块使用示例
python模块官方文档:
https://opensips.org/docs/modules/2.4.x/python.html
1)安装python开发库
yum install python-devel.x86_64
2)进入opensips源码目录
cd opensips-2.4.9
3)选中 python 模块
make menuconfig
4)编译及安装opensips
make && make install
CentOS7环境下源码安装opensips,可参考如下文章:
模块文件: python.so
模块参数如下:
script_name
用于设置python脚本的路径。
mod_init_function
用于设置python脚本的初始化函数,默认是mod_init
child_init_method
用于设置python脚本的子进程(子类)的初始化函数,默认是child_init
模块加载及配置数据库
文件:opensips.cfg
配置示例:
#### python module loadmodule "python.so" modparam("python", "script_name", "/usr/local/etc/opensips/op-test1.py") #modparam("python", "mod_init_function", "module_initializer") #modparam("python", "child_init_method", "child_initializer")
函数: python_exec
python_exec(method_name [, extra_args])
该函数调用python脚本里面的方法。
2.1 LM_ERR函数
在python里面,opensips作为独立的模块,导出了LM_ERR函数,定义如下(python_iface.c):
该函数用于打印日志,示例如下:
LM_ERR('test msg from python')
2.2 sip msg相关属性及方法
属性定义如下(python_msgobj.c):
方法定义如下(python_msgobj.c):
Type
msg的类型,SIP_REQUEST 或 SIP_REPLY
Method
msg的方法,比如:"INVITE"
Status
msg的状态,只适用于reply
RURI
msg的R-URI,只适用于request
src_address
msg的源地址信息
dst_address
msg的目的地址信息
copy()
复制当前SIP消息
rewrite_ruri(uri)
修改msg的request URI,仅适用于request
set_dst_uri(uri)
修改msg的destination URI ,仅适用于request
getHeader(hdr)
获取SIP头的具体内容
call_function(funName,...)
调用其它模块的函数
这里演示下python模块的加载,及使用该模块进行简单测试。
使用LM_ERR函数进行日志打印。
示例代码(op-test1.py):
from OpenSIPS import LM_ERR class ObjA(): def child_init(self,rank): return 0 def pytest1(self,var1): LM_ERR("test msg from python script") return 1 def mod_init(): return ObjA()
opensips.cfg配置如下:
#### python module loadmodule "python.so" modparam("python", "script_name", "/usr/local/etc/opensips/op-test1.py") #modparam("python", "mod_init_function", "module_initializer") #modparam("python", "child_init_method", "child_initializer") ####### Routing Logic ######## # main request routing logic route{ if(python_exec("pytest1")) { xlog("python test1 return true\n"); } exit;
运行效果如下:
运行效果视频可从如下渠道获取:
关注微信公众号(聊聊博文,文末可扫码)后回复 2024042301 获取。
示例代码及配置可从如下渠道获取:
关注微信公众号(聊聊博文,文末可扫码)后回复 20240423 获取。
运行效果如下:
运行效果视频可从如下渠道获取:
关注微信公众号(聊聊博文,文末可扫码)后回复 2024042302 获取。
这里演示下python调用drouting模块函数实现话务路由的功能。
机器列表:
freeswitchA :192.168.137.31:5080
opensips :192.168.137.33:5060
freeswitchB :192.168.137.32:5080
测试目标:将freeeswitchA呼叫opensips的通话路由到freeswitchB机器。
拨号方案等信息参考如下文章:
示例代码及配置可从如下渠道获取:
关注微信公众号(聊聊博文,文末可扫码)后回复 20240423 获取。
运行效果如下:
抓包效果如下:
运行效果视频可从如下渠道获取:
关注微信公众号(聊聊博文,文末可扫码)后回复 2024042303 获取。
本文涉及资源,可以从如下途径获取:
关注微信公众号(聊聊博文,文末可扫码)后回复 20240423 获取。
好,就这么多了,别忘了点赞哈!