史上最详细的webrtc-streamer访问摄像机视频流教程

淩亂°似流年 2023-09-26 19:38 30阅读 0赞

##  ##

**目录**

前言

一、webrtc-streamer的API

二、webrtc-streamer的启动命令介绍

1.原文

2.译文

三、webrtc-streamer的安装部署

1.下载地址

https://github.com/mpromonet/webrtc-streamer/releases

2.windows版本部署

3.Linux版本部署

四、springboot整合webrtc-streamer

五、公网使用webrtc-streamer访问相机视频

--------------------

## 前言 ##

最近公司在搞流媒体，我推荐了webrtc-streamer进行搭建，使用了一段时间后，出现新的需求，需要将内网的摄像机进行公网访问，我查询了几乎所有的帖子和github的问题回复，都没有给我一个准确的答案，经过不断尝试和摸索，我终于成功了，我希望将我的过程记录下来，让更多的中国开发者可以少走弯路，我对于webrtc不是很了解，但是这并不影响我使用开源的webrtc-streamer进行开发。

## 一、webrtc-streamer的API ##

webrtc-streamer的服务地址：192.168.1.8:8000
    查询所有api：http://192.168.1.8:8000/api/help
    [
    	"/api/addIceCandidate",
    	"/api/call",
    	"/api/createOffer",
    	"/api/getAudioDeviceList",
    	"/api/getIceCandidate",
    	"/api/getIceServers",
    	"/api/getMediaList",
    	"/api/getPeerConnectionList",
    	"/api/getStreamList",
    	"/api/getVideoDeviceList",
    	"/api/hangup",
    	"/api/help",
    	"/api/log",
    	"/api/setAnswer",
    	"/api/version"
    ]

`关键api：`/api/getPeerConnectionList

我使用它来判断当前的webrtc-streamer正在连接的通道

2个通道：

`ICE: 交互式连接建立（Interactive Connectivity Establishment）`

`ice_state：交互式连接状态（2：已连接/5：断开连接）`

`pc_state：客户端连接状态（2：正常/3：断开）`

*  已连接：

`"ice_state": 2`

`"pc_state": 2`

*  正在断开：

`"ice_state": 5`

`"pc_state": 3`

*  这种状态未知：

`"ice_state": 0`

`"pc_state": 0`

*  断开：

`无任何json数据`

`正常连接的json如下（sdp内容过多已删除）：`

`[`

`{`

`"0.07123060004985127": {`

`"ice_state": 2,`

`"pc_state": 2,`

`"sdp": "",`

`"signaling_state": 0,`

`"streams": {`

`"15661718658374446496": {`

`"15661718658374446496_video": {`

`"kind": "video",`

`"state": 1`

`}`

`]`

## 二、webrtc-streamer的启动命令介绍 ##

### 1.原文 ###

./webrtc-streamer [-H http port] [-S[embeded stun address]] -[v[v]]  [url1]...[urln]
    ./webrtc-streamer [-H http port] [-s[external stun address]] -[v[v]] [url1]...[urln]
    ./webrtc-streamer -V
        	-v[v[v]]           : verbosity
        	-V                 : print version
        	-H [hostname:]port : HTTP server binding (default 0.0.0.0:8000)
    	-w webroot         : path to get files
    	-c sslkeycert      : path to private key and certificate for HTTPS
    	-N nbthreads       : number of threads for HTTP server
    	-A passwd          : password file for HTTP server access
    	-D authDomain      : authentication domain for HTTP server access (default:mydomain.com)
    
    	-S[stun_address]                   : start embeded STUN server bind to address (default 0.0.0.0:3478)
    	-s[stun_address]                   : use an external STUN server (default:stun.l.google.com:19302 , -:means no STUN)
    	-t[username:password@]turn_address : use an external TURN relay server (default:disabled)
    	-T[username:password@]turn_address : start embeded TURN server (default:disabled)
    
    	-a[audio layer]                    : spefify audio capture layer to use (default:0)		
    	-q[filter]                         : spefify publish filter (default:.*)
    	-o                                 : use null codec (keep frame encoded)
    
    	-C config.json                     : load urls from JSON config file 
    	-R [Udp port range min:max]        : Set the webrtc udp port range (default 0:65535)
    
    	-n name -u videourl -U audiourl    : register a name for a video url and an audio url
    [url]                              : url to register in the source list

### 2.译文 ###

./webrtc-streamer [-H http port] [-S[embeded stun address]] -[v[v]]  [url1]...[urln] 
    ./webrtc-streamer [-H http port] [-s[external stun address]] -[v[v]] [url1]...[urln]
    ./webrtc-streamer -V
        -v[v[v]]           : verbosity
        -V                 : 打印版本
        -H [hostname:]port : HTTPServer绑定 (default 0.0.0.0:8000)
    	-w webroot         : 获取文件的路径
    	-c sslkeycert      : HTTPS的私钥和证书路径
    	-N nbthreads       : HTTP服务器的线程数
    	-A passwd          : 用于HTTP服务器访问的密码文件
    	-D authDomain      : HTTP服务器访问的身份验证域（默认值：mydomain.com）
    	-S[stun_address]                   : 使用嵌入的STUN服务器绑定到地址（默认值为0.0.0.0:3478）
    	-s[stun_address]                   : 使用外部的STUN服务器绑定到地址（默认值为0.0.0.0:3478）
    	-t[username:password@]turn_address : 使用外部TURN中继服务器（默认：禁用）
    	-T[username:password@]turn_address : 使用嵌入式TURN中继服务器（默认：禁用）
    	-a[audio layer]                    : 指定要使用的音频捕获层（默认值：0）	
    	-q[filter]                         : 指定发布筛选器（默认值：.*）
    	-o                                 : 使用空编解码器（保持帧编码）
    	-C config.json                     : 从JSON配置文件加载URL
    	-R [Udp port range min:max]        : 设置webrtc-udp端口范围（默认值为0:65535）
    	-n name -u videourl -U audiourl    : 注册视频url和音频url的名称
    	[url]                              : 要在源列表中注册的url

举例：

指定绑定ip端口：./webrtc-streamer -H 192.168.1.8:8123

![dbf4de87a6884a81a30b4affac185833.png][]

**注意几个细节：**

1、-o 这个命令务必要加上，不加的话你会发现你的cpu预览几路马上飙升到100%。

2、 -s/-S/-t/-T这几个命令后面不要有空格。

3、只支持H264的视频码流，H265不支持。

## 三、webrtc-streamer的安装部署 ##

### 1.下载地址 ###

### [https://github.com/mpromonet/webrtc-streamer/releases][https_github.com_mpromonet_webrtc-streamer_releases] ###

目前最新版本0.7.2版本

![148856f2a1ff4d5a9a2c69f64a7c3e21.png][]

红框内分别为windows版本和Linux版本。

### 2.windows版本部署 ###

下载windows版本压缩包，解压后如下图

![7760ce97b9e4475a9e780e090d4c8dd0.png][]

在当前目录下输入命令webrtc-streamer.exe -H 192.168.1.227:8000 -o

再次强调 -o 为了不转码，进而降低cpu负荷。

![a2866b5797904cd9b2719148b1286c25.png][]

### 3.Linux版本部署 ###

系统环境都正常的情况安装步骤如下：

1.webrtc-streamer包：webrtc-streamer-v0.7.2-Linux-x86\_64-Release.tar.gz

2.拷贝到root下，解压：tar -xvf webrtc-streamer-v0.7.2-Linux-x86\_64-Release.tar.gz

3.进入webrtc-streamer-v0.7.2-Linux-x86\_64-Release：cd webrtc-streamer-v0.7.2-Linux-x86\_64-Release

![cd4feda3535c48a8b1219c7a46ebb5c6.png][]

4.执行 ./webrtc-streamer -H 192.168.1.10:8000 -o

![1b576bc04d2645f79757159fb7f8133a.png][]

Linux大概率会报错缺少环境，这个自行搜索解决。如果实在解决不了，给我留言吧。

## 四、springboot整合webrtc-streamer ##

这部分我就快速贴代码了。

1、前端部分：

项目需要引入的js：webrtcstreamer.js、adapter.min.js、jquery-1.7.1.min.js

我这里配置了24个video用来测试，分别支持宇视、大华、海康的RTSP流。

<!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>Title</title>
        <script type="text/javascript" src="adapter.min.js"></script>
        <script type="text/javascript" src="webrtcstreamer.js"></script>
        <script type="text/javascript" src="jquery-1.7.1.min.js"></script>
        <style>
            video {
                width: 300px;
                height: 200px;
            }
        </style>
    </head>
    <body>
    <p>视频播放</p>
    <div>
        <video id="video1" muted autoplay loop controls>muted controls disablePictureInPicture</video>
        <video id="video2" muted autoplay loop controls>muted controls disablePictureInPicture</video>
        <video id="video3" muted autoplay loop controls>muted controls disablePictureInPicture</video>
        <video id="video4" muted autoplay loop controls>muted controls disablePictureInPicture</video>
        <video id="video5" muted autoplay loop controls>muted controls disablePictureInPicture</video>
        <video id="video6" muted autoplay loop controls>muted controls disablePictureInPicture</video>
    </div>
    <div>
        <video id="video7" muted autoplay loop controls>muted controls disablePictureInPicture</video>
        <video id="video8" muted autoplay loop controls>muted controls disablePictureInPicture</video>
        <video id="video9" muted autoplay loop controls>muted controls disablePictureInPicture</video>
        <video id="video10" muted autoplay loop controls>muted controls disablePictureInPicture</video>
        <video id="video11" muted autoplay loop controls>muted controls disablePictureInPicture</video>
        <video id="video12" muted autoplay loop controls>muted controls disablePictureInPicture</video>
    </div>
    <div>
        <video id="video13" muted autoplay loop controls>muted controls disablePictureInPicture</video>
        <video id="video14" muted autoplay loop controls>muted controls disablePictureInPicture</video>
        <video id="video15" muted autoplay loop controls>muted controls disablePictureInPicture</video>
        <video id="video16" muted autoplay loop controls>muted controls disablePictureInPicture</video>
        <video id="video17" muted autoplay loop controls>muted controls disablePictureInPicture</video>
        <video id="video18" muted autoplay loop controls>muted controls disablePictureInPicture</video>
    </div>
    <div>
        <video id="video19" muted autoplay loop controls>muted controls disablePictureInPicture</video>
        <video id="video20" muted autoplay loop controls>muted controls disablePictureInPicture</video>
        <video id="video21" muted autoplay loop controls>muted controls disablePictureInPicture</video>
        <video id="video22" muted autoplay loop controls>muted controls disablePictureInPicture</video>
        <video id="video23" muted autoplay loop controls>muted controls disablePictureInPicture</video>
        <video id="video24" muted autoplay loop controls>muted controls disablePictureInPicture</video>
    </div>
    <script>
        var cameralist = new Array();
        var camera64 = {type: "hik", ipaddr: "192.168.1.64", username: "admin", password: "hik12345", port: 554};
        window.onload = function () {
            // 初始化内容
            cameralist.push(camera64);
            console.log(cameralist);
        }
        let num = 0;
    
        function getCamera() {
            let obj = cameralist[num];
            console.log(obj);
            num++;
            if (num == 1) {
                num = 0;
            }
            return obj;
        }
    
        let webRtcServer = null;
        let videoMap = new Map();
        $('video').click(function (e) {
            let ID = e.target.id;//获取当前点击事件的元素
            console.log(ID);
            if (videoMap.get(ID) != null) {
                closeVideo(ID, videoMap.get(ID));
            } else {
                let camera = getCamera();
                console.log(camera);
                if (camera.type == "ys") {
                    realViewYs("192.168.1.11", ID, camera.username, camera.password, camera.ipaddr, camera.port);
                } else if (camera.type == "dh") {
                    realViewDh("192.168.1.11", ID, camera.username, camera.password, camera.ipaddr, camera.port);
                } else {
                    realViewHik("112.98.126.2", ID, camera.username, camera.password, camera.ipaddr, camera.port);
                }
            }
        });
    
    
        //预览海康相机
        function realViewHik(serverip, elem, username, password, ipaddr, port) {
            webRtcServer = new WebRtcStreamer(elem, "http://" + serverip + ":28000");
            let rtspUrl = "rtsp://" + username + ":" + password + "@" + ipaddr + ":" + port + "/ch1/main/av_stream";
            let option = "rtptransport=tcp";
            console.log("rtsp地址：" + rtspUrl);
            webRtcServer.connect(rtspUrl, null, option, null);
            videoMap.set(elem, webRtcServer);
        }
    
        //预览大华相机
        function realViewDh(serverip, elem, username, password, ipaddr, port) {
            webRtcServer = new WebRtcStreamer(elem, "http://" + serverip + ":8000");
            let rtspUrl = "rtsp://" + username + ":" + password + "@" + ipaddr + ":" + port + "/cam/realmonitor?channel=1&subtype=0";
            let option = "rtptransport=tcp";
            console.log("rtsp地址：" + rtspUrl);
    
            webRtcServer.connect(rtspUrl, null, option, null);
            videoMap.set(elem, webRtcServer);
        }
    
        //预览宇视相机
        function realViewYs(serverip, elem, username, password, ipaddr, port) {
            webRtcServer = new WebRtcStreamer(elem, "http://" + serverip + ":8000");
            let rtspUrl = "rtsp://" + username + ":" + password + "@" + ipaddr + ":" + port + "/media/video1/multicast";
            console.log("rtsp地址：" + rtspUrl);
            let option = "rtptransport=tcp";
            webRtcServer.connect(rtspUrl, null, option, null);
            videoMap.set(elem, webRtcServer);
        }
    
        function closeVideo(id, webrtc) {
            webrtc.disconnect();
            videoMap.delete(id);
        }
    
        //页面退出时销毁
        // window.onbeforeunload = function () {
        //     alert("页面关闭");
        //     webRtcServer.disconnect();
        // }
        //页面离开或者浏览器关闭的时候触发
        window.onbeforeunload = function (event) {
            $.ajax({
                // url: "../getIp",
                url: "http://127.0.0.1:12344/ard/videocall",
                type: "post",
                contentType: "application/json",
                dataType: "json",
                data: JSON.stringify({"cmd": "close", "url": "https://anruida.app.zihai.shop/?id=zns&pass=ard"}),
                success: function (data) {
                }
            });
            webRtcServer.disconnect();
        };
    
    </script>

2、后端部分

后端部分简单多了，初学者应该都会吧，直接配置个controller找这个html就行了。

@GetMapping("/")
        String index() {
            return "view";
        }

启动项目打开127.0.0.1:8080

![2f209bb0e43849a88c647944c2d810f5.png][]

至此，局域网内访问相机视频就完成了。

## 五、公网使用webrtc-streamer访问相机视频 ##

通过上面的步骤局域网内访问相机视频流已经可以实现了，但是如果你想把项目部署到公网中进行访问就不行了。

**公网部署步骤：**

1、配置webrtc-streamer所在服务器的内网穿透地址，例如内网192.168.1.8:8000 映射到公网为110.154.21.14:18000

2、部署一个本地coturn服务器，配置conturn服务器配置文件，同时将conturn服务器的3478的tcp和udp端口进行公网映射。

3、前端js页面使用公网地址也就是110.154.21.14:18000配置webrtc-streamer

4、启动命令增加turn和stun服务器：webrtc-streamer.exe -o -H 192.168.1.8:8000 -S110.154.21.14:3478 -Tadmin:123456@110.154.21.14:3478

**正式开始：**

第一步，使用路由器将webrtc内网映射到公网，这个我相信你玩这个肯定会，不同的交换机配置不同。

第二步，Linux下WebRTC搭建私有turn/stun服务，目前coturn只支持linux。

coturn是一个免费的开源的TURN/STUN服务器。coturn 服务器完整的实现了STUN/TURN/ICE协议，支持P2P穿透防火墙。  
STUN 服务器用于获取设备的外部网络地址。  
TURN 服务器是在点对点失败后用于通信中继。  
WebRTC 建立连接的步骤大概是这样的：  
客户端（浏览器）直接尝试直连；  
如果如果直连则通过 STUN 服务器进行穿透；  
如果无法穿透则通过 TURN 服务器进行中转。

1. 安装前准备
    	http://libevent.org/ 下载 libevent-2.1.12-stable.tar.gz
    	wget https://github.com/coturn/coturn/archive/4.5.1.1.tar.gz 下载 conturn-4.5.1.1.tar.gz （稳定版本）
    	（如果undefined reference to `SSL_CTX_up_ref'的错误换用稳定版本就好了。）
    2. 安装gcc
    	yum install gcc-c++
    3. 安装openssl-devel 
    	yum -y install openssl-devel
    4. 安装libevent2
    	在http://libevent.org/下载libevent-2.1.8-stable.tar.gz
    	tar -zxvf libevent-2.1.8-stable.tar.gz
    	cd libevent-2.1.8-stable
    	./configure --prefix=/usr --libdir=/usr/lib64 (如果报错试试这个方式：./configure --prefix=/usr/local/coturn)
    	make
    	make install
    	成功没有出现报错信息
    5. 安装conturn-4.5.1.1
    	tar -zxvf 4.5.1.1.tar.gz
    	cd coturn-4.5.1.1
    	./configure
    	make
    	make install
    
    	可以通过which turnserver验证。如果出现路径即为成功
    	
    6. 配置文件和签名，然后进入文件夹：
    	cd /usr/local/etc/ 会看到一个叫做 turnserver.conf.default的配置文件。将它备份：
    	cp turnserver.conf.default turnserver.conf
    7. 在当前文件夹生成签名(自行输入)：
    	openssl req -x509 -newkey rsa:2048 -keyout /usr/local/etc/turn_server_pkey.pem -out /usr/local/etc/turn_server_cert.pem -days 99999 -nodes
    8. 修改配置文件
    	Vim turnserver.conf  参考如下
    	relay-device=eth0
    	listening-ip=#内网IP
    	listening-port=3478
    	tls-listening-port=5349
    	relay-ip=#内网IP
    	external-ip=#公网IP
    	relay-threads=50
    	lt-cred-mech
    	min-port=49152
    	max-port=65535
    	cert=/usr/local/etc/turn_server_cert.pem
    	pkey=/usr/local/etc/turn_server_pkey.pem
    	pidfile=”/var/run/turnserver.pid”
    	user=admin:123456
    	cli-password=123456
    	将配置文件更新如上。
    	   请一定要设置cli-password这一项，不设置会报错。
    	   注意检查cert和pkey的路径和名称。检查内网ip和公网ip是否填写准确。
    	   注意文本格式准确。
    9. 启动turnserver
    	turnserver -o -a -f -user=admin:123456 -c /usr/local/etc/turnserver.conf -r xiamen
    	-o 是让程序在后台启动
    	-r 后面填个地区就行。
    	-user 一定要和配置文件中一样。
    	
    	ps -ef|grep turnserver 指令查看是否启动服务，如果有
    10. 验证
    	Trickle ICE：https://webrtc.github.io/samples/src/content/peerconnection/trickle-ice/
    	1、stun:+公网IP+端口，测试出现公网IP则代表部署成功
    	2、turn:+公网IP+端口，测试出现公网IP则代表部署成功

可能出现的问题：

> 1、libevent configure: error: OpenSSL could not be found. You should add the directory解决办法
> 
> 直接在线安装：yum -y install openssl-devel
> 
> 2、yum 安装软件报错 ： There are no enabled repos.
> 
> 可能是相关yum源被删除了：
> 
> wget -O /etc/yum.repos.d/CentOS-Base.repo [http://mirrors.aliyun.com/repo/Centos-7.repo][http_mirrors.aliyun.com_repo_Centos-7.repo]
> 
> yum clean all && yum makecache

--------------------

只需要做webrtc-streamer服务器的tcp:8000端口、coturn服务器的tcp/udp:3478端口的映射即可。

相机的地址不需要映射。

至此公网访问视频流完成！有问题请留言。

##  ##

[dbf4de87a6884a81a30b4affac185833.png]: https://img-blog.csdnimg.cn/dbf4de87a6884a81a30b4affac185833.png
[https_github.com_mpromonet_webrtc-streamer_releases]: https://github.com/mpromonet/webrtc-streamer/releases
[148856f2a1ff4d5a9a2c69f64a7c3e21.png]: https://img-blog.csdnimg.cn/148856f2a1ff4d5a9a2c69f64a7c3e21.png
[7760ce97b9e4475a9e780e090d4c8dd0.png]: https://img-blog.csdnimg.cn/7760ce97b9e4475a9e780e090d4c8dd0.png
[a2866b5797904cd9b2719148b1286c25.png]: https://img-blog.csdnimg.cn/a2866b5797904cd9b2719148b1286c25.png
[cd4feda3535c48a8b1219c7a46ebb5c6.png]: https://img-blog.csdnimg.cn/cd4feda3535c48a8b1219c7a46ebb5c6.png
[1b576bc04d2645f79757159fb7f8133a.png]: https://img-blog.csdnimg.cn/1b576bc04d2645f79757159fb7f8133a.png
[2f209bb0e43849a88c647944c2d810f5.png]: https://img-blog.csdnimg.cn/2f209bb0e43849a88c647944c2d810f5.png
[http_mirrors.aliyun.com_repo_Centos-7.repo]: https://links.jianshu.com/go?to=http%3A%2F%2Fmirrors.aliyun.com%2Frepo%2FCentos-7.repo