－－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。

效果图：