使用Jibri进行Jitsi Meet视频录制
想学更多的WebRTC知识,请关注WebRTC中文社区
前言
我们在做视频会议系统的时候,通常都会有会议录制功能,那么作为视频会议开源的翘楚,Jitsi是怎么做这一点的,在官方文档及其隐晦的情况下,我们该怎么成功搭建视频录制服务呢?下面我就带大家来了解下实战操作一把
什么的Jibri
Jibri提供用于录制或流式传输Jitsi Meet会议的服务。
它通过启动在虚拟帧缓冲区中呈现的Chrome实例并使用ffmpeg捕获和编码输出来工作。它旨在在单独的计算机(或VM)上运行,而没有其他使用显示或音频设备的应用程序。单个jibri一次仅支持一次录制。
这里注意 ** 单个Jibri一次仅支持一次录制** ,也就是说一个Jibri服务只能同时录制一次视频会议,如果在其他会议室录制的同时在开启录制,那么他会返回没有录制设备可用,或者设备在忙
Jibri的设计思路
我的理解可能有偏差,因为我也才刚接触2天,欢迎各位补充。 Jibri重新添加了一个隐藏用户,这个用户你是看不见的,用户没有感知,进入了会议室,它使用了Chrome Driver来控制Chrome实例,在使用ffmpeg进行捕获然后编码在输出为mp4格式的视频文件。
录制的方式
服务端录制
优点是不用担心客户因自身电脑问题造成录制失败(如磁盘空间不足),也不会因录制时抢占资源(CPU 占用率过高)而导致其他应用出现问题等;缺点是实现的复杂度很高。
客户端录制:
优点是方便录制方操控,并且所录制的视频清晰度高,实现相对简单。这里可以和服务端录制做个对比,一般客户端摄像头的分辨率都非常高的(如 1280x720),所以客户端录制可以录制出非常清晰的视频;但服务端录制要做到这点就很困难了,本地高清的视频在上传服务端时由于网络带宽不足,视频的分辨率很有可能会被自动缩小到了 640x360,这就导致用户回看时视频特别模糊,用户体验差。不过客户端录制也有缺点,其中最主要的缺点就是耗 CPU。而 CPU 占用过高后,就很容易造成应用程序卡死。除此之外,它对内存、硬盘的要求也特别高,不过在计算机硬件发展的今天,这已经不是什么大问题了
准备工作:
- 官方文档用Ubuntu16.04进行的安装,我测试的时候用的是Ubuntu18.04进行安装,二选其一即可。
- 已经搭建好jitsi-meet,并能正常的视频通话,如果没有搭建Jitsi-meet,可以按章我的上篇文章进行搭建
安装依赖:
apt install linux-image-extra-virtual ffmpeg curl unzip software-properties-common
因为安装了linux-image-extra-virtual 内核软件包,为了让他生效,我们需要重新启动操作系统,注意 以下命令会让你电脑进行重启启动
reboot
重启电脑后,重新ssh进入云主机
加载snd-aloop模块:
设置要在启动时加载的模块:
echo "snd-aloop" >> /etc/modules
将模块加载到正在运行的内核中:
modprobe snd-aloop
检查模块是否已加载:
lsmod | grep snd_aloop
输出以下内容便是成功加载了
root@jvb:~# lsmod | grep snd_aloop
snd_aloop 24576 0
snd_pcm 98304 1 snd_aloop
snd 81920 3 snd_timer,snd_aloop,snd_pcm
安装Google Chrome:
curl -sS -o - https://dl-ssl.google.com/linux/linux_signing_key.pub | apt-key add
echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" > /etc/apt/sources.list.d/google-chrome.list
apt-get -y update
apt-get -y install google-chrome-stable
安装ChromeDriver,他是用来控制Chrome:
CHROME_DRIVER_VERSION=`curl -sS chromedriver.storage.googleapis.com/LATEST_RELEASE`
wget -N http://chromedriver.storage.googleapis.com/$CHROME_DRIVER_VERSION/chromedriver_linux64.zip -P ~/
unzip ~/chromedriver_linux64.zip -d ~/
rm ~/chromedriver_linux64.zip
sudo mv -f ~/chromedriver /usr/local/bin/chromedriver
sudo chown root:root /usr/local/bin/chromedriver
sudo chmod 0755 /usr/local/bin/chromedriver
安装Jibri:
wget -qO - https://download.jitsi.org/jitsi-key.gpg.key | sudo apt-key add -
sudo sh -c "echo 'deb https://download.jitsi.org stable/' > /etc/apt/sources.list.d/jitsi-stable.list"
sudo apt-get update
sudo apt-get install jibri
在执行sudo apt-get install jibri
如果提示让你选择,选择keyboard configuration,并选择英文English,如果没有提示请忽略。
将Jibri的用户帐户添加到用户组:
usermod -aG adm,audio,video,plugdev jibri
配置Prosody
注意
- 以下的jitsi.example.com全部替换成你的域名
- 我的jitsi-meet在一台服务器,Jibri在另一台服务器。当我觉得安装在一台服务器也没有问题。
vim /etc/prosody/conf.d/you config.cfg.lua
如果有下面内容的,请忽略,没有的请添加
---Set up a MUC (multi-user chat) room server on conference.example.com:
Component "conference.jitsi.example.com" "muc"
--- Store MUC messages in an archive and allow users to access it
modules_enabled = { "muc_mam" }
添加internal MUC 组件
--- internal muc component, meant to enable pools of jibri and jigasi clients
Component "internal.auth.jitsi.example.com" "muc"
modules_enabled = {
"ping";
}
storage = "internal"
muc_room_cache_size = 1000
添加VirtualHost以保存jibri用户
VirtualHost "recorder.jitsi.example.com"
modules_enabled = {
"ping";
}
authentication = "internal_plain"
为Jibri创建两个新帐户,一个用于控制,一个用于记录:
prosodyctl register jibri auth.jitsi.example.com Jibripssword
prosodyctl register recorder recorder.jitsi.example.com recorderPssword
配置Jicofo:
vim /etc/jitsi/jicofo/sip-communicator.properties
org.jitsi.jicofo.jibri.BREWERY=JibriBrewery@internal.auth.yourdomain.com
org.jitsi.jicofo.jibri.PENDING_TIMEOUT=90
配置Jitsi Meet:
配置Jitsi Meet 让录制按钮在界面中显示出来
vim /etc/jitsi/meet/jitsi.example.com-config.js
找到以下配置取消注释
fileRecordingsEnabled: true, // 启用文件录制
liveStreamingEnabled: true, // 启用实时流媒体录制,这个选项是可以直接推流到油管进行直播的
hiddenDomain: 'recorder.yourdomain.com', //隐藏域
还可以直接将录制文件保存到云存储,不过目前就支持dropbox
// dropbox: {
// appKey: 'you app key', // Specify your app key here.
// // A URL to redirect the user to, after authenticating
// // by default uses:
// redirectURI: 'https://jitsi.example.com/static/oauth.html'
//` },
在创建dropbox应用的时候OAuth 2的Redirect URIs直接写
'https://jitsi.example.com/static/oauth.htm
这样配置才会生效
建立目录来存储录音并设置其权限:
mkdir srv/recordings
chown jibri:jibri srv/recordings
配置Jibri:
vim /etc/jitsi/jibri/config.json
"recording_directory": "srv/recordings", / /录制文件
"finalize_recording_script_path": "", //录制完成后启动的shell脚本,官方这里写了一串路径,但是我没有找到他,所以直接取消了
//刚刚上面配置Prosody的配置
"xmpp_server_hosts": [
"jitsi.example.com"
],
"xmpp_domain": "jitsi.example.com",
"control_login": {
"domain": "auth.jitsi.example.com",
"username": "jibri",
"password": "Jibr1P@ssw0rd"
},
// 注意,如果要配置多个Jibri,同时录制多个房间,这里的用户名不能一致
"control_muc": {
"domain": "internal.auth.jitsi.example.com",
"room_name": "JibriBrewery",
"nickname": "jibri"
},
"call_login": {
"domain": "recorder.jitsi.example.com",
"username": "recorder",
"password": "Rec0rderP@ssw0rd"
},
重启服务
systemctl restart prosody
systemctl restart jicofo
systemctl restart jitsi-videobridge2
systemctl restart jibri
开始录制
打开你的域名进入房间,点击右下角
当听到语音开始录制就代表成功了,我们去看看我们之前建立保存录像的文件夹
cd srv/recordings
会自动创建一个字母的文件夹
我们进入文件夹就可以看到mp4文件夹了,你不取消录制这个视频大小会一直变化
ll 22_2020-07-16-23-15-21.mp4
视频文件名的格式是 房间名_当前时间
停止录制
当开始录制的人点击停止录制按钮后会停止录制 当所有人离开房间后会停止录制。
可选项
如果云主机没有Java8环境需要安装Java8
wget -O - https://adoptopenjdk.jfrog.io/adoptopenjdk/api/gpg/key/public | sudo apt-key add -
add-apt-repository https://adoptopenjdk.jfrog.io/adoptopenjdk/deb/
apt update
apt install adoptopenjdk-8-hotspot
如果云主机有多个Java环境需要指定Java8运行Jirbri 将Java单词替换为Java8的完整路径
vim /opt/jitsi/jibri/launch.sh
替换后如下
exec /usr/lib/jvm/adoptopenjdk-8-hotspot-amd64/bin/java -Djava.util.logging.config.file=/etc/jitsi/jibri/logging.properties -jar /opt/jitsi/jibri/jibri.jar --config "/etc/jitsi/jibri/config.json"
替换后重启
systemctl restart jibri
取消视频录制警告
当我们把录制的视频拷贝到本地来用播放器播放后,我们会发现视频上方有一个警告 如图:
这是chrome提出的警告,解决警告的方法如下:
mkdir -p /etc/opt/chrome/policies/managed
echo '{ "CommandLineFlagSecurityWarningsEnabled": false }' >>/etc/opt/chrome/policies/managed/managed_policies.json
重启jibri
systemctl restart jibri
再次录制就没有了。
为每个房间都录制视频
显然同时一个房间只能录制一个视频,是满足不了我们业务需求的,但是Jibri又是通过虚拟机进行录制,每一个虚拟机只能安装一个jibri,那么意味着,我们同时录制上百个会议,那么就有上百台服务器在同时工作,服务器成本将会是个巨大的数字。
官方的社区和论坛并没有提供相关的完整解决方案,只是说可以创建一个Jibri池,类似于连接池的概念,我倒是觉得也许容器化docker是个不错的选择。
或则使用客户端进行录制。
- [ ] 一台服务器安装多个jibri同时进行多个视频录制
后续
如果你在安装中遇到了问题可以查看日志,根据错误进行解决
tail -f /var/log/jitsi/jibri