WebRTC 支持使用 WHIP 进行超低延迟(亚秒级)直播,并使用 WHEP 向数千名并发观众播放。WebRTC 非常适合需要实时体验的一对多广播,例如:
- 直播结果具有时效性:游戏、体育赛事、财经新闻
- 观众与内容互动:在线教育、直播问答、拍卖
WebRTC 也非常适合创作者平台或浏览器内体验,因为您的用户可以 无需 专用广播应用或专用硬件编码器即可开播。
通过以下两种方式之一创建直播输入:
-
使用 Cloudflare 仪表板的 Live inputs(直播输入) 页面,然后在 Broadcast 和 Playback 选项卡下获取 WebRTC URL。
前往 Live inputs(直播输入) ↗ -
向
/live_inputsAPI 端点 发送 POST 请求
{
"uid": "1a553f11a88915d093d45eda660d2f8c",
...
"webRTC": {
"url": "https://customer-<CODE>.cloudflarestream.com/<SECRET>/webRTC/publish"
},
"webRTCPlayback": {
"url": "https://customer-<CODE>.cloudflarestream.com/<INPUT_UID>/webRTC/play"
},
...
}每个直播输入都有一个唯一 URL,供一位创作者推流。这是凭据,仅 应分享给创作者——任何拥有此 URL 的人都可以向该输入推流。
获取 WHIP 端点 URL:
-
Cloudflare 仪表板的 Live inputs(直播输入) 页面。
前往 Live inputs(直播输入) ↗ -
创建输入时 API 响应中的
webRTC.url属性。
要查看从浏览器开播的完整无依赖示例,请参阅在浏览器中完成首次 WebRTC 广播教程。
您也可以将此 URL 与任何支持 WebRTC-HTTP Ingestion Protocol (WHIP) ↗ 的客户端配合使用。请参阅支持的 WHIP 客户端 了解我们已测试并确认与 Cloudflare Stream 兼容的客户端列表。
使用 OBS 31.0 或更高版本: 广播 WebRTC/WHIP 的推荐设置。在 Settings 中:
- 在 Stream 选项卡
- Service: WHIP
- Server: 粘贴来自 Cloudflare Stream 的完整 WebRTC (WHIP) URL
- 广播密钥是此 URL 的一部分,将 "Bearer Token" 留空
- 在 Output 选项卡
- Audio Encoder: FFmpeg Opus (或其他可用的 Opus 编码器)
- Video Encoder: x264 (或 QuickSync、NVENC 等硬件加速 H.264 编码器)
- Rate Control:
CBR或VBR - Bitrate: 介于 3000 Kbps 和 7000 Kpbs 之间
- Profile:
main或baseline - B Frames: 0
- 在 Video 选项卡
- Framerate: 该字段可能称为 "Common FPS Values" 或 "Integer FPS Value",设为 30
使用 FFmpeg 8.1 或更高版本: 此示例命令输出时钟和恒定音调。请根据您的内容修改输入参数。
ffmpeg -hide_banner -y \
-re -f lavfi -i testsrc=size=1920x1080:rate=30 \
-re -f lavfi -i "sine=frequency=200" \
-vf "drawtext=fontsize=120:text='%{gmtime}.%{eif\:1M*t-1K*trunc(t\*1K)\:d}':x=0:y=0:fontcolor=WhiteSmoke:box=1:[email protected]" \
-c:v libx264 -flags +global_header -maxrate 4000k -bufsize 1500k \
-tune zerolatency -g 30 -profile:v baseline -pix_fmt yuv420p \
-acodec libopus -b:a 128k -ar 48000 -ac 2 \
-ts_buffer_size 16777216 \
-f whip https://customer-igynxd2rwhmuoxw8.cloudflarestream.com/71adb6d1676e2aa8d42ddce2271a2aedk5b6efd743b78487c095b2911e08345d8/webRTC/publish如果使用 Windows/PowerShell:
- 在
vf字符串中添加:fontfile='C\:/Windows/Fonts/consola.ttf';Windows 环境必须指定字体 - 使用反引号 ``` 而不是反斜杠来分隔多行命令
FFmpeg 的 WHIP 支持目前要求使用 baseline 的 libx264。ts_buffer_size 是一种内存分配策略,不会增加延迟。
使用 Stream Player: Stream 内置播放器已支持播放 WebRTC 广播,并会在可用时自动升级到 WHEP。更多信息请参阅「使用 Stream Player」。可在仪表板中直播输入的设置页面生成播放器嵌入代码。
在自定义播放器中使用 WHEP 端点:
从以下位置复制 URL:
-
Cloudflare 仪表板的 Live inputs(直播输入) 页面。
前往 Live inputs(直播输入) ↗ -
创建输入时 API 响应中的
webRTCPlayback.url属性。
只要创作者正在推流,观众即可在浏览器中观看广播,延迟低于 500 毫秒。并发观众数量没有固定上限。
要查看在浏览器中播放 WebRTC 的完整无依赖示例,请参阅在浏览器中完成首次 WebRTC 广播教程。
此 URL 也可以与任何支持 WebRTC-HTTP Egress Protocol (WHEP) ↗ 的客户端配合使用。请参阅支持的 WHEP 客户端 了解我们已测试并确认与 Cloudflare Stream 兼容的客户端列表。
- Chrome:导航至
chrome://webrtc-internals查看详细日志和图表。 - Firefox:导航至
about:webrtc查看 WebRTC 会话信息,与 Chrome 类似。 - Safari:要启用 WebRTC 日志,在检查器中打开设置选项卡(齿轮图标),在下拉菜单中将 WebRTC logging 设为 "Verbose"。
您可以使用浏览器原生 WebRTC API 编写自己的广播和发布应用——请参阅在浏览器中完成首次 WebRTC 广播教程。除原生代码外,我们已测试并确认以下客户端与 Cloudflare Stream 兼容:
专用应用:
- OBS (Open Broadcaster Software) ↗ 31.0 或更高版本(桌面串流应用)
- Larix Broadcaster ↗(移动应用)
- FFmpeg ↗ 8.1 或更高版本(跨平台命令行应用)
开发库:
- whip-whep ↗(JavaScript,来自 WHIP 规范作者的参考实现)
- @eyevinn/whip-web-client ↗ (TypeScript)
- Stream 内置播放器
- whip-whep ↗(JavaScript,来自 WHEP 规范作者的参考实现)
- @eyevinn/webrtc-player ↗ (TypeScript)
- react-native-whip-whep ↗ (React Native)
如果您正在构建原生应用,在浏览器中完成首次 WebRTC 广播教程中的浏览器示例可在 WkWebView (iOS) ↗、WebView (Android) ↗ 或 react-native-webrtc ↗ 中运行。如果您需要在不使用 webview 的情况下使用 WebRTC,可以使用 Google 的 Java 和 Objective-C 原生 WebRTC API 实现 ↗。
- VP9 ↗
- VP8 ↗
- h264 ↗(Constrained Baseline Profile Level 3.1,在 SDP offer 的
profile-level-id参数中称为42e01f)
Cloudflare Stream 支持 WHIP ↗ 和 WHEP ↗ 规范,包括:
您可以在 WHIP 和 WHEP API 响应的 protocol-version 头中找到正在使用的 WHIP 和 WHEP 具体版本。此头的值引用每个协议的 IETF 草案标识。目前,Stream 使用 draft-ietf-wish-whip-06(预计为最终 WHIP 草案修订版)和 draft-murillo-whep-01(当前最新的 WHEP 草案)。
WHIP 和 WHEP 必须一起使用: 我们尚不支持使用 RTMP/SRT 的输入通过 WHEP 播放,也不支持使用 WHIP 的输入被录制并通过 HLS/DASH 播放。
- 不支持广播指标和播放器体验指标
- 尚不支持录制和直播 HLS 播放
- 不支持 Simulcasting(通过 RTMP/SRT 转推)
- 不支持直播观众数
Stream Live WebRTC 遵循 Stream 标准定价:每 1,000 分钟视频交付 1 美元。WebRTC 目前不符合录制条件,因此不会消耗存储。