1 Star 0 Fork 28

chhc / freeswitch-esl-all

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
README.md 5.11 KB
一键复制 编辑 原始数据 按行查看 历史
zhouhailin 提交于 2021-03-06 14:18 . 新增: 沟通交流群, 二维码

FreeSWITCH ESL ALL

Codacy Badge Jdk Version License Maven Central Gitter

目标

1、支持连接FreeSWITCH大规模集群
2、更易于集成使用
4、与spring boot 2.3.x深度整合,提供 starter
5、可动态配置

模块说明

1.freeswitch-esl

freeswitch esl 客户端(详细信息,移步至子模块)

2.freeswitch-esl-example

基于 freeswitch-esl 客户端示例(详细信息,移步至子模块)

3.freeswitch-esl-spring-boot-starter

基于 Spring boot 2.3.x, freeswitch-esl 客户端(详细信息,移步至子模块)

application.properties

    link.thingscloud.freeswitch.esl.inbound.servers[0].host=127.0.0.1
    link.thingscloud.freeswitch.esl.inbound.servers[0].port=8021
    link.thingscloud.freeswitch.esl.inbound.servers[0].timeout-seconds=5
    link.thingscloud.freeswitch.esl.inbound.servers[0].password=ClueCon
    link.thingscloud.freeswitch.esl.inbound.servers[2].host=127.0.0.2
    link.thingscloud.freeswitch.esl.inbound.servers[2].port=8021
    link.thingscloud.freeswitch.esl.inbound.servers[2].timeout-seconds=5
    link.thingscloud.freeswitch.esl.inbound.events=CHANNEL_CREATE CHANNEL_DESTORY 
    # 开启性能监控 - 事件驱动-业务逻辑处理时间
    link.thingscloud.freeswitch.esl.inbound.performance=true 
    link.thingscloud.freeswitch.esl.inbound.performanceCostTime=200 
    # 开启事件性能监控 - fs产生事件与应用接收到事件时间差
    link.thingscloud.freeswitch.esl.inbound.eventPerformance=false 
    link.thingscloud.freeswitch.esl.inbound.eventPerformanceCostTime=200 


application.yml

    link:
      thingscloud:
        freeswitch:
          esl:
            inbound:
              defaultPassword: ClueCon
              performance: false
              performanceCostTime: 200
              servers:
                - host: 127.0.0.1
                  port: 8021
                  timeoutSeconds: 5
                - host: 127.0.0.2
                - host: 127.0.0.3
              events:
                - CHANNEL_CREATE
                - CHANNEL_DESTORY

4.freeswitch-esl-spring-boot-starter-example

基于 freeswitch-esl-spring-boot-starter 客户端示例(详细信息,移步至子模块)

特性说明

获取实例 
    InboundClient.getInstance()
    SpringBoot容器 : @Autowired inboundClient

可动态配置添加或删除远端地址
    添加远端地址
        a、inboundClient.option().addServerOption(new ServerOption(host, port));
        b、InboundClient.getInstance().option().addServerOption(new ServerOption(host, port));
    
    删除远端地址
        ServerOption serverOption = inboundClient.option().serverOptions().get(0);
        
        a、inboundClient.option().removeServerOption(serverOption);
        b、InboundClient.getInstance().option().removeServerOption(serverOption);
        
服务端连接监听器 ServerConnectionListener
    inboundClient.option().serverConnectionListener(serverConnectionListenerImpl);
        void onOpened(ServerOption serverOption);
        void onClosed(ServerOption serverOption);

配置动态获取或者删除  
    1、实现接口 InboundClientOptionHandler
    2、继承抽象类 AbstractInboundClientOptionHandler

使用须知

1、发送api建议采用异步操作,特别是originate命令
2、目前存在消息超时机制,应对服务端直接关机导致连接假死,设置readTimeoutSeconds参数值为0,可关闭此特性
3、为了提供性能,处理EslEvent时,使用Netty的Worker线程,如果处理逻辑涉及IO或者耗时操作,必须要将处理逻辑放在新线程里面处理,通过disablePublicExecutor参数设置

志同道合(微信) - 请备注来源

微信

License

Apache License, Version 2.0 Copyright (C) Apache Software Foundation

Java
1
https://gitee.com/yi2020/freeswitch-esl-all.git
git@gitee.com:yi2020/freeswitch-esl-all.git
yi2020
freeswitch-esl-all
freeswitch-esl-all
develop

搜索帮助