沉舟侧畔千帆进,病树前头万木春。这篇文章主要讲述技术分享| Sip与WebRTC互通-SRProxy开源库讲解相关的知识,希望能为你提供帮助。
SRProxy 介绍目前 WebRTC 协议跟 SIP 协议互通场景主要运用在企业呼叫中心、企业内部通信、电话会议(PSTN)、智能门禁等场景,要想让 WebRTC 与 SIP 互通,要解决两个层面的问题:信令层和媒体层。两个网络使用的信令机制不同,所以要进行信令的转换,才能完成媒体的协商,建立会话;媒体层要完成编码的转换,以及 rtp/srtp 转换等功能。anyRTC 开源 SRProxy 网关,解决了 WebRTC 与 SIP 的协议转换,配合 anyRTC 开源的 ARCall 音视频呼叫 demo,演示如何通过 App/Web 端呼叫落地,下文就如何使用部署 SRProxy 网关,以及如何跟 ARCall 互通进行展开,熟悉如何使用后,可集成 SDK 到自己的应用中,配合自身业务做对应的场景。
呼叫流程
一、ARCall 呼叫逻辑
文章图片
文章图片
二、SRProxy 转发逻辑
1、SRProxy 能做什么?
文章图片
从上图简单概括一下:SRProxy 是实现 RTC 和 SIP 之间业务互通的桥梁,更是实现业务拓展的关键服务。
2、ARCall 呼叫流程 1)状态流转图呼叫邀请中,主叫可以通过 [LocalInvitation] 对象提供的 [getState] 方法查询当前呼叫邀请的有关状态;被叫可以通过 SDK 返回的 [RemoteInvitation]对象的 [getState]方法查询当前呼叫邀请的相关状态。
LocalInvitationState
下图描述了与主叫相关的呼叫邀请状态流转图:
文章图片
RemoteInvitationState
下图描述了与被叫相关的呼叫邀请状态流转图:
文章图片
2)API 时序图取消已发送呼叫邀请
文章图片
【技术分享| Sip与WebRTC互通-SRProxy开源库讲解】接受/拒绝呼叫邀请
文章图片
注意事项及限制条件
- 主叫设置的呼叫邀请 content 的字符串长度:8 KB,格式为 UTF-8。
- 被叫设置的呼叫邀请响应 response 的字符串长度:8 KB,格式为 UTF-8。
- 呼叫邀请的 channelId 仅用于与信令互通时设置。设置的 channelId 必须与信令 SDK 设置相同才能实现互通。字符串长度:64 字节,格式为 UTF-8。
文章图片
二、创建应用获取 AppId
文章图片
部署 freeswitch 一、准备
一、系统
二、防火墙
# 开放sip端口tcp协议
[root@localhost ~]# firewall-cmd --permanent --add-port=5060/tcp
# 开放sip端口udp协议
[root@localhost ~]# firewall-cmd --permanent --add-port=5060/udp
# 开放ws端口
[root@localhost ~]# firewall-cmd --permanent --add-port=5066/tcp
# 开放wss端口
[root@localhost ~]# firewall-cmd --permanent --add-port=7443/tcp
# 开放rtp端口(范围)
[root@localhost ~]# firewall-cmd --permanent --add-port=16384-32768/udp
# 让防火墙配置生效
[root@localhost ~]# firewall-cmd --reload# 也可以直接关闭防火墙
[root@localhost ~]# systemctl stop firewalld
[root@localhost ~]# systemctl disable firewalld
二、编译环境和 FreeSwitch 依赖库
# 更新yum源
[root@localhost ~]# yum update -y# 安装lib相关需求依赖
[root@localhost ~]# yum install -y yum-utils git gcc gcc-c++ automake autoconf libtool libtiff-devel libjpeg-devel openssl-devel vim# 添加环境变量
[root@localhost ~]# vim /etc/profile
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
[root@localhost ~]# source /etc/profile# 单独下载spandsp源码
[root@localhost ~]# cd /usr/local/src
[root@localhost src]# git clone https://github.com/freeswitch/spandsp.git
[root@localhost src]# cd spandsp
[root@localhost spandsp]# ./bootstrap.sh
[root@localhost spandsp]# ./configure
[root@localhost spandsp]# make
[root@localhost spandsp]# make install
[root@localhost spandsp]# ldconfig# 单独下载sofia-sip(SIP协议栈)源码尝试使用过码云上面的,但是freeswitch编译的时候一直报错需要sofia-sip
[root@localhost ~]# cd /usr/local/src
[root@localhost src]# git clone https://github.com/freeswitch/sofia-sip.git
[root@localhost src]# cd sofia-sip
[root@localhost sofia-sip]# ./bootstrap.sh -j
[root@localhost sofia-sip]# ./configure
[root@localhost sofia-sip]# make
[root@localhost sofia-sip]# make install
[root@localhost sofia-sip]# ldconfig# 单独下载libuuid源码
[root@localhost ~]# cd /usr/local/src
[root@localhost src]# wget https://jaist.dl.sourceforge.net/project/libuuid/libuuid-1.0.3.tar.gz
[root@localhost src]# tar -zxvf libuuid-1.0.3.tar.gz
[root@localhost src]# cd libuuid-1.0.3
[root@localhost libuuid-1.0.3]#./configure
[root@localhost libuuid-1.0.3]#make
[root@localhost libuuid-1.0.3]#make install# 编译安装cmake 3.8.2
[root@localhost ~]# cd /usr/local/src
[root@localhost src]# wget https://cmake.org/files/v3.8/cmake-3.8.2.tar.gz
[root@localhost src]# tar zxvf cmake-3.8.2.tar.gz
[root@localhost cmake]# cd cmake-3.8.2
[root@localhost cmake-3.8.2]# ./bootstrap
[root@localhost cmake-3.8.2]# gmake
[root@localhost cmake-3.8.2]# gmake install# 安装libatomic
[root@localhost ~]# yum install -y libatomic# 单独下载libks源码(需要cmake 3.7.2以上版本)
[root@localhost ~]# cd /usr/local/src
[root@localhost src]# git clone https://github.com/signalwire/libks.git
[root@localhost libks]# cmake .
## 如果出现uuid错误,就重新编译libuuid源码,还是uuid错误就退出终端重新进入在执行cmake .
[root@localhost libks]# make
[root@localhost libks]# make install# 安装fs依赖
[root@localhost ~]# yum install -y http://files.freeswitch.org/freeswitch-release-1-6.noarch.rpm epel-release# 安装ffmpeg需要
[root@localhost ~]# rpm --import http://li.nux.ro/download/nux/RPM-GPG-KEY-nux.ro
[root@localhost ~]# rpm -Uvh http://li.nux.ro/download/nux/dextop/el7/x86_64/nux-dextop-release-0-1.el7.nux.noarch.rpm# yum安装相关依赖
[root@localhost ~]# yum install -y alsa-lib-devel bison broadvoice-devel bzip2 curl-devel libdb4-devel e2fsprogs-devel erlang flite-devel g722_1-devel gdbm-devel gnutls-devel ilbc2-devel ldns-devel libcodec2-devel libcurl-devel libedit-devel libidn-devel libmemcached-devel libogg-devel libsilk-devel libsndfile-devel libtheora-devel libuuid-devel libvorbis-devel libxml2-devel lua-devel lzo-devel ncurses-devel net-snmp-devel opus-devel pcre-devel perl perl-ExtUtils-Embed pkgconfig portaudio-devel postgresql-devel python-devel python-devel soundtouch-devel speex-devel sqlite-devel unbound-devel unixODBC-devel which yasm zlib-devel libshout-devel libmpg123-devel lame-devel rpm-build libX11-devel libyuv-devel swig wget ffmpeg ffmpeg-devel# 安装python组件
[root@localhost ~]# curl https://bootstrap.pypa.io/pip/2.7/get-pip.py --output get-pip-2.7.py
[root@localhost ~]# python get-pip-2.7.py# 验证pip是否安装成功
[root@localhost ~]# pip --version# pip安装python组件
[root@localhost ~]# pip install pydub python-ESL pika dbutils
三、安装FreeSwitch
# git下载freeswitch
[root@localhost ~]# git clone -b v1.10 https://github.com/signalwire/freeswitch.git freeswitch
# 如果github连接不顺畅的话,可以试试码云镜像仓库(更新慢1天)
[root@localhost ~]# git clone -b v1.10 https://gitee.com/mirrors/FreeSWITCH.git freeswitch# 编译安装freeswitch前奏
[root@localhost ~]# cd freeswitch
[root@localhost freeswitch]# ./bootstrap.sh -j
[root@localhost freeswitch]# vim modules.conf
根据需要打开或关闭注释
formats/mod_shout
languages/mod_python
#event_handlers/mod_cdr_pg_csv
asr_tts/mod_unimrcp
endpoints/mod_rtmp
如果需要使用mod_xml_curl的话
xml_int/mod_xml_curl
给不需要的模块加上注释
#applications/mod_av
#applications/mod_signalwire
编译安装
[root@localhost freeswitch]# ./configure --with-python=/usr/bin/python2.7 --with-lua=/usr/bin/lua --enable-core-pgsql-support# 如果在spandsp位置报错,可以尝试执行下面这句 在执行./configure
[root@localhost freeswitch]# export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig# 编译freeswitch
[root@localhost freeswitch]# make# 编译安装 mod_cdr_pg_csv-install
[root@localhost freeswitch]# make mod_unimrcp-install# 如果需要空上模块的话
[root@localhost freeswitch]# make mod_xml_curl-install# 编译安装音频文件(英文)
[root@localhost freeswitch]# make cd-sounds-install
[root@localhost freeswitch]# make cd-moh-install# 编译安装freeswitch
[root@localhost freeswitch]# make install
额外安装音频文件(英文)
[root@localhost freeswitch]# make uhd-sounds-install
[root@localhost freeswitch]# make uhd-moh-install
[root@localhost freeswitch]# make hd-sounds-install
[root@localhost freeswitch]# make hd-moh-install
[root@localhost freeswitch]# make sounds-install
[root@localhost freeswitch]# make moh-install
建立软连接
[root@localhost freeswitch]# sudo ln -sf /usr/local/freeswitch/bin/freeswitch /usr/local/bin/
[root@localhost freeswitch]# sudo ln -sf /usr/local/freeswitch/bin/fs_cli /usr/local/bin/
配置mod
[root@localhost ~]# vim /usr/local/freeswitch/conf/autoload_configs/modules.conf.xml
在前3行开启(位置可能不对,能找到)
<
load module="mod_console"/>
<
load module="mod_logfile"/>
<
load module="mod_xml_curl"/>
打开注释
<
load module="mod_python"/>
<
load module="mod_shout"/>
添加配置
<
load module="mod_cdr_pg_csv"/>
<
load module="mod_unimrcp"/>
<
!--<
load module="mod_vad"/>
-->
注释掉其他不需要的模块
<
!-- <
load module="mod_av"/>
-->
<
!-- <
load module="mod_signalwire"/>
-->
配置acl白名单
[root@localhost ~]# vim /usr/local/freeswitch/conf/autoload_configs/acl.conf.xml
<
!-- 根据自己网络的实际情况进行配置(照抄大概率无效) -->
<
list name="domains" default="deny">
<
!-- domain= is special it scans the domain from the directory to build t$ -->
<
node type="allow" domain="$${domain}"/>
<
!-- ==================这里添加 本机ip127.0.0.1 ======================== -->
<
!-- ==================这里添加 本机内网ip======================== -->
<
!-- ==================这里添加 本机外网ip======================== -->
<
!-- ==================这里添加 web内网ip192.168.1.221======================== -->
<
!-- ==================这里添加 web外网ip公网IP======================== -->
<
!-- ==================这里添加runcall内外网Ip======================== -->
<
node type="allow" cidr="192.168.1.0/24"/>
<
node type="allow" cidr="公网IP/32"/>
<
/list>
# 保存后,在freeswitch客户端,输入reloadacl reloadxml进行重新加载acl文件
[root@localhost ~]# fs_cli
freeswitch@localhost>
reloadacl reloadxml
配置ESL
[root@localhost ~]# vim /usr/local/freeswitch/conf/autoload_configs/event_socket.conf.xml
<
configuration name="event_socket.conf" description="Socket Client">
<
settings>
<
param name="nat-map" value="https://www.songbingjia.com/android/false"/>
<
!--ip 统一为0.0.0.0-->
<
param name="listen-ip" value="https://www.songbingjia.com/android/0.0.0.0"/>
<
!-- 端口号 默认8021 -->
<
param name="listen-port" value="https://www.songbingjia.com/android/8021"/>
<
!-- 密码统一Aicyber -->
<
param name="password" value="https://www.songbingjia.com/android/Aicyber"/>
<
!-- 允许acl白名单内的IP 访问 -->
<
param name="apply-inbound-acl" value="https://www.songbingjia.com/android/domains"/>
<
!--<
param name="apply-inbound-acl" value="https://www.songbingjia.com/android/loopback.auto"/>
-->
<
!--<
param name="stop-on-bind-error" value="https://www.songbingjia.com/android/true"/>
-->
<
/settings>
<
/configuration>
适配WebRTC(JSSIP/SIPJS)
[root@localhost ~]# vim /usr/local/freeswitch/conf/sip_profiles/internal.xml
<
param name="apply-candidate-acl" value="https://www.songbingjia.com/android/rfc1918.auto"/>
<
param name="apply-candidate-acl" value="https://www.songbingjia.com/android/localnet.auto"/>
<
param name="apply-candidate-acl" value="https://www.songbingjia.com/android/candidate"/>
<
!-- 取消注释这一行(让前端可以得到早期媒体) -->
<
param name="enable-100rel" value="https://www.songbingjia.com/android/true"/>
适配特定终端(以云翌通安卓SDK为例)
[root@localhost ~]# vim /usr/local/freeswitch/conf/sip_profiles/internal.xml
<
param name="user-agent-string" value="https://www.songbingjia.com/android/YunEasy"/>
拨号计划
[root@localhost ~]# vim /usr/local/freeswitch/conf/sip_profiles/internal.xml
<
!-- 默认是public -->
<
param name="context" value="https://www.songbingjia.com/android/default"/>
关闭ipv6
[root@localhost ~]# cd /usr/local/freeswitch/conf/sip_profiles
[root@localhost sip_profiles]# mv internal-ipv6.xml internal-ipv6.xml.removed
[root@localhost sip_profiles]# mv external-ipv6.xml external-ipv6.xml.removed
四:配置 Sip 的 Proxy 转发规则
<
extension name="group_dial_sip_proxy">
<
condition field="destination_number" expression="^0(.*)$">
<
action application="set">
<
![CDATA[sip_h_X-Number=<
sip:$1@${domain_name}>
]]>
<
/action>
<
action application="bridge" data="https://www.songbingjia.com/android/user/1000@192.168.x.xx"/>
<
/condition>
<
/extension>
五、FreeSwitch 呼叫时间修改
<
condition field="${default_password}" expression="^1234$" break="never">
<
action application="log" data="https://www.songbingjia.com/android/CRIT WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING"/>
<
action application="log" data="https://www.songbingjia.com/android/CRIT Open $${conf_dir}/vars.xml and change the default_password."/>
<
action application="log" data="https://www.songbingjia.com/android/CRIT Once changed type reloadxml at the console."/>
<
action application="log" data="https://www.songbingjia.com/android/CRIT WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING"/>
<
!--<
action application="sleep" data="https://www.songbingjia.com/android/10000"/>
-->
#注释这一行即可
<
/condition>
启动生效
六、FreeSwitch 显示主叫号码
<
include>
<
user id="1000">
<
params>
<
param name="password" value="https://www.songbingjia.com/android/$${default_password}"/>
<
param name="vm-password" value="https://www.songbingjia.com/android/1000"/>
<
/params>
<
variables>
<
variable name="toll_allow" value="https://www.songbingjia.com/android/domestic,international,local"/>
<
variable name="accountcode" value="https://www.songbingjia.com/android/1000"/>
<
variable name="user_context" value="https://www.songbingjia.com/android/default"/>
<
!--<
variable name="effective_caller_id_name" value="https://www.songbingjia.com/android/Extension 1000"/>
-->
# 注释
<
!--<
variable name="effective_caller_id_number" value="https://www.songbingjia.com/android/1000"/>
-->
# 注释这两行
<
variable name="outbound_caller_id_name" value="https://www.songbingjia.com/android/$${outbound_caller_name}"/>
<
variable name="outbound_caller_id_number" value="https://www.songbingjia.com/android/$${outbound_caller_id}"/>
<
variable name="callgroup" value="https://www.songbingjia.com/android/techsupport"/>
<
/variables>
<
/user>
<
/include>
启动生效
## 后台快速启动
[root@localhost ~]# freeswitch -nc -nonat## 控制台启动(退出即关闭服务)
[root@localhost ~]# freeswitch
七、FreeSwitch 自动增加号码
<
extension name="Local_Extension">
<
!--<
condition field="destination_number" expression="^(10[01][0-9])$">
-->
# 注释这一行 或者修改这一行
<
condition field="destination_number" expression="^(1[0-9][0-9][0-9]|20[0-9][0-9])$">
# 重新定义号码段 段为1000~2099
<
action application="export" data="https://www.songbingjia.com/android/dialed_extension=$1"/>
<
!-- bind_meta_app can have these args <
key>
[a|b|ab] [a|b|o|s] <
app>
-->
<
action application="bind_meta_app" data="https://www.songbingjia.com/android/1 b s execute_extension::dx XML features"/>
#!/bin/bash
# Author:lzy
# data:2021-11-16# 设置变量
# freeswitch存放号码目录
TARGET_FREESWITCH_PREFIX=/usr/local/freeswitch/conf/directory/default/
# 因为默认已经有1000-1019 所以设置从1020开始,可以随时改
i=1020# 设置循环,-le 小于等于2099结束
while [ $i -le 2599 ]
do
# i=$i+1$i=1020逐步往上+1
let i=$i+1
# cp 复制1000.xml 重命名$i 逐步+1
cp $TARGET_FREESWITCH_PREFIX/1000.xml$TARGET_FREESWITCH_PREFIX/$i.xml
# sed将1000.xml文件里面的1000 改为文件本身的数值
sed -i "s/1000/$i/" $TARGET_FREESWITCH_PREFIX/$i.xml
done
## 脚本授权 执行脚本
[root@localhost ~]# chmod +x freeswitch.sh
[root@localhost ~]# ./freeswitch.sh## 保存后,在freeswitch客户端,输入reloadxml进行重新加载.xml文件
[root@localhost ~]# fs_cli
freeswitch@localhost>
reloadxml
部署 SRProxy一、Windows 7 +
双击:SipRtcProxy.sln ,直接运行
项目是VS2017创建,VS2015,VS2019可自行验证。
二、Linux - Centos7.0 +
下载代码到本地
环境变量
[root@localhost SipRtcProxy]# vim/etc/profile
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/root/SipRtcProxy/so/
[root@localhost SipRtcProxy]# source /etc/profile
执行
配置文件
[global]
appid=XXXXX## 创建应用时注册的Appid
sip_svr=IP:5060## freeswitch_IP地址和端口,目前仅支持freeswitch默认端口## 配置私有云RTC环境 注释默认连接公网环境
#[rtc]
#ip=RTC_IP
#port=6080## 配置私有云RTM环境 注释默认连接公网环境
#[rtm]
#ip=RTM_IP
#port=7080[rtm2sip]
on=1## 是否开启RTM2SIP;
0:不开启1:开启
acc_rule=1005;
10[06-19]## 号码范围根据freeswitch进行调整;
号码情况:1005,1006-1019 共15个号码,同Appid下多个SRProxy 号码不能冲突[proxy]
on=1## 是否开启SIP代理;
0:不开启 1:开启
sip_account=1000## freeswitch代理账号:1000,客户端不可与此号码冲突;且一个SRProxy只能用一个号码,换个环境需换个号码,如:1001
sip_pwd=1234## freeswitch密码
rtm_account=1086## 登入RTM账号,客户端不可与此号码冲突,且一个appid只能用一个号码,换个环境需换个号码,如:1087[log]
#* 0:SENSITIVE 1:VERBOSE 2:INFO 3:WARNING 4:ERROR 5:NONE
level=2
file=rtc_sip.log
max_file_size=100
前台启动
三、Linux - Centos7.0 + 已编译
创建目录
将srproxy.tar.gz放到/usr/local/ar4/解压
将rtx.sh脚本放入/usr/bin下面并赋予权限
进入目录
[global]
appid=XXXXX## 创建应用时注册的Appid
sip_svr=IP:5060## freeswitch_IP地址和端口,目前仅支持freeswitch默认端口## 配置私有云RTC环境 注释默认连接公网环境
#[rtc]
#ip=RTC_IP
#port=6080## 配置私有云RTM环境 注释默认连接公网环境
#[rtm]
#ip=RTM_IP
#port=7080[rtm2sip]
on=1## 是否开启RTM2SIP;
0:不开启1:开启
acc_rule=1005;
10[06-19]## 号码范围根据freeswitch进行调整;
号码情况:1005,1006-1019 共15个号码,同Appid下多个SRProxy 号码不能冲突[proxy]
on=1## 是否开启SIP代理;
0:不开启 1:开启
sip_account=1000## freeswitch代理账号:1000,客户端不可与此号码冲突;且一个SRProxy只能用一个号码,换个环境需换个号码,如:1001
sip_pwd=1234## freeswitch密码
rtm_account=1086## 登入RTM账号,客户端不可与此号码冲突,且一个appid只能用一个号码,换个环境需换个号码,如:1087[log]
#* 0:SENSITIVE 1:VERBOSE 2:INFO 3:WARNING 4:ERROR 5:NONE
level=2
file=rtc_sip.log
max_file_size=100
配置没有问题后启动SRProxy
添加任务计划 实现自启动
Demo 演示 一、登入 ARCall(连接公网 RTC、RTM)
文章图片
二、登入 sip(模拟电话 连接 FreeSwitch)
文章图片
文章图片
三、ARCall 拨打 sip
文章图片
呼叫成功
文章图片
四、sip 拨打 ARCall
文章图片
呼叫成功
文章图片
文章图片
推荐阅读
- #yyds干货盘点#three.js中如何切换相机视角
- Redis持久化RDB和AOF优缺点,你都了解吗()
- 如何在WordPress中调用jquery.min.js文件
- 如何绕过主题编辑器块()
- 如何同时向标签添加多个CSS属性()
- 如何在自定义帖子中添加wordpress自定义seciton
- 在MAMP上工作时如何将图像添加到wordpress主题()
- 如何为WordPress主题添加自定义页眉和页脚
- 如何通过仪表板向页脚添加内容()