适用场景
您也可以事先配置录制配置,但是设置默认行为是不录制(设置ondemand=7),直接通过手动录制的接口启动某条直播流的录制。
如果某条直播流正在录制(可能是自动录制,也可能是手动录制启动的),您也可以通过手动录制的接口停止该直播流的录制。
使用流程
- 调用AddLiveAppRecordConfig接口配置录制规则。设置ondemand=7,表示推流后不自动录制。
- 推流
- 调用RealTimeRecordCommand接口启动录制。
- (如果需要)调用RealTimeRecordCommand接口停止录制。
涉及到的API包括:
API名称 | 说明 |
---|---|
AddLiveAppRecordConfig | 配置自动录制规则 |
DeleteLiveAppRecordConfig | 如果不再需要某项规则,可以通过该接口删除。 |
DescribeLiveRecordConfig | 查询所有配置的规则 |
RealTimeRecordCommand | 实时录制命令,可控制手动启动录制和手动停止录制。 |
API接口详情:
4. 实时录制命令,可控制手动启动录制和手动停止录制
调用RealTimeRecordCommand按需完成手动录制。例如,动态地启动、停止录制 。
您可以事先配置录制配置,但是设置默认行为是不录制(AddLiveAppRecordConfig设置OnDemand=7),直接通过手动录制的接口启动某条直播流的录制。
如果某条直播流正在录制(可能是自动录制,也可能是手动录制启动的),您也可以通过手动录制的接口停止该直播流的录制。
手动启动录制的直播流如果发生了断流,就会停止录制,并且重新推流后不会自动启动录制(如果没有配置自动录制)。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | RealTimeRecordCommand |
系统规定参数。取值:RealTimeRecordCommand。 |
AppName | String | 是 | testApp |
App名。 |
Command | String | 是 | start |
操作行为。支持start、stop两种类型。 |
DomainName | String | 是 | test.com |
您的加速域名。 |
StreamName | String | 是 | testStream |
直播流名。 |
RegionId | String | 否 | cn-shanghai |
区域。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 |
请求ID |