旁路直播

本文仅描述通过服务端RESTful API接口来实现旁路直播功能,如需要了解通过SDK API来实现旁路直播,请查阅SDK接口文档相关说明。

旁路直播服务提供RESTful API,无需集成SDK,直接通过网络请求开启和控制旁路直播,在自己的网页或应用中灵活使用。

通过 RESTful API,你可以发送网络请求启动和停止旁路直播:

  • 旁路直播服务 RESTful API 仅支持 HTTPS 协议

旁路直播服务提供推流状态回调服务,开通后你可以收到旁路直播的事件通知,你可以根据自己的需要选择是否开通回调服务,如需配置请联系技术支持

1 前提条件

  • 已经有集成了Thunder SDK的应用;
  • 已开通第三方直播推流服务,如阿里云等;

2 实现旁路直播

2.1 接口鉴权认证

在发送RESTful API请求时,需使用AppID和secretKey计算出对应鉴权信息填入HTTPS请求头部,通过签名认证来识别合法请求。
在应用申请通过后,业务可在开发者平台获取AppID和secretKey。具体签名认证方法请参考 签名认证

2.2 RESTful API交互时序图

img

startrtmp更新混画布局和推流地址是可选的,且可以多次调用,但是必须在启动推流之后和停止推流之前调用。

2.3 步骤一: 启动推流

调用 startrtmp 方法启动旁路直播。

调用该方法时,你需要指定一个uid(源流推流)或者混画任务id(旁路直播)并设置相关推流参数。

uid或者混画任务id具有唯一性
推流地址具有唯一性,不同任务不能重复推流,同一任务可以设置多个推流地址

该方法的请求和响应示例详见 startrtmp 示例

2.4 步骤二: 停止推流

在启动推流后,调用 stoprtmp 方法停止旁路直播。

该方法的请求和响应示例详见 stoprtmp 示例

2.5 可选步骤:更新混流布局

在启动旁路直播后,可以重复调用 startrtmp 方法来更新推流的混流布局。 该方法的请求和响应同 startrtmp 示例

3 注意事项

<