概述
freeswitch的架构由稳定的核心模块和大量的外围插件式模块组成。核心模块保持稳定，外围模块可以动态的加载/卸载，非常灵活方便。
外围模块通过核心提供的 Public API与核心进行通信，而核心则通过回调机制执行外围模块中的代码。
FS Core 是FreeSWITCH 的核心，它包含了关键的数据结构和复杂的代码，但这些代码只出现在核心中，并保持了最大限度的重用。核心代码都经过精心的编码和严格的测试，最大限度地保持了系统整体的稳定。
核心代码保持了最高度的抽象，因而它可以调用不同功能，不同协议的模块。同时，良好的API 也使得编写不同的外围模块非常容易。
下面我们来尝试开发一个新的外围模块，并由freeswitch启动、加载、测试。
开发环境
centos：CentOS
release 7.0 (Final)或以上版本
freeswitch：v1.8.7
GCC：4.8.5
新增模块
新建目录$(top_srcdir)/src/mod/applications/mod_task
新建文件$(top_srcdir)/src/mod/applications/mod_task/Makefile.am
$(top_srcdir)/src/mod/applications/mod_task/mod_task.c
目录结构如下
# tree mod_task/
mod_task/
├──Makefile.am
└──mod_task.c
Makefile.am内容如下：
include $(top_srcdir)/build/modmake.rulesam
MODNAME=mod_task
mod_LTLIBRARIES = mod_task.la
mod_task_la_SOURCES = mod_task.c
mod_task_la_CFLAGS = $(AM_CFLAGS)
mod_task_la_LIBADD = $(switch_builddir)/libfreeswitch.la
mod_task_la_LDFLAGS = -avoid-version -module -no-undefined–shared
mod_task.c内容如下：
#include
SWITCH_MODULE_LOAD_FUNCTION(mod_task_load);
SWITCH_MODULE_SHUTDOWN_FUNCTION(mod_task_shutdown);
SWITCH_MODULE_DEFINITION(mod_task,mod_task_load, mod_task_shutdown, NULL);
SWITCH_MODULE_LOAD_FUNCTION(mod_task_load)
{
*module_interface = switch_loadable_module_create_module_interface(pool,modname);
switch_log_printf(SWITCH_CHANNEL_LOG,SWITCH_LOG_INFO,
"mod_task_load start\n");
return SWITCH_STATUS_SUCCESS;
}
SWITCH_MODULE_SHUTDOWN_FUNCTION(mod_task_shutdown)
{
switch_log_printf(SWITCH_CHANNEL_LOG,SWITCH_LOG_INFO,
"mod_task_shutdown stop\n");
returnSWITCH_STATUS_SUCCESS;
}
编译安装
修改$(top_srcdir)/configure.ac 文件，mod_task为新增，注意行前的空格要复制已有行的
…
src/mod/applications/mod_voicemail_ivr/Makefile
src/mod/applications/mod_task/Makefile
…
重新配置编译freeswitch项目
cd $(top_srcdir)
./bootstrap.sh
./configure
make
make install
编译过程中常见问题就是缺少依赖库，根据提示查找安装即可
安装成功后，我们可以在freeswitch的默认安装目录下找到mod_task.so文件
cd /usr/local/freeswitch/mod/
-rwxr-xr-x. 1 root root 48808 8月 17 11:30 mod_task.so
-rwxr-xr-x. 1 root root 1329 8月 17 11:30 mod_task.la
配置启动
cd /usr/local/freeswitch/bin/
./freeswitch –nonat
freeswitch启动成功后，在freeswitch命令行中输入API命令：
freeswitch@localhost.localdomain> load mod_task
2021-08-17 14:18:32.614059 [INFO]mod_enum.c:882 ENUM Reloaded
2021-08-17 14:18:32.614059 [INFO]mod_task.c:56 mod_task_load start
2021-08-17 14:18:32.614059 [CONSOLE]switch_loadable_module.c:1540 Successfully Loaded [mod_task]
+OK Reloading XML
+OK
freeswitch@localhost.localdomain>module_exists mod_task
true
freeswitch@localhost.localdomain> unload mod_task
2021-08-17 14:18:55.434095 [CONSOLE]switch_loadable_module.c:2014 Stopping: mod_task
2021-08-17 14:18:55.434095 [INFO]mod_task.c:99 mod_task_shutdown stop
2021-08-17 14:18:55.434095 [CONSOLE]switch_loadable_module.c:2034 mod_task unloaded.
+OK
freeswitch@localhost.localdomain>
好了，今天我们的freeswitch新增模块就完成了
空空如常
求真得真
