FreeSWITCH入门到精通系列（四）：FreeSWITCH模块介绍与使用

FreeSWITCH模块介绍与使用

FreeSWITCH 是一个模块化的开源通信平台，支持语音、视频、即时消息和 WebRTC。其灵活性主要来源于模块化架构，允许用户根据需求加载不同的功能模块。本文将详细介绍 FreeSWITCH 的模块体系、核心模块、如何加载/卸载模块，并举例说明如何配置和使用它们。

1. FreeSWITCH 模块体系

在 FreeSWITCH 中，模块分为以下几类：

2. FreeSWITCH 模块管理

2.1 查看已加载模块

在 FreeSWITCH 控制台输入：

fs_cli -x "show modules"

示例输出：

name                    type        description
mod_sofia               endpoint    SIP Endpoint Module
mod_conference          application Conference Module
mod_opus                codec       Opus Codec
...

其中：

• name：模块名称
• type：模块类型（endpoint, application, codec, etc.）
• description：模块说明

2.2 加载模块

在 FreeSWITCH 控制台执行：

fs_cli -x "load mod_sofia"

2.3 卸载模块

fs_cli -x "unload mod_sofia"

2.4 重新加载模块

fs_cli -x "reload mod_sofia"

2.5 在配置文件中启用模块

打开 /etc/freeswitch/autoload_configs/modules.conf.xml，找到 <modules> 部分，添加需要加载的模块：

<modules>
    <load module="mod_sofia"/>
    <load module="mod_conference"/>
    <load module="mod_opus"/>
</modules>

然后重启 FreeSWITCH：

systemctl restart freeswitch

3. 重要 FreeSWITCH 模块介绍

3.1 mod_sofia (SIP 处理)

mod_sofia 是 FreeSWITCH 的 SIP 处理模块，支持 SIP 终端和中继。
启用配置：

<configuration name="sofia.conf" description="Sofia SIP">
    <profiles>
        <profile name="internal">
            <gateway name="my_sip_provider">
                <param name="username" value="1001"/>
                <param name="password" value="password"/>
                <param name="proxy" value="sip.example.com"/>
            </gateway>
        </profile>
    </profiles>
</configuration>

常见命令：

fs_cli -x "sofia status"
fs_cli -x "sofia profile internal restart"

3.2 mod_conference (会议)

用于创建音频/视频会议室。
配置示例 (conference.conf.xml)：

<configuration name="conference.conf" description="Conference Settings">
    <profiles>
        <profile name="default">
            <param name="energy-level" value="30"/>
            <param name="comfort-noise" value="true"/>
        </profile>
    </profiles>
</configuration>

拨号计划 (dialplan/default.xml)：

<extension name="Conference">
    <condition field="destination_number" expression="^3000$">
        <action application="conference" data="3000@default"/>
    </condition>
</extension>

进入会议室：

fs_cli -x "conference 3000 list"

3.3 mod_fifo (队列)

用于创建呼叫队列，实现简单的呼叫中心功能。
配置示例 (fifo.conf.xml)：

<configuration name="fifo.conf" description="FIFO Queues">
    <fifos>
        <fifo name="support_queue@default">
            <param name="announce" value="support-queue.wav"/>
        </fifo>
    </fifos>
</configuration>

拨号计划 (dialplan/default.xml)：

<extension name="Enter FIFO Queue">
    <condition field="destination_number" expression="^4000$">
        <action application="fifo" data="support_queue@default in"/>
    </condition>
</extension>

3.4 mod_esl (事件处理)

用于外部应用控制 FreeSWITCH，可以通过 Python、Lua 监听事件。
ESL 连接示例 (python)：

import ESL
con = ESL.ESLconnection("127.0.0.1", "8021", "ClueCon")
if con.connected():
    con.sendRecv("api status")
    print(con.getBody())

3.5 mod_lua (Lua 脚本)

FreeSWITCH 可以使用 Lua 处理自定义逻辑。
示例 (script.lua)：

session:answer()
session:sleep(1000)
session:streamFile("hello.wav")
session:hangup()

拨号计划调用 Lua 脚本：

<extension name="Lua Script">
    <condition field="destination_number" expression="^5000$">
        <action application="lua" data="script.lua"/>
    </condition>
</extension>

4. 结论

• FreeSWITCH 采用模块化架构，可灵活加载不同功能模块。
• 通过 autoload_configs/modules.conf.xml 进行模块管理。
• 关键模块包括 mod_sofia (SIP)、mod_conference (会议)、mod_fifo (队列)、mod_esl (事件处理) 和 mod_lua (脚本扩展)。
• 结合不同模块可以构建复杂的 VoIP 应用，如呼叫中心、IVR、WebRTC 语音系统等。

希望这篇文章能帮助你掌握 FreeSWITCH 模块的基本使用。如果有任何问题，欢迎交流！🚀