视频直播录制可对当前直播实时录制并可回放历史直播视频。本文将详细为您介绍视频直播录制功能。
功能介绍
直播录制提供了录制直播内容、录制索引管理、录制文件管理、录制事件回调的功能。
- 录制直播内容
- 使用场景
视频直播是通过播放地址以实时流的形式播放推流端的数据,如果想要在直播结束后再次观看或修改直播内容,就必须要使用视频直播的录制功能。
- 功能介绍
视频直播录制功能,就是将直播中心接收到的推流数据进行录制,将录制后的数据以HLS协议的封装格式,保存至您指定的存储位置。支持M3U8(同时会有.ts分片文件)、MP4、FLV格式。
直播录制支持将直播内容录制至VOD或OSS。录制到VOD可以联动使用VOD的云剪辑、媒资管理、播控管理等能力。
- 使用方法
请参见直播录制使用方法。
- 使用场景
- 录制索引管理
说明 您只有将视频存储在OSS中才可使用录制索引功能。
- 使用场景
视频直播录制在直播过程中会生成TS文件,但是仅在推流结束180秒后才会生成m3u8索引文件,无法在直播过程中生成,并且该索引文件时间为推流开始到结束,用户无法根据业务需要自定义索引范围。因此,视频直播提供录制索引管理功能,供用户对录制索引m3u8文件进行管理。
- 功能介绍
在一次推流结束时,会自动生成本次推流的录制索引文件。同时支持按照指定的录制开始时间和录制结束时间生成自定义录制索引文件。录制索引功能包括查看录制索引和剪辑录制索引两项功能。
- 查看录制索引:用户可以查看已有的录制索引文件,这里的索引文件包括系统在断流180秒后自动生成的索引文件,以及用户手动创建的索引文件。
- 剪辑录制索引:用户可以根据现有的录制索引文件进行剪辑,产生新的索引文件,这里的索引文件可以是对之前已有的索引文件进行合并或者拆分。
- 使用方法
请参见录制索引管理方法。
- 使用场景
- 录制文件管理
- 录制事件回调
- 功能介绍
直播录制回调包括录制状态回调、文件生成回调。
- 录制状态回调:在文件开始录制与结束录制时发出,主要表示文件已经开始和结束录制。
- 文件生成回调:在文件生成时发出,主要包括文件名称,开始结束时间与时长信息。
- 使用方法
请参见直播录制回调。
- 功能介绍
直播录制规则
- 直播录制是针对推流的
AppName
为粒度设置的。您可以设置某个AppName
下的所有StreamName
的录制规则。并且AppName
取值为星号(*)时 ,表示此录制规则适用于该直播域名下的所有推流。推流的AppName
需要和配置的AppName
相同。也可以针对单路流进行录制。说明 同时配置了AppName
级别的录制和单路流录制,单路流录制配置的优先级更高。 - 录制设置仅会对配置完成后的新发起的推流记录生效,当前的推流需中断180秒后重新推流方可生效。
- 录制至VOD时,生成的M3U8和TS文件都存放在视频点播的输入媒体Bucket中。更多详情。请参见添加媒体Bucket。
- 如果使用录制至OSS,您需要事先创建好OSS Bucket。OSS Bucket必须与域名的直播中心同地域,不支持跨地域录制。
- 相同的
AppName
和StreamName
不能同时存储至VOD和OSS。
直播录制使用方法
录制至… | 使用流程 | 控制台操作 | API操作 |
---|---|---|---|
录制至VOD | 准备工作:开通点播服务。 | 开通视频点播 | 不涉及 |
录制配置:
|
AddLiveRecordVodConfig | ||
使用点播功能进行云剪辑、媒资管理、播控等操作。 | 控制台介绍 | API概览 | |
录制至OSS | 准备工作:完成OSS配置。
|
配置OSS | 不涉及 |
录制配置:
配置录制信息。 |
录制存储至OSS | AddLiveAppRecordConfig |
IClientProfile profile = DefaultProfile.getProfile("cn-shanghai","<AccessKeyId>", "<AccessKeyScret>");
IAcsClient client = new DefaultAcsClient(profile);
AddLiveAppRecordConfigRequest addLiveAppRecordConfigRequest = new AddLiveAppRecordConfigRequest();
addLiveAppRecordConfigRequest.setDomainName("<DomainName>");
addLiveAppRecordConfigRequest.setAppName("<AppName>");
addLiveAppRecordConfigRequest.setOssEndpoint("<Endpoint>");
addLiveAppRecordConfigRequest.setOssBucket("<BucketName>");
addLiveAppRecordConfigRequest.setOssObjectPrefix("<ObjectPrefix>");
try {
AddLiveAppRecordConfigResponse addLiveAppRecordConfigResponse = client.getAcsResponse(addLiveAppRecordConfigRequest);
System.out.println(addLiveAppRecordConfigResponse.getRequestId());
// todo something.
} catch (ServerException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (ClientException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
录制索引管理方法
功能 | 控制台操作 | API操作 |
---|---|---|
查看录制索引 | 在视频直播控制台的 页面,单击存储至OSS页签查看。
这里的索引文件包括系统在断流180秒后自动生成的索引文件,以及用户手动创建的索引文件。 |
|
剪辑录制索引 | 剪辑录制索引文件 | CreateLiveStreamRecordIndexFiles |
录制文件管理方法
查看和管理录制文件:您可以在控制台进行查看和管理录制文件的操作。
- 录制至VOD
- 录制至OSS
API和SDK提供DescribeLiveStreamRecordContent接口查询直播录制内容。
过期删除录制文件:由于媒体资源均存放在OSS的Bucket中,需要授权访问才能正常删除录制文件,您可以点击授权进行一键授权。授权后,再提交工单申请,我们会在后台为您配置您需要的过期时间。关于如何提交工单,请参见联系我们。配置过期时间后,录制文件过期删除功能授权操作即为完成。