API 文档

概述

最近更新时间:2021-01-12 14:52:51

说明:

  • 当前页面接口为旧版 API,未来可能停止维护。云直播服务 API 3.0 版本接口定义更加规范,访问时延下降显著,建议使用 云直播 API 3.0
  • 如果您需要访问云直播旧版 API,可参见 API 概览

云直播 API 围绕的是如何对直播流进行管理,腾讯云提供了两种模式,即直播码模式(新)和频道模式(旧)。

直播码模式

直播码模式主要是为方便客户后台直接管理直播流而设计的,由于接入成本低且可靠性高而成为了云直播服务的主流接入方案,该方案的设计思路就是地址生成和直播流尽量由您自行掌握,因此有很强的自由度和定制型,是游戏直播、秀场直播等平台类直播场景的首选接入方案。

频道(托管)模式

频道模式是为手动管理直播频道量身定制的,如果您是做单场次的直播活动,比较适合这种模式。
操作如下:

  • 创建频道:开始活动前,先创建一个频道,然后获得推流地址,并将播放地址传播出去。
  • 关闭频道:直播结束后或者有意外情况发生时,可以随时关闭直播频道,也就是所谓的禁播。

该模式也提供了服务端的 API 支持,但接入成本较直播码模式要高出很多,且稳定性不及直播码模式。

两种模式的区别

对比项 直播码模式 频道模式
推流地址 您可以自由指定,无需跟腾讯云后台通讯 通过创建频道的方式在腾讯云后台生成
防盗链 支持推流和播放防盗链(播放防盗链配置请联系客服,rtmp 播放防盗链暂不支持) 支持推流防盗链、FLV 和 HLS 播放防盗链(rtmp 播放防盗链暂不支持)
API 列表 直播码模式 API 频道模式 API
消息通知 流状态变化时会以 JSON 格式的消息通知给您 不支持
适用场景 适合服务器对接,例如秀场直播 适合手工操作,例如一场直播活动
目录