跳转到内容
搜索文档

直播 DVR

最后更新 查看 MarkdownAgent 设置

Stream Live 支持按需启用「DVR 模式」,让观众可以倒带、恢复和快进直播广播。要启用 DVR 模式,请在 Stream Player 嵌入源或 HLS manifest URL 中添加 dvrEnabled=true 查询参数。

Stream Player

Stream Player 嵌入格式html
<div style="position: relative; padding-top: 56.25%;">
  <iframe
    src="https://customer-<CODE>.cloudflarestream.com/<INPUT_ID|VIDEO_ID>/iframe?dvrEnabled=true"
    style="border: none; position: absolute; top: 0; left: 0; height: 100%; width: 100%;"
    allow="accelerometer; gyroscope; autoplay; encrypted-media; picture-in-picture;"
    allowfullscreen="true"
  ></iframe>
</div>

启用 DVR 模式后,Stream Player 将:

  • 显示观众可以拖动/定位的时间轴,类似于观看点播视频。时间轴将自动缩放以显示广播进行时不断增长的长度。
  • 「LIVE」指示器在观众落后于直播边缘时显示灰色,在观看最新内容时显示红色。点击该指示器将跳转到直播边缘。
  • 如果观众暂停播放器,将从该时间点恢复播放,而非跳转到直播边缘。

自定义播放器的 HLS manifest

HLS manifest URL 格式text
https://customer-<CODE>.cloudflarestream.com/<INPUT_ID|VIDEO_ID>/manifest/video.m3u8?dvrEnabled=true

使用支持 DVR 的 HLS manifest 的自定义播放器可能需要额外配置以显示有用的控件或信息。请参阅您的播放器库了解更多信息。

Video ID 或 Input ID

Stream Live 允许通过 Video ID 或 Live Input ID 加载 Player 或 HLS manifest。请参阅 观看直播 了解如何检索这些 URL 并比较这些选项。使用 DVR 模式时有额外考虑因素:

推荐: 在 Video ID URL 上使用 DVR 模式:

  • 播放器加载时,如果广播仍在直播,将开始播放活动广播;如果广播已结束,将播放录制。

在 Live Input ID URL 上使用 DVR 模式:

  • 播放器加载时,如果有正在进行的直播广播,将开始播放(请参阅 直播输入状态)。
  • 如果观众在 广播结束后 仍在观看,可以继续观看。但是,如果随后重新加载播放器或 manifest,将显示最新广播或「Stream has not yet started」(HTTP 204)。无法通过 Live Input ID 访问过去的广播。

已知限制

  • 使用 DVR 模式以及通过 Live Input ID 创建的播放器/manifest 时,如果观众在广播结束后仍在观看,播放器在尝试切换质量级别时可能会停滞。
  • 超过三小时的 DVR 启用广播性能可能下降。Manifest 最多限制 7,200 个片段。片段长度由关键帧间隔(也称为 GOP 大小)决定。
  • DVR 模式依赖 HLS manifest 规范第 8 版。Stream 在其他所有上下文中使用 HLS 第 6 版。HLS v8 提供极其广泛的兼容性,但可能无法与某些旧播放器库或旧设备配合使用。
  • DASH manifest 不支持 DVR 模式。

这篇文档对您有帮助吗?