CreateLiveStreamRecordIndexFiles_视频直播_API调试-阿里云OpenAPI开发者门户

接口说明

您已配置 OSS，具体操作，请参见配置 OSS。直播录制索引是将视频直播流以 M3U8 的格式进行录制，存储在 OSS 中后，对已存储的 TS 分片索引文件进行实时的剪辑处理。

说明

创建录制索引必保证直播流发生过推流行为，如果设置的时间内未发生过直播或直播流名称错误等会导致创建录制索引失败。

StartTime 和 EndTime 的差值至少是一片 TS 的时长（默认为 30s）。

TS 分片信息在视频直播系统中仅保存 3 个月，创建 M3U8 文件只能选择最近 3 个月的录制内容。

TS 分片文件存储在 OSS 中，保存时间由 OSS 的存储配置决定。详细信息，请参见设置生命周期规则。

创建好的 M3U8 索引文件的信息在视频直播系统中仅保存 6 个月，若要查询仅能查询 6 个月内创建的索引文件的信息。

M3U8 索引文件存储在 OSS 中，保存时间由 OSS 的存储配置决定。

QPS 限制

本接口的单用户 QPS 限制为 45 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。

请求参数

字段名称	字段详情
DomainNamestring	主播流域名。示例值:example.com参考取值来源: AddLiveDomain DescribeDomainUsageData ListLiveRealtimeLogDeliveryDomains
AppNamestring	播流所属应用名称。AppName 名称与推流地址中的 AppName 名称对应，模板才能生效。若不限制 AppName 可填，即可匹配所有 AppName。示例值:liveApp***参考取值来源: GetMessageApp ListMessageApp QueryMessageApp CreateMessageApp
StreamNamestring	播流名称。StreamName 名称与推流地址中的 StreamName 名称对应，模板才能生效。若不限制 StreamName 可填，即可匹配所有 StreamName。示例值:liveStream***参考取值来源: AddLiveStreamMerge DescribeMixStreamList QueryLiveDomainMultiStreamList
OssEndpointstring	OSS 存储 Endpoint 名称。示例值:cn-oss-****.aliyuncs.com
OssBucketstring	OSS 存储 Bucket 名称。示例值:liveBucket****
OssObjectstring	OSS 存储的录制文件名。示例值:{AppName}/{StreamName}/{Date}/{Hour}/{Minute}_{Second}.m3u8
StartTimestring	索引文件的开始时间。ts 文件的上传时间在此之后则会被包含进索引文件。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。示例值:2017-12-21T08:00:00Z
EndTimestring	索引文件的结束时间。ts 文件的上传时间在此之前则会被包含进索引文件。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。示例值:2017-12-22T08:00:00Z
EndTimeIncludedboolean	是否包含结束时间。传 true 会尝试多包含一个 ts 文件，创建的索引文件会完整覆盖 StartTime 和 EndTime。示例值:false

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:550439A3-F8EC-4CA2-BB62-B9DB43EEEF30
RecordInfoobject	录制配置信息。

变更历史

暂无变更历史