【WebRTC】开源项目Webrtc-streamer介绍

WebRTC-Streamer

这是一个用于通过简单的信令机制（参见 api）流式传输 WebRTC 媒体源的实验项目，支持以下媒体源：

• 捕获设备

• 屏幕捕获

• mkv 文件

• RMTP/RTSP 源

同时该项目也兼容 WHEP 接口。

---

注意 * 在线演示已停止，直到迁移到欧洲的 Web 托管服务。

资源

• 源码包 https://github.com/mpromonet/webrtc-streamer/releases/latest
• docker容器 https://hub.docker.com/r/mpromonet/webrtc-streamer

使用

./webrtc-streamer [-H http port] [-S[embeded stun address]] -[v[v]]  [urls...]
./webrtc-streamer [-H http port] [-s[external stun address]] -[v[v]] [urls...]
./webrtc-streamer -V
主要参数：
-v[v[v]] : 设置详细程度（verbosity）
-V : 打印版本信息
-C config.json : 从JSON配置文件加载urls
-n 名称 -u 视频url -U 音频url : 为视频url和音频url注册名称
[url] : 注册到源列表的url
HTTP服务器配置：
-H [主机名:]端口 : HTTP服务器绑定（默认0.0.0.0:8000）
-w web根目录 : 获取文件的路径
-c ssl密钥证书 : HTTPS的私钥和证书路径
-N 线程数 : HTTP服务器的线程数
-A 密码文件 : HTTP服务器访问的密码文件
-D 认证域 : HTTP服务器访问的认证域（默认:mydomain.com）
STUN/TURN服务器配置：
-S[stun地址] : 启动嵌入式STUN服务器绑定到地址（默认0.0.0.0:3478）
-s[stun地址] : 使用外部STUN服务器（默认:stun.l.google.com:19302，-表示不使用STUN）
-T[用户名:密码@]turn地址 : 启动嵌入式TURN服务器（默认:禁用）
-t[用户名:密码@]turn地址 : 使用外部TURN中继服务器（默认:禁用）
其他配置：
-R [Udp端口范围最小:最大] : 设置webrtc udp端口范围（默认0:65535）
-W webrtc_trials_fields : 设置webrtc trials字段（默认:WebRTC-FrameDropper/Disabled/）
-a[音频层] : 指定要使用的音频捕获层（默认:0）
-q[过滤器] : 指定发布过滤器（默认:.）
-o : 使用空编解码器（保持帧编码）

-H 参数会被转发到 civetweb 的
listening_ports选项
允许使用 civetweb 的语法，例如 -H8000,9000 或 -H8080r,8443s

使用 -o 选项允许使用 webrtc::VideoFrameBuffer::Type::kNative 存储来自后端流的压缩帧数据。这通过重写 webrtc::VideoFrameBuffer 结构，将数据存储在 i420 缓冲区的覆盖中来实现。这允许将 H264 帧从 V4L2 设备或 RTSP 流转发到 WebRTC 流。它使用更少的 CPU，但功能较少（调整大小、编解码器和带宽控制被禁用）。

WebRTC 流名称的选项：

• 使用 -n 参数定义的别名，然后对应的 -u 参数将用于创建捕获器

• “rtsp://” URL，将使用基于 live555 的 RTSP 捕获器打开

• “file://” URL，将使用基于 live555 的 MKV 捕获器打开

• “rmtp://” URL，将使用基于 librmtp 的 RMTP 捕获器打开

• “screen://” URL，将由 webrtc::DesktopCapturer::CreateScreenCapturer 打开

• “window://” URL，将由 webrtc::DesktopCapturer::CreateWindowCapturer 打开

• “v4l2://” URL，将捕获 H264 帧并使用 webrtc::VideoFrameBuffer::Type::kNative 类型存储（在 Windows 上不支持）

• “videocap://” URL，视频捕获设备名称

• “audiocap://” URL，音频捕获设备名称

Examples

./webrtc-streamer -C config.json

我们可以通过以下方式访问 WebRTC 流：Live Demo

使用 webrtcstreamer.html 页面。例如：

• webrtcstreamer.html?rtsp://wowzaec2demo.streamlock.net/vod/mp4:BigBuckBunny_115k.mov

• webrtcstreamer.html?Bunny

使用 layout=<行数>x<列数> 选项可以显示 WebRTC 流的网格布局。例如：Live Demo

使用docker镜像

您可以使用 docker 镜像启动应用程序：

docker run -p 8000:8000 -it mpromonet/webrtc-streamer

您可以通过以下方式从主机暴露 V4L2 设备：

docker run --device=/dev/video0 -p 8000:8000 -it mpromonet/webrtc-streamer

容器入口点是 webrtc-streamer 应用程序，然后您可以：

• 查看所有命令

  docker run -p 8000:8000 -it mpromonet/webrtc-streamer --help
  

• 运行容器并注册 RTSP URL：

  docker run -p 8000:8000 -it mpromonet/webrtc-streamer -n raspicam -u rtsp://pi2.local:8554/unicast
  

• 运行容器并提供 config.json 文件：

  docker run -p 8000:8000 -v $PWD/config.json:/usr/local/share/webrtc-streamer/config.json mpromonet/webrtc-streamer
  

在 NAT 后使用嵌入式 STUN/TURN 服务器

It is possible to start an embeded STUN
and TURN
server and publish its URL:

./webrtc-streamer -S0.0.0.0:3478 -s$(curl -s ifconfig.me):3478
./webrtc-streamer -s- -T0.0.0.0:3478 -tturn:turn@$(curl -s ifconfig.me):3478
./webrtc-streamer -S0.0.0.0:3478 -s$(curl -s ifconfig.me):3478 -T0.0.0.0:3479 -tturn:turn@$(curl -s ifconfig.me):3479

The command curl -s ifconfig.me is getting the public IP, it could also given
as a static parameter.

In order to configure the NAT rules using the upnp feature of the router, it is
possible to use
upnpc like
this:

upnpc -r 8000 tcp 3478 tcp 3478 udp

Adapting with the HTTP port, STUN port, TURN port.

HTML Embedding

不使用内部 HTTP 服务器，也可以很容易地在由其他 HTTP 服务器提供的 HTML 页面中显示 WebRTC 流。在创建 WebRtcStreamer 实例时，需要提供要使用的 WebRTC-streamer 的 URL：WebRtcStreamer
例如：

var webRtcServer = new</