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

开始直播

最后更新 查看 MarkdownAgent 设置

订阅 Stream 后,您可以在 Dash 或通过 API 创建 Live Inputs。使用 RTMPS 或 SRT 向新的 Live Input 广播。SRT 支持更新的视频编解码器,并更便于使用字幕和多音轨等无障碍功能。

首次直播? 您需要软件将视频发送到 Cloudflare。了解如何使用 OBS Studio 在 Stream 上开播。

使用仪表板

步骤 1: 在 Cloudflare 仪表板中,前往 Live inputs(直播输入) 页面并创建直播输入。

前往 Live inputs(直播输入) ↗从仪表板创建直播输入字段

步骤 2: 复制 RTMPS URL 和 key,并在直播应用中配合使用。我们建议使用 Open Broadcaster Software (OBS) ↗ 快速入门。

RTMPS URL 字段示例

步骤 3: 开播并在 Stream 仪表板中预览直播

在 Stream 仪表板中,开播后几秒内,您将看到观众将看到的内容预览。要将直播视频播放添加到网站或应用,请参阅 播放视频。

使用 cf 或 API

要以编程方式创建直播输入,请使用 cf,或向 /live_inputs API 端点发送 POST 请求:

Using cfbash
cf stream live-inputs create
API Requestbash
curl -X POST \
--header "Authorization: Bearer <API_TOKEN>" \
--data '{"meta": {"name":"test stream"},"recording": { "mode": "automatic" }}' \
https://api.cloudflare.com/client/v4/accounts/{account_id}/stream/live_inputs

无论使用哪种方式,响应都会包含直播输入的详细信息:

Responsejson
{
	"uid": "f256e6ea9341d51eea64c9454659e576",
	"rtmps": {
		"url": "rtmps://live.cloudflare.com:443/live/",
		"streamKey": "MTQ0MTcjM3MjI1NDE3ODIyNTI1MjYyMjE4NTI2ODI1NDcxMzUyMzcf256e6ea9351d51eea64c9454659e576"
	},
	"created": "2021-09-23T05:05:53.451415Z",
	"modified": "2021-09-23T05:05:53.451415Z",
	"meta": {
		"name": "test stream"
	},
	"status": null,
	"recording": {
		"mode": "automatic",
		"requireSignedURLs": false,
		"allowedOrigins": null,
		"hideLiveViewerCount": false
	},
	"enabled": true,
	"deleteRecordingAfterDays": null,
	"preferLowLatency": false
}

可选 API 参数

/live_inputs 的 API 参考文档

  • enabled boolean 默认值:true

    • 控制直播输入是否接受传入广播。设为 false 时,直播输入将拒绝任何传入的 RTMPS 或 SRT 连接。使用此属性以编程方式结束创作者广播或阻止在特定输入上开始新广播。
  • preferLowLatency boolean 默认值:false Beta

    • 设为 true 时,此直播输入将启用 Beta 版 Low-Latency HLS 管道。Stream 内置播放器将在可能时自动使用 LL-HLS。(recording 的 mode 属性也必须设为 automatic。)
  • deleteRecordingAfterDays integer 默认值:null(任意)

    • 指定录制(而非输入)将被删除的日期和时间。此属性从录制可供流式传输并 ready 时起生效。录制删除后,将无法观看,且不再计入计费存储。最小值为 30,最大值为 1096。

      直播结束时,如果存在 deleteRecordingAfterDays 值,将计算 scheduledDeletion 时间戳。

      注意,如果在直播进行时向直播输入添加此值,该属性仅适用于未来的直播。

  • timeoutSeconds integer 默认值:0

    • timeoutSeconds 属性指定直播源断开连接多长时间后会导致创建新视频。

以下四个属性嵌套在 recording 对象下。

  • mode string 默认值:off

    • 当 mode 属性设为 automatic 时,直播流将自动可通过 HLS/DASH 观看。此外,直播流将自动录制以供后续重播。默认情况下,录制模式设为 off,输入不会被录制或可供播放。
  • requireSignedURLs boolean 默认值:false

    • requireSignedURLs 属性指示观看视频是否需要 signed URLs。此设置默认应用于从输入录制的所有视频。此外,如果通过直播输入 ID 观看视频,此字段优先于任何视频级别设置。
  • allowedOrigins integer 默认值:null(任意)

    • allowedOrigins 属性可选地提供允许的 origin 列表。此设置默认应用于从输入录制的所有视频。此外,如果通过直播输入 ID 观看视频,此字段优先于任何视频级别设置。
  • hideLiveViewerCount boolean 默认值:false

    • 限制访问直播观众数,并从播放器中移除该值。

管理直播输入

更新直播输入

通过发送 PUT 请求更新直播输入:

Requestbash
curl --request PUT \
https://api.cloudflare.com/client/v4/accounts/{account_id}/stream/live_inputs/{input_id} \
--header "Authorization: Bearer <API_TOKEN>" \
--data '{"meta": {"name":"test stream 1"},"recording": { "mode": "automatic", "timeoutSeconds": 10 }}'

启用或禁用直播输入

直播输入默认处于启用状态。禁用后,直播输入会拒绝传入的 RTMPS 和 SRT 连接。使用此功能可以在不删除直播输入的情况下暂时暂停它、终止正在进行的广播,并阻止在特定输入上开始新广播。

要禁用直播输入,将 enabled 设为 false:

Requestbash
curl --request PUT \
https://api.cloudflare.com/client/v4/accounts/{account_id}/stream/live_inputs/{input_id} \
--header "Authorization: Bearer <API_TOKEN>" \
--data '{"enabled": false}'

要重新启用直播输入,将 enabled 设为 true:

Requestbash
curl --request PUT \
https://api.cloudflare.com/client/v4/accounts/{account_id}/stream/live_inputs/{input_id} \
--header "Authorization: Bearer <API_TOKEN>" \
--data '{"enabled": true}'

轮换广播密钥

在凭据可能被分享给错误受众、暴露在客户端代码或屏幕共享中,或需要作为安全流程的一部分刷新时,轮换直播输入的广播凭据。轮换密钥不会更改直播输入 ID 或其他配置。

轮换密钥后,旧凭据会被撤销,使用过期凭据的广播会断开连接,API 响应会返回刷新后的凭据。

Requestbash
curl --request POST \
https://api.cloudflare.com/client/v4/accounts/{account_id}/stream/live_inputs/{input_id}/rotate_keys \
--header "Authorization: Bearer <API_TOKEN>"

直播输入响应包含 keysRotatedAt,用于指示直播输入密钥的上次轮换时间。从未轮换过密钥的直播输入会省略此字段。

删除直播输入

通过发送 DELETE 请求删除直播输入:

Requestbash
curl --request DELETE \
https://api.cloudflare.com/client/v4/accounts/{account_id}/stream/live_inputs/{input_id} \
--header "Authorization: Bearer <API_TOKEN>"

要求、建议和限制

如果您遇到缓冲、冻结、延迟或其他类似问题,请访问 直播故障排除。

要求

  • Stream Live 仅支持 H.264 视频和 AAC 音频编解码器作为输入。对于 AAC 音频,支持 ADTS,但不支持 LATM。
  • 输入的合并码率应介于 2 Mbps 和 14 Mbps 之间。
  • 客户端必须配置为在断开连接时重连。Stream Live 设计为通过继续直播流来优雅处理重连。
  • GOP 时长 ↗(关键帧间隔)必须介于 2 到 10 秒之间。需要 Closed GOP,大多数编码器默认启用此设置。

建议

  • 为直播流使用适当的码率,通常低于 10 Mbps。高运动、高帧率内容应使用更高码率,而幻灯片演示等低运动内容应使用较低码率。
  • 使用标准 HLS/DASH 播放时,GOP 大小(关键帧间隔)应介于 4 到 8 秒之间。大多数编码软件和硬件(包括 Open Broadcaster Software (OBS))的默认值在此范围内。设置较短 GOP 将减少观众延迟,同时降低编码效率。设置较长 GOP 时长将提高编码效率和带宽利用率,但会增加观众延迟。这是 HLS 封装固有的权衡,而非 Cloudflare Stream 的限制。
  • 在可能的情况下,选择 CBR(恒定码率)而非 VBR(可变码率)。

Low-Latency HLS 广播建议 Beta

  • LL-HLS 不支持 B Frames,会导致播放抖动。关闭 B Frames 或将其设为 0。
  • 对于 LL-HLS,使用 2 - 4 秒的 GOP 大小(关键帧间隔)。
  • 如有可能,广播到 RTMP 端点,否则使用 SRT。
  • 如果使用 OBS,选择 ultra low(超低) 延迟配置文件。

限制

  • 水印尚不能用于直播视频。
  • 如果直播视频超过七天,录制将被截断为七天。仅前七天的直播视频内容将被录制。

这篇文档对您有帮助吗?