当前位置： 首页 > news >正文

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

news 2025/7/24 0:48:48

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 WebRtcStreamer(<video tag>, <webrtc-streamer url>);

一个简短的示例 HTML 页面，使用在本地 8000 端口运行的 webrtc-streamer：

<html>
<head>
<script src="libs/adapter.min.js" ></script>
<script src="webrtcstreamer.js" ></script>
<script>        
	var webRtcServer      = null;
	window.onload         = function() { 
		webRtcServer      = new WebRtcStreamer("video",location.protocol+"//"+location.hostname+":8000");
		webRtcServer.connect("rtsp://wowzaec2demo.streamlock.net/vod/mp4:BigBuckBunny_115k.mov");
	}
	window.onbeforeunload = function() { webRtcServer.disconnect(); }
</script>
</head>
<body> 
	<video id="video" />
</body>
</html>

使用 WebComponents

WebRTC-streamer 提供了一个 WebComponent 来简化 HTML 页面中的流显示。这个组件可以像这样使用：
Web Components

<html>
<head>
	<script type="module" src="webrtc-streamer-element.js"></script>
</head>
<body>
	<webrtc-streamer url="rtsp://wowzaec2demo.streamlock.net/vod/mp4:BigBuckBunny_115k.mov"></webrtc-streamer>
</body>
</html>

这个 WebComponent 提供了以下属性：

  • url: 要显示的流 URL

  • options: 包含以下选项的 JSON 字符串：

  • video: 布尔值，是否显示视频

  • audio: 布尔值，是否播放音频

  • autoplay: 布尔值，是否自动播放

  • muted: 布尔值，是否静音

  • controls: 布尔值，是否显示控制条

  • poster: 字符串，视频封面图片 URL

这个组件会自动处理 WebRTC 连接的建立和断开，使得在 HTML 页面中集成 WebRTC 流变得非常简单。Live Demo

可以使用 webcomponent 作为视频流的容器:Live Demo

使用 WHEP

WHEP (WebRTC-HTTP Egress Protocol) 是一种基于 HTTP 的协议，用于从 WebRTC 服务器获取媒体流。WebRTC-streamer 支持 WHEP 接口。WHEP

WebRTC player 可以显示来自 webrtc-streamer 的 WebRTC 流.

一个最简化的例子: Live Demo

<html>
<head>
    <script src="https://unpkg.com/@eyevinn/whep-video-component@latest/dist/whep-video.component.js"></script>
</head>
<body>
    <whep-video id="video" muted autoplay></whep-video>
    <script>
        video.setAttribute('src', `${location.origin}/api/whep?url=Asahi&options=rtptransport%3dtcp%26timeout%3d60`);
    </script>
</body>
</html>

使用 tensorflow.js 进行物体检测

Live Demo

连接到 Janus Gateway 视频房间。

Janus Gateway
JanusVideoRoom

var janus = new JanusVideoRoom(<janus url>, <webrtc-streamer url>)

<html>
<head>
<script src="janusvideoroom.js" ></script>
<script>        
	var janus = new JanusVideoRoom("https://janus.conf.meetecho.com/janus", null);
	janus.join(1234, "rtsp://pi2.local:8554/unicast","pi2");
	janus.join(1234, "rtsp://wowzaec2demo.streamlock.net/vod/mp4:BigBuckBunny_115k.mov","media");	    
</script>
</head>
</html>

连接到 Jitsi 会议

XMPPVideoRoom

var xmpp = new XMPPVideoRoom(<xmpp server url>, <webrtc-streamer url>)

<html>
<head>
<script src="libs/strophe.min.js" ></script>
<script src="libs/strophe.muc.min.js" ></script>
<script src="libs/strophe.disco.min.js" ></script>
<script src="libs/strophe.jingle.sdp.js"></script>
<script src="libs/jquery-3.5.1.min.js"></script>
<script src="xmppvideoroom.js" ></script>
<script>        
	var xmpp = new XMPPVideoRoom("meet.jit.si", null);
	xmpp.join("testroom", "rtsp://wowzaec2demo.streamlock.net/vod/mp4:BigBuckBunny_115k.mov","Bunny");	    
</script>
</head>
</html>

Live Demo

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.dtcms.com/a/120188.html

相关文章：

  • gbase8s之逻辑导出导入脚本（完美版本）
  • Linux:进程程序替换execl
  • 实习技能记录【3】-----Git操作
  • 编写junit测试类 import org.junit.Test；
  • 最新 OpenHarmony 系统一二级目录整理
  • 【详细图文】在VScode中配置python开发环境
  • ReplicaSet、Deployment功能是怎么实现的？
  • C语言：字符串处理函数strstr分析
  • BUUCTF-web刷题篇(14)
  • 边缘计算革命：低功耗GPU在自动驾驶实时决策中的应用
  • [ctfshow web入门] web25
  • 通过扣子平台将数据写入飞书多维表格
  • rockylinux 8 9 升级到指定版本
  • excel的逻辑类型函数（主要包括if、and、or、not、xor、iserror、iferror、true、false、ifs、ifna、switch）
  • 迁移WordPress网站(大文件版本)
  • 任务扩展-输入商品原价，折扣并计算促销后的价格
  • 二十八- Scala
  • 使用LangChain Agents构建Gradio及Gradio Tools（6）——创建自己的GradioTool
  • 关于软件bug描述
  • 核心案例 | 湖南汽车工程职业大学无人机操控与编队技术实验室
  • 引入模型的知识点整理（Three.js）
  • 阅读笔记“BFMSense”
  • MVS 无监督学习
  • docker各种清空缓存命令，下载jdk包总失败，执行完好了
  • BUUCTF-web刷题篇(15)
  • SeaTunnel系列之：部署SeaTunnel的Spark和Flink引擎
  • 时序数据库 TDengine Cloud 私有连接实战指南：4步实现数据安全传输与成本优化
  • (二）链表结构
  • Redis-一般操作
  • 深入理解CSS对齐属性：align-items, align-self, justify-items, justify-self