跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

使用 WebRTC 实现超低延迟

最后更新 查看 MarkdownAgent 设置

WebRTC 支持使用 WHIP 进行超低延迟(亚秒级)直播,并使用 WHEP 向数千名并发观众播放。WebRTC 非常适合需要实时体验的一对多广播,例如:

  • 直播结果具有时效性:游戏、体育赛事、财经新闻
  • 观众与内容互动:在线教育、直播问答、拍卖

WebRTC 也非常适合创作者平台或浏览器内体验,因为您的用户可以 无需 专用广播应用或专用硬件编码器即可开播。

步骤 1:创建直播输入

通过以下两种方式之一创建直播输入:

向 /live_inputs 发送 POST 请求的 API 响应json
{
  "uid": "1a553f11a88915d093d45eda660d2f8c",
 ...
  "webRTC": {
    "url": "https://customer-<CODE>.cloudflarestream.com/<SECRET>/webRTC/publish"
  },
  "webRTCPlayback": {
    "url": "https://customer-<CODE>.cloudflarestream.com/<INPUT_UID>/webRTC/play"
  },
...
}

步骤 2:使用 WHIP 开播

从浏览器广播

每个直播输入都有一个唯一 URL,供一位创作者推流。这是凭据,仅 应分享给创作者——任何拥有此 URL 的人都可以向该输入推流。

获取 WHIP 端点 URL:

要查看从浏览器开播的完整无依赖示例,请参阅在浏览器中完成首次 WebRTC 广播教程。

您也可以将此 URL 与任何支持 WebRTC-HTTP Ingestion Protocol (WHIP) ↗ 的客户端配合使用。请参阅支持的 WHIP 客户端 了解我们已测试并确认与 Cloudflare Stream 兼容的客户端列表。

从其他软件广播(OBS、FFmpeg)

使用 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 是一种内存分配策略,不会增加延迟。

步骤 3:使用 WHEP 播放直播视频

使用 Stream Player: Stream 内置播放器已支持播放 WebRTC 广播,并会在可用时自动升级到 WHEP。更多信息请参阅「使用 Stream Player」。可在仪表板中直播输入的设置页面生成播放器嵌入代码。

在自定义播放器中使用 WHEP 端点:

从以下位置复制 URL:

只要创作者正在推流,观众即可在浏览器中观看广播,延迟低于 500 毫秒。并发观众数量没有固定上限。

要查看在浏览器中播放 WebRTC 的完整无依赖示例,请参阅在浏览器中完成首次 WebRTC 广播教程。

此 URL 也可以与任何支持 WebRTC-HTTP Egress Protocol (WHEP) ↗ 的客户端配合使用。请参阅支持的 WHEP 客户端 了解我们已测试并确认与 Cloudflare Stream 兼容的客户端列表。

调试 WebRTC

  • Chrome:导航至 chrome://webrtc-internals 查看详细日志和图表。
  • Firefox:导航至 about:webrtc 查看 WebRTC 会话信息,与 Chrome 类似。
  • Safari:要启用 WebRTC 日志,在检查器中打开设置选项卡(齿轮图标),在下拉菜单中将 WebRTC logging 设为 "Verbose"。

支持的 WHIP 和 WHEP 客户端

您可以使用浏览器原生 WebRTC API 编写自己的广播和发布应用——请参阅在浏览器中完成首次 WebRTC 广播教程。除原生代码外,我们已测试并确认以下客户端与 Cloudflare Stream 兼容:

WHIP for Broadcasting

专用应用:

开发库:

WHEP for Playback

在原生应用中使用 WebRTC

如果您正在构建原生应用,在浏览器中完成首次 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)

符合 WHIP 和 WHEP 规范

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 目前不符合录制条件,因此不会消耗存储。

这篇文档对您有帮助吗?