0.引言
Janus是?个开源的,通过 C 语?实现了对 WebRTC ?持的 Gateway;Janus ?身实现得很简单,提供插件机制来?持不同的业务逻辑,配合官??带插件就可以?来实现?效的 Media Server 服务。
Janus是匹配WebRtc开源的服务器项目,但是Janus的源码与WebRtc的源码是没有关系,只是遵循了一种协议,如rtp、sdp等,能够匹配webrtc的客户端的数据传输。
为了更好地理解本篇文章,可以参考前面的文章,文章列表如下:
1.Janus官方说明
Janus 官?地址:
https://janus.conf.meetecho.com/index.html
官?界面如下:
Janus 官方源码链接:
https://github.com/meetecho/janus-gateway
官?界面如下:
本文主要介绍如何在Ubuntu 18.04 下搭建起janus服务器,实现janus 官? Demo 浏览器与 AndroidAPP Demo(janus-gateway-android)之间的?视频通话,包括Web与Web,Web与Android之间的通话。浏览器打开?视频采集的话需要HTTPS加密访问。效果图如下:
2.公网服务器配置说明
拉取数据更快。
如果实时带宽调整到100M,如果被人攻击,这个损失是非常恐怖。
3.下载和编译 Janus
cd /home/qaa/share/webrtc/
mkdir janus
cd janus/
编译运? Janus Server 需要依赖较多的?些第三?库,?这些依赖库在 Ubuntu 下主要通过 aptitude进?安装,?先通过安装 aptitude:
sudo apt-get install aptitude
下载完成界面:
3.1 命令安装依赖
Ubuntu 下通过 aptitude 批量安装依赖?具包,这?建议 Ubuntu 镜像源(/etc/apt/source.list)不要为了追求速度?改?了国内的某些镜像源,如 ?易 163,这可能会导致某些?具包下载失败,建议依然使?官??带的镜像源。
(1)批量安装命令:
sudo aptitude install libmicrohttpd-dev libjansson-dev libnice-dev libssl1.0.1-dev libsrtp-dev libsofia-sip-ua-dev libglib2.3.4-dev libopus-dev libogg-dev libcurl4-openssl-dev pkg-config gengetopt libtool automake
也可以像如下命令一样,使用命令的分开下载。
sudo aptitude install libmicrohttpd-dev libjansson-dev libnice-dev
(2)其它工具安装:
sudo apt install cmake
sudo aptitude install libconfig-dev
sudo aptitude install libssl-dev
sudo aptitude install doxygen graphviz
# ffmpeg库 ?持--enable-post-processing
sudo aptitude install libavcodec-dev libavformat-dev libswscale-dev libavutil-dev
(3)如果出现某个?具包下载失败,请修改镜像源为官?地址(以更新镜像源,完成后重新安装。),并执?以下命令。
sudo apt-get update && sudo apt-get upgrade
下载完成界面:
sudo aptitude install libssl1.0.1-dev libsrtp-dev libsofia-sip-ua-dev libglib2.3.4-dev
下载完成界面:
(4)卸载命令
删除软件包?保留软件的配置?件,命令如下:
apt-get remove
同时清除软件包和软件的配置?件,命令如下:
apt-get purge
(5)查找包命令
查找软件包,命令如下:
apt-cache search 软件包名
显示软件包的详细信息
apt-cache show 软件包名
3.2 源码安装依赖
3.2.1 安装 WebSocket
janus ?持 WebSocket 是可选项,如果不安装,编译 janus 时,默认不?持 WebSocket 的链接请求,? Android APP Demo 是通过 WebSocket 与 janus 进?通信的,因为我们希望 Android APP Demo能与浏览器(HTTP)进?视频通话,所以就必须要在编译 janus 时?持 WebSocket。依次执?以下命令,分别进?下载,编译,安装:
(1)下载链接地址,如下:
git clone https://github.com/warmcat/libwebsockets.git
下载完成界面:
(2)切换版本
cd /home/qaa/share/webrtc/libwebsockets
git branch -a
这里就使用3.2版本。
git checkout v3.2-stable
切换成功,如下界面:
(3)创建编译目录
mkdir build
cd build
使用cmake编译命令:
cmake -DCMAKE_INSTALL_PREFIX:PATH=/usr -DCMAKE_C_FLAGS="-fpic" ..
安装完成界面如下:
(4)编译和安装
安装到系统的usr目录,命令如下:
make && sudo make install
注意:安装成功后,在编译 janus 时,janus 默认会增加对 WebSocket 的集成,或者通过增加编译参数 --enable-websockets 打开 WebSocket 开关。根据自己的需求,也可以--disable-websockets关闭WebSocket开关。
3.2.2 安装 libsrtp
Janus 需要?少 version 1.5 以上的 libsrtp,如果系统中已经安装了 libsrtp,则?先卸载后,?动安装新版本,这?我们安装 libsrtp 2.2,依次执?以下命令:
cd /home/qaa/share/webrtc/janus
(1)下载命令和地址
wget https://github.com/cisco/libsrtp/archive/v2.2.0.tar.gz
界面如下:
(2)解压命令
tar xfv v2.2.0.tar.gz
界面如下:
(3)进入目录
cd libsrtp-2.2.0/
ls
如下界面:
(4)配置
./configure --prefix=/usr --enable-openssl
成功界面,如下:
(5)编译命令:
make shared_library && sudo make install
编译安装成功界面:
3.2.3 安装libusrsctp
这个libusrsctp是基于udp去封装。libusrsctp?持--enable-data-channels。
(1)libusrsctp下载链接地址如下
git clone https://github.com/Kurento/libusrsctp.git
cd /home/qaa/share/webrtc/janus
下载成功界面:
(2)切换目录
cd libusrsctp
ls
如下界面:
(3)配置
./bootstrap
成功的界面:
./configure
成功的界面:
(4)编译
make
成功的界面:
(5)安装
sudo make install
成功的界面:
3.2.4 安装libmicrohttpd
libmicrohttpd?持--enable-rest
cd /home/qaa/share/webrtc/janus
(1)libmicrohttpd下载地址
wget https://ftp.gnu.org/gnu/libmicrohttpd/libmicrohttpd-0.9.71.tar.gz
下载成功的界面:
(2)解压
tar zxf libmicrohttpd-0.9.71.tar.gz
cd libmicrohttpd-0.9.71/
成功的界面:
(3)配置
./configure
成功的界面:
(4)编译
make
成功的界面:
(5)安装
sudo make install
成功的界面:
3.3 编译 Janus
通过 Git 下载 Janus 源码,并编译安装:
(1)Janus下载地址:
git clone https://github.com/meetecho/janus-gateway.git
成功的界面:
cd /home/qaa/share/webrtc/janus/janus-gateway
(2)查看最新tag
git tag
目录如下:
这里使用相对稳定版本v0.10.4。如下:
git checkout v0.10.4
成功的界面:
(3)执行脚本:
sh autogen.sh
成功的界面:
(4)配置
./configure --prefix=/opt/janus --enable-websockets --enable-post-processing --enable-docs --enable-rest --enable-data-channels
成功的界面如下:
可以看到生成的一些组件,如下:
这些组件中,Video Room很重要。
(5)如果出现如下错误,如果没有这些错误,可以跳过该步骤:
缺少libconfig。
执行如下命令:
sudo aptitude install libconfig-dev
如果出现如下错误:
sudo aptitude install doxygen graphviz
并做如下修改:
没修改之前上面的红框是1.8.11,下面的红框是1.8.14。未修改如下:
修改为如下:
(6)编译
make
成功的界面:
(7)安装
sudo make install
成功的界面:
ls /opt/janus/
生成如下,成功的界面:
注意:make install的时候,将janus安装到 /opt/janus路径,插件的so库在/opt/janus/lib/janus/plugins。configure 执?成功后,会输出 janus 所?持的 协议及插件,如下:
compiler: gcc
libsrtp version: 2.x
SSL/crypto library: OpenSSL
DTLS set-timeout: not available
Mutex implementation: GMutex (native futex on Linux)
DataChannels support: yes
Recordings post-processor: yes
TURN REST API client: yes
Doxygen documentation: yes
Transports:
REST (HTTP/HTTPS): yes
WebSockets: yes
RabbitMQ: no
MQTT: no
Unix Sockets: yes
Nanomsg: no
Plugins:
Echo Test: yes
Streaming: yes
Video Call: yes
SIP Gateway: yes
NoSIP (RTP Bridge): yes
Audio Bridge: yes
Video Room: yes
Voice Mail: yes
Record&Play: yes
Text Room: yes
Lua Interpreter: no
Duktape Interpreter: no
Event handlers:
Sample event handler: yes
WebSocket ev. handler: yes
RabbitMQ event handler:no
MQTT event handler: no
Nanomsg event handler: no
GELF event handler: yes
External loggers:
JSON file logger: no
JavaScript modules: no
4. 配置和运?janus
4.1 配置nginx
安装nginx,主要?来提供web访问。
vim /usr/local/rtmp-nginx/conf/nginx.conf
(1)生成证书,如果证书已经安装了,可以跳过该步骤。
#下载nginx 1.15.8版本
wget http://nginx.org/download/nginx-1.15.8.tar.gz
tar xvzf nginx-1.15.8.tar.gz
cd nginx-1.15.8/
# 配置,?定要?持https
./configure --with-http_ssl_module
# 编译
make
#安装
sudo make install
(2)安装nginx,如果nginx已经安装了,可以跳过该步骤。
#下载nginx 1.15.8版本
wget http://nginx.org/download/nginx-1.15.8.tar.gz
tar xvzf nginx-1.15.8.tar.gz
cd nginx-1.15.8/
# 配置,?定要?持https
./configure --with-http_ssl_module
# 编译
make
#安装
sudo make install
指向janus所在?录/opt/janus/share/janus/demos,在http模块下,新增加一个server,如下设计:
server {
listen 443 ssl;
server_name localhost;
ssl_certificate /home/qaa/share/webrtc/cert/cert.pem;
ssl_certificate_key /home/qaa/share/webrtc/cert/key.pem;
ssl_session_cache shared:SSL:1m;
ssl_session_timeout 5m;
ssl_ciphers HIGH:!aNULL:!MD5;
ssl_prefer_server_ciphers on;
location / {
root /opt/janus/share/janus/demos;
index index.html index.htm;
}
}
(3)修改nginx配置?件
vim /usr/local//rtmp-nginx/conf/nginx.conf
在Http下,添加这个server模块。新增内容如下:
指向janus所在?录/opt/janus/share/janus/demos
# HTTPS server
#
server {
listen 443 ssl;
server_name localhost;
# 配置相应的key
ssl_certificate /home/ubuntu/cert/cert.pem;
ssl_certificate_key /home/ubuntu/cert/key.pem;
ssl_session_cache shared:SSL:1m;
ssl_session_timeout 5m;
ssl_ciphers HIGH:!aNULL:!MD5;
ssl_prefer_server_ciphers on;
# 指向janus demo所在?录
location / {
root /opt/janus/share/janus/demos;
index index.html index.htm;
}
}
(4)启动Nginx
cd /usr/local/rtmp-nginx
./sbin/nginx -c conf/nginx.conf
如下成功界面:
ps -ef | grep nginx
(5)通过浏览器访问,进行测试。
最好是使用谷歌浏览器测试,否则有可能有些兼容性的问题和不方便调试。
https://172.16.204.160
浏览器成功界面如下,但此时还不能正常通话。
注意: 如果是云服务器,一定要注意开放端口,如下界面:
在任意目录,执行该命令:
sudo nohup turnserver -L 0.0.0.0 --min-port 30000 --max-port 60000 -a -u root:9 -v -f -r nort.gov &
检验是否执行成功,如下界面:
turnserver执行成功的命令
sudo ps -ef | grep turnserver
如下成功界面:
TCP/UDP 端口是3478
UDP 端口是30000-60000
注意:如果是云服务器,一定需要在安全组开放端口。
4.2.安装和启动coturn
(1)这个coturn安装在APPRTC的环境搭建的文章,也讲过,也可以参考前面的文章。
sudo apt-get install libssl-dev
sudo apt-get install libevent-dev
#git clone https://github.com/coturn/coturn
#cd coturn
# 提供另?种安装?式turnserver是coturn的升级版本
wget http://coturn.net/turnserver/v4.5.0.7/turnserver-4.5.0.7.tar.gz
tar xfz turnserver-4.5.0.7.tar.gz
cd turnserver-4.5.0.7
./configure
make
sudo make install
(2)启动
启动turnserver。
sudo nohup turnserver -L 0.0.0.0 --min-port 30000 --max-port 60000 -a -u root:9 -v -f -r nort.gov &
4.3 配置janus的jcfg?件
(1)janus配置
janus安装?录在/opt/janus
(2)配置Video room
我们先配置video room
需要配置的?件为(?录/opt/janus/etc/janus):
并开通8088,8089;8188,8989
要先把.sample后缀的?件拷?成jcfg后缀
cd /opt/janus/etc/janus
(3)拷贝文件
sudo cp janus.jcfg.sample janus.jcfg
sudo cp janus.transport.http.jcfg.sample janus.transport.http.jcfg
sudo cp janus.transport.websockets.jcfg.sample janus.transport.websockets.jcfg
//暂时不用改
sudo cp janus.plugin.videoroom.jcfg.sample janus.plugin.videoroom.jcfg
sudo cp janus.transport.pfunix.jcfg.sample janus.transport.pfunix.jcfg
sudo cp janus.plugin.streaming.jcfg.sample janus.plugin.streaming.jcfg
sudo cp janus.plugin.recordplay.jcfg.sample janus.plugin.recordplay.jcfg
sudo cp janus.plugin.voicemail.jcfg.sample janus.plugin.voicemail.jcfg
sudo cp janus.plugin.sip.jcfg.sample janus.plugin.sip.jcfg
sudo cp janus.plugin.nosip.jcfg.sample janus.plugin.nosip.jcfg
sudo cp janus.plugin.textroom.jcfg.sample janus.plugin.textroom.jcfg
sudo cp janus.plugin.echotest.jcfg.sample janus.plugin.echotest.jcfg
(4)配置janus.jcfg
cd /opt/janus/etc/janus
vim janus.jcfg
搜索stun
未修改文件如下界面:
修改文件如下界面:
修改成为自己的ip和端口号(这里的端口号就使用的默认的)。
内容如下:
注意:如果服务器的IP地址变化了,一定要注意修改。否则可能连接失败。
# ?概237?
stun_server = "172.16.204.161"
stun_port = 3478
nice_debug = false
#?概274?
# credentials to authenticate...
8 turn_server = "172.16.204.161"
9 turn_port = 3478
10 turn_type = "udp"
11 turn_user = "root"
12 turn_pwd = "9"
未修改文件如下界面:
修改文件如下界面:
(5)配置janus.transport.http.jcfg
cd /opt/janus/etc/janus
vim janus.transport.http.jcfg
未修改文件如下界面:
修改文件如下界面:
证书未修改文件如下界面:
修改文件如下界面:
内容如下:
general: {
#events = true # Whether
to notify event handlers about transport events (default=true)
json = "indented" # Whether
the JSON messages should be indented (default),
# plain (no indentation) or compact (no indentation and no space
s)
base_path = "/janus" # Base path to bi
nd to in the web server (plain HTTP only)
threads = "unlimited" # unlimited=threa
d per connection, number=thread pool
http = true #
Whether to enable the plain HTTP interface
port = 8088 #
Web server HTTP port
#interface = "eth0" # Whether
we should bind this server to a specific interface only
#ip = "192.168.0.1" # Whether
we should bind this server to a specific IP address (v4 or v6) on
ly
https = true # Whether
to enable HTTPS (default=false)
secure_port = 8089 # Web ser
ver HTTPS port, if enabled
#secure_interface = "eth0" # Whether we shou
ld bind this server to a specific interface only
#secure_ip = "192.168.0.1" # Whether we shou
ld bind this server to a specific IP address (v4 or v6) only
#acl = "127.,192.168.0." # Only allow requ
ests coming from this comma separated list of addresses
}
certificates: {
cert_pem = "/home/qaa/share/webrtc/cert/cert.pem"
cert_key = "/home/qaa/share/webrtc/cert/key.pem"
#cert_pwd = "secretpassphrase"
#ciphers = "PFS:-VERS-TLS1.0:-VERS-TLS1.1:-3DES-CBC:-ARCF OUR-128"
}
(6) 配置janus.transport.websockets.jcfg
cd /opt/janus/etc/janus
vim janus.transport.websockets.jcfg
未修改文件如下界面:
修改文件如下界面:
修改key的地址
内容如下:
general: {
#events = true # Whether
to notify event handlers about transport events (default=true)
json = "indented" # Whether
the JSON messages should be indented (default),
# plain (no indentation) or compact (no indentation and no space
s)
#pingpong_trigger = 30 # After how many
seconds of idle, a PING should be sent
#pingpong_timeout = 10 # After how many
seconds of not getting a PONG, a timeout should be detected
ws = true #
Whether to enable the WebSockets API
ws_port = 8188 # WebSock
ets server port
#ws_interface = "eth0" # Whether we shou
ld bind this server to a specific interface only
#ws_ip = "192.168.0.1" # Whether we shou
ld bind this server to a specific IP address only
wss = true #
Whether to enable secure WebSockets
wss_port = 8989 # WebSockets serv
er secure port, if enabled
#wss_interface = "eth0" # Whether we shou
ld bind this server to a specific interface only
#wss_ip = "192.168.0.1" # Whether we shou
ld bind this server to a specific IP address only
#ws_logging = "err,warn" # libwebsockets d
ebugging level as a comma separated list of things
# to debug, supported values: err, warn, notice, info, debug, par
ser,
# header, ext, client, latency, user, count (plus 'none' and 'al
l')
#ws_acl = "127.,192.168.0." # Only allow requ
ests coming from this comma separated list of addresses
}
certificates: {
cert_pem = "/home/ubuntu/cert/cert.pem"
cert_key = "/home/ubuntu/cert/key.pem"
#cert_pwd = "secretpassphrase"
}
4.4 修改??默认?持的wss协议
vim /opt/janus/share/janus/demos/videoroomtest.js
未修改的界面:
修改文件如下界面:
添加内容如下:
将默认的https协议改为wss。
var server = "wss://" + window.location.hostname + ":8989";
4.5 运? Janus
WebSocket 的ws端?号为 8188和8989,记住这个端?号,在 Android APP Demo 中会使?到!
(1)启动 Janus:
/opt/janus/bin/janus --debug-level=5 --log-file=$HOME/janus-log
根据需要可以选择是否加上后?两个启动参数。数字越大,打印内容越大。
启动成功,如下界面:
webscoket ?定要启动ws和wss(安全的ws,类?http-https)。
4.7 测试web和web的通话
https://172.16.204.161/videoroomtest.html
(1)开两个同样的??,然后点击start,输?名字则开始进??视频通话测试。
需要使用谷歌浏览器,才能正确打开,如下界面:
点击页面的start,如下所示:
服务器的响应界面,如下所示:
(2)允许使用麦克风和摄像头,如下所示:
再开一个页面,重复上面的操作,如下所示:
这样就可以看到,他们已经测试通过了。
A端测试
B端测试
(3)服务器正确响应画面,如下所示:
强制退出后,正确响应画面,如下所示:
如果是云服务器,就需要开放端口,如下所示:
5.测试web和Android
下载Android源码
使? PC 下的 浏览器 与 Android APP Demo 进?联调。
5.1 启动 Web Demo
这样外部便可以通过 https://111.229.231.225进?访问了,进???后,找到 videoRoom,Start。
5.2 启动 Android APP Demo
5.2.1 下载源码
git clone https://github.com/pcgpcgpcg/janus-gateway-android.git
5.2.2 修改信令地址
janus-gateway-android ?持两个 Demo 测试:EchoTest 和 VideoRoom,默认情况下会启?EchoTest,这个 Demo 仅仅是连接服务器后,将数据再发回本地进?本地测试,我们要改为与房间内的其它?户(浏览器)进?视频通话,则需要启?另外?个测试?例 VideoRoom,按照如下?式修改代码:
然后,搜索39.106.100.180,替换为??的IP。
如这样:
APP Demo 是通过 WebSocket 连接 Janus Server,所以修改 VideoRoomTest.java 中 roomUrl地址为我们启动的 Janus 服务器 WebSocket 地址,IP 为 janus server 地址,端?默认为 8188。
5.2.3 修改build.gradle
内容如下:
maven{ url'http://maven.aliyun.com/nexus/content/groups/public/' }
maven { url 'http://developer.huawei.com/repo/' }
jcenter { url 'http://maven.aliyun.com/nexus/content/repositories/jcenter' }
注意:如果下载不了部分组件,那就需要配置地址。
修改访问信令服务器的IP地址
5.2.4 编译安装
Android端安装完的效果,如下所示:
只有红色框框内的功能,可以正常使用。
5.3 联调测试
Janus Server 默认会开启两个视频房间:1234 和 5678,分别使? VP8 和 VP9 视频编码器,所以我们通过 Brower 和 Android APP Demo 进?联调测试时,暂不需要设置房间 ID。如下图:
6.总结
关于WebRtc音视频通话的janus实战就分享到这里,所有步骤都是可以复现,欢迎关注,转发,收藏,点赞。
后期关于更多项目有关的知识,更新在微信公众号"记录世界 from antonio"