概述

之前的文章中,我们讲解了freeswitch的源码基本结构,如何新增一个插件式模块,以及如何在模块中新增一个命令式API接口和APP接口。

freeswitch本身是事件驱动的,它可以并发响应多个事件,也可以广播事件。

freeswitch的事件可以由核心产生,也可以由外部模块或外部源产生。

freeswitch系统中的几乎所有事件都会产生事件消息,这些事件可以被外部实体监听(通过event socket),也可以被内部模块监听。

freeswitch的事件系统是双向的,除了允许外部程序监听事件外,外部程序还可以向freeswitch发送事件。

你可以从自己的程序中实时发送/接收事件。这种组合允许你以几乎任何你能想到的方式使用freeswitch。

通道事件

在freeswitch的事件系统中,有一类以“CHANNEL_“开头的事件,这些事件表示了一个呼叫通道(channel)的状态变化的全部过程,是我们在业务开发中最常用的一类事件。

常见的通道事件:

CHANNEL_ANSWER

CHANNEL_APPLICATION

CHANNEL_BRIDGE

CHANNEL_CALLSTATE

CHANNEL_CREATE

CHANNEL_DATA

CHANNEL_DESTROY

CHANNEL_EXECUTE

CHANNEL_EXECUTE_COMPLETE

CHANNEL_GLOBAL

CHANNEL_HANGUP

CHANNEL_HANGUP_COMPLETE

CHANNEL_HOLD

CHANNEL_ORIGINATE

CHANNEL_OUTGOING

CHANNEL_PARK

CHANNEL_PROGRESS

CHANNEL_PROGRESS_MEDIA

CHANNEL_STATE

CHANNEL_UNBRIDGE

CHANNEL_UNHOLD

CHANNEL_UNPARK

CHANNEL_UUID

通道事件可以携带一通呼叫的全部呼叫信息,也可以携带呼叫流程中的自定义信息,这个属性让我们可以很方便的在一通呼叫的不同阶段之间传递自定义参数。

本节我们来介绍如何在模块中增加一个channel event事件处理,并传递一个自定义参数。

开发环境

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

freeswitch:v1.8.7

GCC:4.8.5

代码处理

新增模块的方法请参考之前的内容,本节内容在模块mod_task的基础上修改。

mod_task.c内容如下:

#include <switch.h>

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_STANDARD_API(task_api_function)

{

    //SWITCH_STANDARD_API have three args: (cmd, session, stream)

    char *mycmd = NULL;

    int argc = 0;

    char *argv[16];

    bzero(argv, sizeof(argv));

    //split cmd and parse

    if (cmd)

    {

        mycmd = strdup(cmd);

        if (!mycmd)

        {

            stream->write_function(stream, "Out of memory\n");

            return SWITCH_STATUS_FALSE;   

        }

        if (!(argc = switch_split(mycmd, ' ', argv)) || !argv[0])

        {

            argc = 0;

            switch_safe_free(mycmd);

            return SWITCH_STATUS_FALSE;

        }

    }

    //parse cmd, brach process

    if(0 == strcmp("test1", argv[0]))

    {

        stream->write_function(stream, "task api test1, cmd:%s, session:%p", cmd, session);

    }

    else if(0 == strcmp("test2", argv[0]))

    {

        stream->write_function(stream, "task api test2, cmd:%s, session:%p", cmd, session);

    }

    else

    {

        stream->write_function(stream, "unknown cmd, cmd:%s, session:%p", cmd, session);

    }   

    switch_safe_free(mycmd);

       return SWITCH_STATUS_SUCCESS;

}

SWITCH_STANDARD_APP(task_app_function)

{

    switch_channel_t *pchannel = NULL;

    //task_app(session, data);

    switch_log_printf(SWITCH_CHANNEL_LOG, SWITCH_LOG_INFO,

            "task_app_function start, session=%p, data=%s\n", (void*)session, data);

    //export variable task_str for hangup event

    pchannel = switch_core_session_get_channel(session);

    if(NULL != pchannel)

    {

        switch_channel_export_variable(pchannel, "task_str", "task_app export variable", SWITCH_EXPORT_VARS_VARIABLE);

    }

}

void task_event_channel_hangup_complete(switch_event_t *event)

{

    const char *uuid = switch_event_get_header(event, "Unique-ID");

    const char *call_dir = switch_event_get_header(event, "Call-Direction");

    const char* task_str = switch_event_get_header(event, "variable_task_str");

    switch_log_printf(SWITCH_CHANNEL_LOG, SWITCH_LOG_INFO,

        "task_event_channel_hangup_complete, uuid=%s, call_dir=%s, task_str=%s\n",

        uuid, call_dir, task_str);

}

void task_event_handler(switch_event_t *event)

{

    switch (event->event_id)

    {

        case SWITCH_EVENT_CHANNEL_HANGUP_COMPLETE:

            task_event_channel_hangup_complete(event);

            break;

        case SWITCH_EVENT_CHANNEL_ANSWER:

        default:

            switch_log_printf(SWITCH_CHANNEL_LOG, SWITCH_LOG_ERROR,

                "unsupported event. event:%d\n", event->event_id);

            break;

    }

    return;

}

SWITCH_MODULE_LOAD_FUNCTION(mod_task_load)

{

       switch_api_interface_t* api_interface = NULL;

    switch_application_interface_t* app_interface = NULL;

    *module_interface = switch_loadable_module_create_module_interface(pool, modname);

       switch_log_printf(SWITCH_CHANNEL_LOG, SWITCH_LOG_INFO,

            "mod_task_load start\n");

    // register APP

    SWITCH_ADD_APP(app_interface,

           "task_app",

           "task_app",

           "task_app",

           task_app_function,

           "NULL",

           SAF_SUPPORT_NOMEDIA | SAF_ROUTING_EXEC);

    // register API

    SWITCH_ADD_API( api_interface,

                    "task",

                    "task api",

                    task_api_function,

                    "<cmd> <args>");

    // 注册终端命令自动补全

    switch_console_set_complete("add task test1 [args]");

    switch_console_set_complete("add task test2 [args]");

    ///////////////EVENT INIT////////////////////

    if (SWITCH_STATUS_SUCCESS != switch_event_bind(modname, SWITCH_EVENT_CHANNEL_HANGUP_COMPLETE, SWITCH_EVENT_SUBCLASS_ANY, task_event_handler, NULL)){

        switch_log_printf(SWITCH_CHANNEL_LOG, SWITCH_LOG_ERROR, "can't bind event\n");

        return SWITCH_STATUS_GENERR;

    }

    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");

       return SWITCH_STATUS_SUCCESS;

}

呼叫处理过程中,我们在“task_app_function“函数中通过”switch_channel_export_variable“接口设置了一个自定义通道变量”task_str“的值为”task_app export variable“。

然后在呼叫的挂机事件中,我们又取出了消息头域中“variable_task_str“的值并打印到日志中。

通过这种方式,我们可以在呼叫流程的不同阶段传递任意自定义参数

编译安装

进入task模块目录,编译安装,在Makefile.am文件未变化的情况下,不需要重新config。

cd  $(top_srcdir)/src/mod/applications/mod_task

make  install

配置启动

修改dialplan拨号计划

cd /usr/local/freeswitch/conf/dialplan

vi public.xml

…

<include>

  <context name="public">

    <extension name="test">

      <condition>

        <action application="task_app" data="${destination_number}"/>

      </condition>

    </extension>

…

启动fs

cd /usr/local/freeswitch/bin/

./freeswitch –nonat

加载测试

freeswitch启动成功后,在freeswitch命令行中输入API命令加载mod_task模块:

freeswitch@localhost.localdomain> load mod_task

2021-09-03 11:34:50.954223 [INFO] mod_enum.c:882 ENUM Reloaded

2021-09-03 11:34:50.954223 [INFO] mod_task.c:134 mod_task_load start

2021-09-03 11:34:50.954223 [CONSOLE] switch_loadable_module.c:1540 Successfully Loaded [mod_task]

2021-09-03 11:34:50.954223 [NOTICE] switch_loadable_module.c:292 Adding Application 'task_app'

+OK Reloading XML

+OK

2021-09-03 11:34:50.954223 [NOTICE] switch_loadable_module.c:338 Adding API Function 'task'

通过其他sip服务器发起invite呼叫到本机的5080端口,在日志中可以查看到:

freeswitch@localhost.localdomain> 2021-09-03 11:34:56.614251 [NOTICE] switch_channel.c:1114 New Channel sofia/external/10011@192.168.0.110 [a34a67c3-2b8d-401f-a16f-1f5ec3e5169f]

2021-09-03 11:34:56.614251 [INFO] mod_dialplan_xml.c:637 Processing 10011 <10011>->10012 in context public

2021-09-03 11:34:56.614251 [INFO] mod_task.c:88 task_app_function start, session=0x7fbb8402fab8, data=10012

2021-09-03 11:34:56.614251 [NOTICE] switch_core_state_machine.c:385 sofia/external/10011@192.168.0.110 has executed the last dialplan instruction, hanging up.

2021-09-03 11:34:56.614251 [NOTICE] switch_core_state_machine.c:387 Hangup sofia/external/10011@192.168.0.110 [CS_EXECUTE] [NORMAL_CLEARING]

2021-09-03 11:34:56.614251 [INFO] mod_task.c:105 task_event_channel_hangup_complete, uuid=a34a67c3-2b8d-401f-a16f-1f5ec3e5169f, call_dir=inbound, task_str=task_app export variable

2021-09-03 11:34:56.614251 [NOTICE] switch_core_session.c:1744 Session 1 (sofia/external/10011@192.168.0.110) Ended

2021-09-03 11:34:56.614251 [NOTICE] switch_core_session.c:1748 Close Channel sofia/external/10011@192.168.0.110 [CS_DESTROY]

在日志中,可以看到“task_app_function start “的信息,同时也可以看到” task_event_channel_hangup_complete “的函数打印中”task_str=task_app export variable “的打印信息,验证了在呼叫中设置的自定义参数传递到挂机事件的后处理的过程

总结

freeswitch的event事件是整个架构体系中非常重要的一环,基础核心层通过event事件将所有呼叫相关的信息异步的通知到应用层,极大的方便了呼叫流程的业务开发。

其中的异步设计思想值得我们多多参考学习。


空空如常

求真得真

freeswitch的event事件处理的更多相关文章

  1. firefox 的event事件处理

    前几天,在用angularJs实现一个功能,点击后获取event的x,y坐标时,IE9, chrome下功能正常.但是firefox报event 未定义.初始代码如下: html: <div c ...

  2. js中event事件处理

    1. HTML事件  直接添加到HTML结构中 function show() { alert('hello'); } <body> <button id="btn&quo ...

  3. 15.深入k8s:Event事件处理及其源码分析

    转载请声明出处哦~,本篇文章发布于luozhiyun的博客:https://www.luozhiyun.com 源码版本是1.19 概述 k8s的Event事件是一种资源对象,用于展示集群内发生的情况 ...

  4. jQuery和ExtJS的timeOut超时问题和event事件处理问题

    对jQuery来说,超时可以直接设置timeout参数,并在error事件中捕获第二个参数,如果是“timeout”则表明捕获了超时事件,非常清楚. 例子: $.ajax({         type ...

  5. Yii2的深入学习--事件Event

    我们先来看下事件在 Yii2 中的使用,如下内容摘自 Yii2中文文档 事件可以将自定义代码“注入”到现有代码中的特定执行点.附加自定义代码到某个事件,当这个事件被触发时,这些代码就会自动执行.例如, ...

  6. React使用笔记(3)-React Event Listener

    Date: 2015-11-28 12:18 Category: Web Tags: JavaScript Author: 刘理想 [toc] 1. 构造基本结构 首先,我们先创建一个按钮,一个输入框 ...

  7. Android学习笔记-事件处理

    第三章 Android的事件处理 Android提供两种事件处理方式,基于回调和基于监听器.前者常用于传统图形界面编程中,而后者在AWT/Swing开发中常用. 3.1 事件处理概述 对于基于回调的事 ...

  8. Freeswitch 入门

    让我们从最初的运行开始,一步一步进入 FreeSWITCH 的神秘世界. 命令行参数 一般来说,FreeSWITCH 不需要任何命令行参数就可以启动,但在某些情况下,你需要以一些特殊的参数启动.在此, ...

  9. go语言使用go-sciter创建桌面应用(六) Element元素操作和Event事件响应

    详细的文档请看下面两个链接: https://sciter.com/docs/content/sciter/Element.htm https://sciter.com/docs/content/sc ...

随机推荐

  1. (Opencv4)二值化图像

    (Opencv4)二值化图像  ret, dst = cv2.threshold(src, thresh, maxval, type) threshold : 极限,临界值,阈值 ret: 一个数 s ...

  2. Android内存溢出、内存泄漏常见案例及最佳实践总结

    内存溢出是Android开发中一个老大难的问题,相关的知识点比较繁杂,绝大部分的开发者都零零星星知道一些,但难以全面.本篇文档会尽量从广度和深度两个方面进行整理,帮助大家梳理这方面的知识点(基于Jav ...

  3. Unix 网络IO模型介绍

    带着问题阅读 1.什么是同步异步.阻塞非阻塞 2.有几种IO模型,不同模型之间有什么区别 3.不同IO模型的应用场景都是什么 同步和异步.阻塞和非阻塞 同步和异步 广义上讲同步异步描述的是事件中发送方 ...

  4. AlarmManager定时提醒的那些坑

    https://blog.csdn.net/zackratos/article/details/53243595 https://blog.csdn.net/bingshushu/article/de ...

  5. Linux命令(二)之克隆虚拟机及修改网卡信息

    .subTitle { background: rgba(51, 153, 0, 0.66); border-bottom: 1px solid rgba(0, 102, 0, 1); border- ...

  6. Linux进程理解与实践(一)基本概念和编程概述(fork,vfork,cow)

    进程 and 程序 什么是程序? 程序是完成特定任务的一系列指令集合. 什么是进程? [1]从用户的角度来看:进程是程序的一次执行过程 [2]从操作系统的核心来看:进程是操作系统分配的内存.CPU时间 ...

  7. The Apache Tomcat Native library which allows using OpenSSL was not found on the java.library.path 问题解决记录

    1.问题 启动Tomcat之后,在浏览器输入IP后显示503,查看catalina.log发现报错: 2.问题定位:缺少 tomcat-native library 就是说 缺少Tomcat Nati ...

  8. SpringBoot开发六-发送邮件

    需求介绍-发送邮件 首先要进行邮箱设置,要启用客户端SMTP服务. 而且SpringBoot也给了JavaMailSender发送邮件. 代码实现 首先你需要设置好邮箱,步骤百度一大堆,记住要配置一个 ...

  9. linux联网、远程

    使用VMware虚拟机创建linux系统CentOS 7,连接网络以及远程Moba工具. 一.首先安装好VMware虚拟机和CentOS系统,网上很多教程,不在赘述. 二.打开VMware进行配置 1 ...

  10. ☕【Java技术指南】「并发原理专题」AQS的技术体系之CLH、MCS锁的原理及实现

    背景 SMP(Symmetric Multi-Processor) 对称多处理器结构,它是相对非对称多处理技术而言的.应用十分广泛的并行技术. 在这种架构中,一台计算机由多个CPU组成,并共享内存和其 ...