freeswitch实战三（eventSocket）

最新推荐文章于 2024-06-23 09:34:37 发布
最新推荐文章于 2024-06-23 09:34:37 发布
阅读量1.9k 收藏 6
点赞数 1
分类专栏： freeswitch 文章标签： 网络通信
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/MMsmileNN/article/details/118147532
版权

event socket创建过程

usr/local/freeswitch/bin/freeswitch 运行freeswitch

/media/sf_share/freeswitch-1.6.20 文件安装目录

外连

1. nc -l -k localhost 8040 启动监听 
2. nc localhost 8040 开启终端监听
3. ctrl+c退出B终端，电话拨打1234，链接到8040，
4. 回到A终端输入connect然后打两下回车，会出现
    Event-Name: CHANNEL_DATA
    Core-UUID: 5ed01200-5c09-11e9-8ae3-6733192b29d4
    ...
5. 测试播放一段音乐
    sendmsg
    call-command:execute
    execute-app-name:playback
    execute-app-arg:local_stream://moh
6. 结束，把上面得playback改为hangup再发一遍，电话就挂断了

内连

freeswitch启动后会启动一个ecventsocket tcp server，ip，端口和密码都可以在conf/autoloadconfigs/eventsocket.conf.xml 中配置

1. 使用nc localhost 8021链接freeswitch，会出现
    Content-Type: auth/request
2. 输入 “auth ClueCon”按两下回车，显示以下表示成功
    Content-Type: command/reply
    Reply-Text: +OK accepted
3. 可以使用命令控制freeswitch
    1. api version 查看freeswitch版本
    2. api status   查看状态
    3. api sofia status 查看sofia状态
    4. event plain ALL订阅所有事件
    5. 订阅某一个事件
        event plain <事件名称>
        event plain CHANNEL_CREATE

event socket命令

1. auth <密码> 第一个需要发送得命令，用于向freeswitch认证，例： auth ClueCon
2. api <command> <args> 其中command和args分别是freeswitch实际得命令和参数
3. bgapi <command> <args> api执行时间比较长，有一段时间会得不到响应，可以使用bgapi将命令放到后面执行；
    1. 会建立一个任务（job），并返回job-UUID；
    2. 执行完成后fs会产生一个BACKGROUND_JOB事件，事件中带了job-UUID和命令执行结果
    3. fs允许自己提供job-UUID(要保证全局唯一)

4. linger和nolinger
    1. 当channel挂断时，fs会断开与socket得连接，可能有一些channel相关得事件还没有发送过去避免这种“丢失”事件，tcp server告诉fs在断开之后逗留（“linger”）一段时间，等待把所有事件发完
        linger <seconds> 延时10秒 linger 10
    2. linger开启后悔了，使用nolinger命令撤销，没有参数
5. event [type] <events> 
    1. event用于订阅事件，type(时间类型)有plain、json、xml三种，默认plain（纯文本）
    2. events可以指定事件得名字，ALL表示订阅全部事件，事件之间用空格隔开
    3. 订阅CUSTOM事件(自定义事件)，它具体的类型是在Subclass中指定得，如指定订阅Subclass为"sofia::register"事件：
        1. event plain CUSTOM sofia::register
        2. 可以一次订阅多个 
        event plain CUSTOM sofia::register sofia::unregister
        3. 使用多个event命令混合订阅
        event plain CHANNEL_ANSWER CUSTOM sofia::register sofia::unregister
        4. 参数中一旦出现CUSTOM后面就不能跟普通得事件类型了
        5. CUSTOM事件只能逐一订阅，不能使用ALL
        6. HEARTBEAT是一个特殊事件，每20秒产生一次，用于回报fs得当前状态，当20秒没有收到fs事件，可以认为网络或fs异常
6. myevents
    1. 主要用于outbound模式，在outbound模式中，外部得TCP server可以通过myevents订阅与该channel相关得所有事件
    2. 使用格式myevents <type><UUID>
        myevents
        myevents json
        myevents xml
        myevents 289dwd-af35-47de-9a58-754191454d0d2
7. divert_events
    1. 作为InputCallback产生的，当channel通过setInputCallback()函数安装了相关的回调函数并遇到某些事件，如收到用户按键（DTMF）或语音识别的结果（DETECTED_SPEECH）,产生InputCallback时间，默认是在嵌入式脚本的回调函数捕捉，通过使用diver_events,可以将这些时间转发到Event Socket，外部程序中也能收到相关事件
8. filter
    1. filter用于安装一个过滤器，只做“虑入”，把符合条件的过滤进来，可以同时使用多个过滤器
    2. 格式：filter <EventHeader> <ValueToFilter>
    3. 例如：订阅所有事件，只接受匹配主叫号码1001事件
        event plain all
        event filter Caller-Caller-ID-Name 1001
    4. 取消过滤器
        先接受三个过滤器
        event plain all
        filter Unique-id uuid1
        filter Unique-id uuid2
        filter Unique-id uuid3

        filter delete  取消所有的过滤器
        filter delete Unique-ID uuid2  取消与uuid2相关的过滤器liru
9. nixevent与noevent
    1. nixevent与event相反，是取消订阅事件
        nixevent CHANNEL_CREATE
        nixevent all
    2. noevent相当于“nixevent all”取消所有event订阅
10. log订阅日志
    1. 格式：log <level>
        1. level包含(数目越高越详细)：
            0-CONSOLE
            1-ALERT
            2-CRIT
            3-ERR
            4-WARNING
            5-NOTICE
            6-INFO
            7-DEBUG
    2. log info 或 log 6
11. nolog log的反义词，关闭使用log命令订阅的日志
12. exit 告诉fs关闭socket连接
13. sendevent
    1. 通过sendevent可以向fs的事件系统发送事件
    2. 格式：sendevent <event-name>
        例如发送MESSAGE消息
        sendevent SEND_MESSAGE
        profile: internal
        user: 1002
        host: 192.168.0.126
        content-type: text/plain
        content-length: 10
        hello 1002

使用ESL开发

创建独立的ESL应用

1.创建目录和分离esl源文件
    1. 创建一个myesl目录，然后创建一个myesl.c的文件。
    2. 直接把fs源码目录下的testclient.c中的内容原样复制过来。
    3. 将/usr/local/freeswitch/lib目录下的libesl.a 拷贝到源码/media/sf_share/freeswitch-1.6.20/libs/esl目录下
    4. 创建一个MakeFile文件，保存在myesl.c相同的目录，内容如下
        ESLPATH = /media/sf_share/freeswitch-1.6.20/libs/esl
        CFLAGS  = -I$(ESLPATH)/src/include
        LIBESL  = $(ESLPATH)/.libs/libesl.a
        #LIBESL  = $(ESLPATH)/libesl.a

        all: myesl charge acd
        myesl: myesl.c
             gcc $(CFLAGS) -o myesl myesl.c $(LIBESL) -ldl -lm -lpthread
    4. 然后make编译生成myesl运行文件，然后执行
        1. make myesl.c 编译
        2. ./myesl      执行
2.在https://github.com/seven1240/myesl中有ESL书写的案例
    1. ESL空中充值服务charge.c
    2. acd呼叫中心  acd.c
    3. inbuound模式实现IVR  icharge.c
    步骤：
        1. 编辑charge.c等案例文件，在main函数中设置连接的地址为：“127.0.0.1”，端口号为8021。
        2. 修改Makefeile如下
            ESLPATH = /media/sf_share/freeswitch-1.6.20/libs/esl
            CFLAGS  = -I$(ESLPATH)/src/include
            LIBESL  = $(ESLPATH)/.libs/libesl.a

            all: myesl charge acd
                myesl: myesl.c
                gcc $(CFLAGS) -o myesl myesl.c $(LIBESL) -ldl -lm -lpthread
            charge: charge.c
                gcc $(CFLAGS) -o charge charge.c $(LIBESL) -ldl -lm -lpthread 
            acd: acd.c
                gcc $(CFLAGS) -o acd acd.c $(LIBESL) -ldl -lm -lpthread
        3. 在myesl目录下make编译，会执行all后面的所有的.c文件，生成对应的可执行文件
        4. 配置freeswitch设置连接
            1. vi ../autoload_configs/event_socket.conf.xml
            2. 默认的监听地址配置
            <param name="listen-ip" value="192.168.0.126"/>
            3. 去掉下面的注释
            <!-- <param name="apply-inbound-acl" value="lan"/> -->
            4. freeswitch中重启mod_event_socket模块
            5. diaplan中添加socket
              <!--eventsockt外连配置-->
              <extension name="socket">
                 <condition field="destination_number" expression="^12345$">
                    <action application="socket" data="127.0.0.1:8040 async full"/>
                 </condition>
             </extension>
        5. 执行可执行文件，设置监听
        6. 手机拨打12345建立连接，执行esl内部操作
3.java  esl_client的使用配置
    下载地址：https://github.com/esl-client/esl-client
    1. 下载项目到本地
    2. 复制项目的src文件到IntelliJ Idea的gradle项目目录下
    3. 修改idea的sources->language level选择8
    4. IDEA Error:java: Compilation failed: internal java compiler error错误解决办法：
    File-->Setting...-->Build,Execution,Deployment-->Compiler-->Java Compiler 设置相应Module的target bytecode version的合适版本（跟你jkd版本一致）
    5. 运行文件main函数，注意连接地址为freeswitch地址（192.168.0.1）
MMsmileNN
关注
  • 1
    点赞
  • 踩
  • 6
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
freeswitch 事件与变量关系对照表
sinat_33384251的博客
04-05 2274
CHANNEL_PROGRESS== CHANNEL_ANSWER== CALL_UPDATE== CHANNEL_EXECUTE== CHANNEL_HANGUP== CHANNEL_EXECUTE_COMPLETE== CHANNEL_HANGUP_COMPLETE 有自定义变量的事件 CHANNEL_CALLSTATE=== CHANNEL_STATE=== CHANNEL_STATE...
freeswitch-eventsocket:这是一个正在进行的抽象类，用于处理 freeswitch 的 eventsocket 命令行
06-13
自由切换事件套接字这是一个正在进行的抽象类，用于处理 freeswitch 的 eventsocket 命令行。 目前只实现了入站服务器。安装..代码块:: bash pip 安装 freeswitch-eventsocketTornado 的 IOLoop 下的实现下面是下的...
Freeswitch订阅CUSTOM事件的问题
okhelp的专栏
08-18 5275
之前一直是esl_event(&handle,ESL_EVENT_TYPE_PLAIN,"ALL")  由于压力过大，程序经常崩溃，于是将各种事件分开订阅处理。 其他CHANNEL事件都可以正常接收，但是CUSTOM接收不到，测试了好久，才找到问题 原本订阅CUSTOM事件，只要这么写就ok，esl_event(&handle,ESL_EVENT_TYPE_PLAIN
freeswitch学习笔记:将电话路由到Lua脚本
irizhao的专栏
03-20 4859
在快速测试的情况下，可以直接使用如下的originate命令在FreeSWITCH中外呼一路通话，并在电话的本端执 行Lua脚本： originate user/1000 &lua(test.lua) 其中，lua是一个App，它的参数就是脚本的名字，脚本的默认路径在安装路径的scripts目录下，当然你也可 以指定一个绝对路径，如/tmp/test.lua。 在Dialplan XML...
探索FreeSWITCH与Go的无缝对接：eventsocket项目推荐
最新发布
gitblog_00028的博客
06-23 664
探索FreeSWITCH与Go的无缝对接：eventsocket项目推荐 项目地址:https://gitcode.com/fiorix/go-eventsocket 在当今快速发展的通信技术领域，高效且灵活的通信解决方案是不可或缺的。今天，我们要探讨的是一个名为eventsocket的开源项目，它巧妙地将FreeSWITCH强大的事件处理能力与简洁高效的Go语言相结合，为开发者打开了一扇新的大门...
FreeSWITCH学习笔记：EventSocket
zy08403的专栏
11-23 370
执行API命令。阻塞。 1 auth 内连模式下身份验证。需要第一个发送。 1 bgapi 后台执行API命令。不阻塞。 1 2 返回带有Job-UUID。当API命令执行完成后会产生一个BACKGROUND_JOB事件。外连模式下接收FreeSWITCH的连接。需要第一个发送。 1 divert_events 开启/关闭将InputCallback产生的事件转发到Event Socket。 1 ev
FreeSwitch LUA API ——API Sessions
热门推荐
oba没有马
07-12 1万+
FreeSwitch LUA API中API Sessions的详细中文说明
FreeSWITCH —— 常用指令
maque0312的技术博客
03-20 2896
1、console loglevel 0-7的数字 —— 设置显示在界面上的日志（级别从0-7，级别越高，日志越大。1、global_getvar 变量名 —— 查看系统加载变量 （或者常用指令：eval ${base_dir} 、eval ${local_ip_v4} —— 查看这些变量的值）具体操作指令，参考10.2.2。1、eval ${base_dir} —— 获取系统自动设置的变量（全局）的值 （两个 $ 也行）4、show channels —— 显示当前的通话（包括通话的uuid）
FreeSWITCH中的lua简介
AI_wx_3307623172的博客
04-01 2018
FreeSWITCH默认使用使用XML Dialplan配置各种呼叫流程，但是功能相对有限，为此Freeswitch通过嵌入其他语言（如Lua、JavaScript、Python、Perl、Java等）解析器扩展其功能。 Lua模块默认是自动加载（Lua5.2），文档全面且其本身轻量，所以是最佳的选择。 Lua环境中，Freeswitch自动生成一个session对象。默认情况下，Lua执行完成后会自动挂断电话，如果想在执行完成后继续通话，需要在Lua中调用session:setAutoHangup(fal
FreeSwitch的event_socket模块分析
06-03
通过深入理解mod_event_socket模块，开发者可以更灵活地控制FreeSwitch的行为，实现远程管理、自动化脚本、集成第三方服务等多种功能。同时，通过细致的ACL配置，可以确保系统的安全性和稳定性。
FreeSWITCH实战.rar
05-08
4. **实时控制**：通过Event Socket Interface（ESL）可以实现对FreeSWITCH的实时控制，允许用户在运行时动态调整系统设置。 5. **多媒体处理**：内置音频和视频编解码器，如G.711、Opus、VP8等，确保高质量的语音...
FreeSWITCH VoIP 实战
10-11
第一章 PSTN 与 VoIP 第二章 初识 FreeSWITCH 第三章 PSTN 与 PBX 服务 第四章 SIP 协议 第五章 FreeSWITCH 架构 第六章 运 行 FreeSWITCH 第七章 SIP 模块 - mod_...Event SocketFreeSWITCH 实战
eventsocket:FreeSWITCH事件套接字的扭曲协议
05-26
eventsocket是FreeSWITCH的事件套接字的扭曲协议。 该协议在单个文件类中同时支持事件套接字的入站和出站方法。 它可以用于各种各样的目的。 它的目标是简单和可扩展，并将FreeSWITCH的所有功能导出到基于Twisted的...
NIO:channel、buffer、状态变量、socket、charset
五山口老法师
01-15 2331
在开始之前 关于本教程 新的输入/输出 (NIO) 库是在 JDK 1.4 中引入的。NIO 弥补了原来的 I/O 的不足，它在标准 Java 代码中提供了高速的、面向块的 I/O。通过定义包含数据的类，以及通过以块的形式处理这些数据，NIO 不用使用本机代码就可以利用低级优化，这是原来的 I/O 包所无法做到的。 在本教程中，我们将讨论 NIO 库的几乎所有方面，从高级的概念性内容到底层的...
Freeswitch内核之事件类型说明
u012231702的博客
04-05 2072
Freeswitch内核之事件类型 事件说明 3 Channel events信道事件。 3.1 Channel states信道状态。 3.2 CHANNEL_CALLSTATE信道呼叫状态事件。 3.3 CHANNEL_CREATE创建事件。 3.4 CHANNEL_DESTROY销毁事件。 3.5 CHANNEL_STATE呼叫状态事件。当一个信道切换通话状态时发送。此事件并...
FreeSWITCH使用说明
weixin_33769125的博客
06-29 572
第二章 FreeSWITCH 初步 什么是 FreeSWITCH ？ FreeSWITCH 是一个开源的电话交换平台，它具有很强的可伸缩性--从一个简单的软电话客户端到运营商级的软交换设备几乎无所不能。能原生地运行于Windows、 Max OS X、Linux、BSD 及 solaris 等诸多32/64位平台。可以用作一个简单的交换引擎、一个PBX，一个媒体网...
第十一章 ESL-通过事件控制FreeSWITCH
至虛極，守靜篤
09-26 1万+
通过事件提供的最底层控制机制，允许我们有效地利用工具箱，适时选择使用其中的单个工具。FreeSWITCH是一个核心交换与混合矩阵，它周围有几十个模块提供各种功能特性。 我们完全控制了所有的即时信息，这些信息组成了所有进出FreeSWITCH的通信包。同时，我们可以在适当的时候调用任何模块中的每个功能。 充分的知识和完全的控制允许我们根据项目的最小...
Freeswitch 异步事件类型
zy08403的专栏
11-30 935
Only shows the list of events, but this list is already in Event List, and that page is also more up to date. (Diffed the two lists, and they're identical.)Events comes in many "types" or "classes". You can filter on Event type so you get only a subset of
FreeSWITCH 1.10.9 顶顶通专用版发布了
FreeSWITCH二次开发-CTI接口
03-14 1022
经常有用户反馈FreeSWITCH 高并发下，10天半个月的就会崩溃一次，我让用户开coredump,看了一下崩溃时的调用堆栈，不是我程序的问题，FS的bug导致的，也只是偶发现象，我就懒得分析了。我经过2小时的仔细分析，发现了这个影响很大，存在很久的bug，为了让购买了smartivr 正版授权的用户 ，方便升级，特意花费2天时间打包一个编译好的 fs 1.10.9 程序包。下载的程序包的bin目录和lib目录mod目录替换到 /usr/local/freeswitch ，然后重启fs就可以了。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值