Ubuntu 下 Janus Server 搭建

爷,独闯天下 提交于 2020-04-28 03:43:36

--Ubuntu 下 Janus Server 搭建笔记

一 、简介

Janus是一个开源的,通过 C 语言实现了对 WebRTC 支持的 Gateway;Janus 自身实现得很简单,提供插件机制来支持不同的业务逻辑,配合官方自带插件就可以用来实现高效的 Media Server 服务。
本文主要介绍如何在 Ubuntu 16.04 下搭建起 janus 服务器,实现 janus 官方 Demo 浏览器与 Android APP Demo(janus-gateway-android)之间的音视频通话。

目前浏览器仅支持 FireFox 浏览器,因为 Chrome 浏览器打开音视频采集的话需要 HTTPS 加密访问!

效果图如下:

Janus 官网:https://janus.conf.meetecho.com/index.html

参考文档:https://github.com/meetecho/janus-gateway

二、 下载编译 Janus

编译运行 Janus Server 需要依赖较多的一些第三方库,而这些依赖库在 Ubuntu 下主要通过 aptitude 进行安装,首先通过安装 aptitude:

sudo apt-get install aptitude

1、 安装依赖

Ubuntu 下通过 aptitude 批量安装依赖工具包,这里建议 Ubuntu 镜像源(/etc/apt/source.list)不要为了追求速度而改用了国内的某些镜像源,如 网易 163,这可能会导致某些工具包下载失败,建议依然使用官方自带的镜像源。

批量安装命令:

sudo aptitude install libmicrohttpd-dev libjansson-dev libnice-dev \
    libssl-dev libsrtp-dev libsofia-sip-ua-dev libglib2.0-dev \
    libopus-dev libogg-dev libcurl4-openssl-dev pkg-config gengetopt \
    libtool automake

如果出现某个工具包下载失败,请修改镜像源为官方地址,并执行以下命令

sudo apt-get update && sudo apt-get upgrade

以更新镜像源,完成后重新安装。

2、 安装 WebSocket

janus 支持 WebSocket 是可选项,如果不安装,编译 janus 时,默认不支持 WebSocket 的链接请求,而 Android APP Demo 是通过 WebSocket 与 janus 进行通信的,因为我们希望 Android APP Demo 能与浏览器(HTTP)进行视频通话,所以就必须要在编译 janus 时支持 WebSocket。

依次执行以下命令,分别进行下载,编译,安装:

git clone https://github.com/warmcat/libwebsockets.git
cd libwebsockets
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX:PATH=/usr -DCMAKE_C_FLAGS="-fpic" ..
make && sudo make install

安装成功后,在编译 janus 时,janus 默认会增加对 WebSocket 的集成,或者通过增加编译参数 --enable-websockets 打开 WebSocket 开关,或 --disable-websockets 关闭 WebSocket 开关。

3、 安装 Http Server

Janus 源码目录下的 html 下自带 Web Demo(html & JavaScript ),Janus 编译完成并 Start 以后,需要通过 http server 访问 Janus Web Demo,其中包括:

    Echo Test:             yes
    Streaming:             yes
    Video Call:            yes
    SIP Gateway:           yes
    Audio Bridge:          yes
    Video Room:            yes
    Voice Mail:            yes
    Record&Play:           yes
    Text Room:             yes

以上 janus 插件均可通过相应的 http 链接进行访问体验。

以下介绍一种快速,便捷,轻巧的 HTTP Server 安装方式:

通过 Node.js (基于 Chrome V8 引擎的 JavaScript 运行环境) 进行安装,首先安装 Node.js:

sudo apt-get install nodejs

安装成功后,通过 npm (npm 是 Node.js 的包管理器,是全球最大的开源库生态系统) 进行安装 httpserver:

sudo npm -g install http-server

启动方式:

进入到 html 目录,执行 http-server 命令即可,如:

gobert@gobert-ThinkPad-X230:~/OpenSource/janus-gateway$ cd html/
gobert@gobert-ThinkPad-X230:~/OpenSource/janus-gateway/html$ http-server 
Starting up http-server, serving ./
Available on:
  http://127.0.0.1:8080
  http://100.100.32.64:8080
Hit CTRL-C to stop the server

输入 http url 即可访问。

注:需首先 build & start janus Server!

4、 安装 libsrtp

Janus 需要至少 version 1.5 以上的 libsrtp,如果系统中已经安装了 libsrtp,则首先卸载后,手动安装新版本,这里我们安装 libsrtp 2.0,依次执行以下命令:

wget https://github.com/cisco/libsrtp/archive/v2.0.0.tar.gz
tar xfv v2.0.0.tar.gz
cd libsrtp-2.0.0
./configure --prefix=/usr --enable-openssl
make shared_library && sudo make install

5、 编译 Janus

通过 Git 下载 Janus 源码,并编译安装:

git clone https://github.com/meetecho/janus-gateway.git
sh autogen.sh
./configure --prefix=/opt/janus --enable-websockets --enable-docs
make
sudo make install

configure 执行成功后,会输出 janus 所支持的 协议及插件,如下:

libsrtp version:           2.0.x
SSL/crypto library:        OpenSSL
DTLS set-timeout:          not available
DataChannels support:      no
Recordings post-processor: no
TURN REST API client:      yes
Doxygen documentation:     no
Transports:
    REST (HTTP/HTTPS):     yes                //支持 HTTP 访问
    WebSockets:            yes (new API)      //支持 WebSocket 访问
    RabbitMQ:              no
    MQTT:                  no
    Unix Sockets:          yes
Plugins:
    Echo Test:             yes
    Streaming:             yes
    Video Call:            yes
    SIP Gateway:           yes
    Audio Bridge:          yes
    Video Room:            yes
    Voice Mail:            yes
    Record&Play:           yes
    Text Room:             yes
Event handlers:
    Sample event handler:  yes

6、 运行 Janus

如果全部安装以上步骤进行编译的 janus ,那么 janus 的全局配置文件存放目录为 :

/opt/janus/etc/janus/janus.cfg

或者在启动 janus 时,加上相应的启动参数,参数可通过 janus --help 查看;

janus 默认的配置中是没有 WebSocket 的配置的,直接启动 Janus 会因没有 WebSocket 配置文件而报错。幸运的是在配置目录中 Janus 已经给我们提供了一个 WebSocket 的示例配置文件 : janus.transport.websockets.cfg.sample,(如果我们要通过 WebSocket 连接 Janus,则需要有个 WebSocket 的配置文件)这里我们可以直接拷贝这个示例文件:

sudo cp janus.transport.websockets.cfg.sample janus.transport.websockets.cfg

通过查看此配置文件,可以得知 Janus 默认的 WebSocket 的端口号为 8188,记住这个端口号,在 Android APP Demo 中会使用到!

启动 Janus:

/opt/janus/bin/janus --debug-level=7 --log-file=$HOME/janus-log

根据需要可以选择是否加上后面两个启动参数。

三、 视频通话联调测试

我们使用 PC 下的 浏览器 与 Android APP Demo 进行联调。

1、 启动 Web Demo

进入到 janus 目录下的 html 目录,启动 http-server

gobert@gobert-ThinkPad-X230:~$ cd ~/OpenSource/janus-gateway/html/
gobert@gobert-ThinkPad-X230:~/OpenSource/janus-gateway/html$ http-server 
Starting up http-server, serving ./
Available on:
  http://127.0.0.1:8080
  http://100.100.32.64:8080
Hit CTRL-C to stop the server

这样外部便可以通过 http://100.100.32.64:8080 进行访问了,进入首页后,找到 videoRoom,Start

2、 启动 Android APP Demo

  • 下载:
git clone git@github.com:Computician/janus-gateway-android.git
  • 修改源代码

    janus-gateway-android 支持两个 Demo 测试:EchoTest 和 VideoRoom,默认情况下会启用 EchoTest,这个 Demo 仅仅是连接服务器后,将数据再发回本地进行本地测试,我们要改为与房间内的其它用户(浏览器)进行视频通话,则需要启用另外一个测试用例 VideoRoom,按照如下方式修改代码:

    JanusActivity.java 类中新增 VideoRenderer.Callbacks 数组(视频房间中可能会有多人),暂定义为 2 个,实际连接人数不要超过此数字:

    private VideoRenderer.Callbacks remoteRenders[] = new VideoRenderer.Callbacks[3];
    

    OnCreate 方法中初始化以上定义的数组:

    remoteRenders[0] = VideoRendererGui.create(0, 0, 25, 25, VideoRendererGui.ScalingType.SCALE_ASPECT_FILL, true);
    

    APP Demo 是通过 WebSocket 连接 Janus Server,所以修改 VideoRoomTest.java 中 JANUS_URL 地址为我们启动的 Janus 服务器 WebSocket 地址,IP 为 janus server 地址,端口默认为 8188:

    private final String JANUS_URI = "ws://100.100.32.64:8188";
    

  • 编译安装

    通过 Android studio 进行编译安装到 Android 机。

3、联调测试

Janus Server 默认会开启两个视频房间:1234 和 5678,分别使用 VP8 和 VP9 视频编码器,所以我们通过 Brower 和 Android APP Demo 进行联调测试时,暂不需要设置房间 ID。

效果图:



 

易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!