调用CreateLiveStreamRecordIndexFiles创建某个时间范围的M3U8索引文件。
- 创建录制索引必保证直播流发生过推流行为,如果设置的时间内未发生过直播或直播流名称错误等会导致创建录制索引失败。
- TS分片信息在视频直播系统中仅保存3个月,创建M3U8文件只能选择最近3个月的录制内容。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateLiveStreamRecordIndexFiles |
系统规定参数。取值:CreateLiveStreamRecordIndexFiles。 |
AppName | String | 是 | AppName |
播流所属应用名称。 |
DomainName | String | 是 | live.yourdomain.com |
播流域名。 |
EndTime | String | 是 | 2017-12-22T08:00:00Z |
结束时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
OssBucket | String | 是 | test123 |
OSS存储Bucket名称。 |
OssEndpoint | String | 是 | oss-cn-shanghai.aliyuncs.com |
OSS存储Endpoint名称。 |
OssObject | String | 是 | {AppName}/{StreamName}/{Date}/{Hour}/{Minute}_{Second}.m3u8 |
OSS存储的录制文件名。 |
StartTime | String | 是 | 2017-12-21T08:00:00Z |
开始时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
StreamName | String | 是 | testStream |
播流名称。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RecordInfo | Struct |
录制配置信息。 |
|
RecordUrl | String | http://*****/atestObject.m3u8 |
索引文件地址。 |
DomainName | String | test.com |
播流域名。 |
AppName | String | AppName |
播流所属应用名称。 |
StreamName | String | TestStream |
播流名称。 |
StartTime | String | 2015-12-01T07:36:00Z |
开始时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
EndTime | String | 2015-12-01T07:40:00Z |
结束时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
Duration | Float | 20 |
录制时长。单位:秒。 |
Height | Integer | 480 |
视频高。 |
Width | Integer | 640 |
视频宽。 |
CreateTime | String | 2016-05-27T09:40:56Z |
创建时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
OssBucket | String | bucket |
OSS存储Bucket名称。 |
OssEndpoint | String | oss-cn-hangzhou.aliyuncs.com |
OSS存储Endpoint名称。 |
OssObject | String | atestObject.m3u8 |
OSS存储的录制文件名。 |
RecordId | String | c4d7f0a4-b506-43f9-8de3-07732c3f**** |
索引文件ID。 |
RequestId | String | 550439A3-F8EC-4CA2-BB62-B9DB43EEEF30 |
请求ID。 |
示例
请求示例
http(s)://live.aliyuncs.com/?Action=CreateLiveStreamRecordIndexFiles
&AppName=AppName
&DomainName=live.yourdomain.com
&EndTime=2017-12-22T08:00:00Z
&OssBucket=test123
&OssEndpoint= oss-cn-shanghai.aliyuncs.com
&OssObject={AppName}/{StreamName}/{Date}/{Hour}/{Minute}_{Second}.m3u8
&StartTime=2017-12-21T08:00:00Z
&StreamName=testStream
&<公共请求参数>
正常返回示例
XML
格式
<CreateLiveStreamRecordIndexFilesResponse>
<RecordInfo>
<AppName>AppName</AppName>
<CreateTime>2016-05-27T09:40:56Z</CreateTime>
<DomainName>www.yourdomain.com</DomainName>
<Duration>588.849</Duration>
<EndTime>2016-05-25T05:47:11Z</EndTime>
<Height>480</Height>
<OssBucket>bucket</OssBucket>
<OssEndpoint>oss-cn-hangzhou.aliyuncs.com</OssEndpoint>
<OssObject>atestObject.m3u8</OssObject>
<RecordId>c4d7f0a4-b506-43f9-8de3-07732c3f3d82</RecordId>
<RecordUrl>http://****/atestObject.m3u8</RecordUrl>
<StartTime>2016-05-25T05:37:11Z</StartTime>
<StreamName>testStream</StreamName>
<Width>640</Width>
</RecordInfo>
<RequestId>550439A3-F8EC-4CA2-BB62-B9DB43EEEF30</RequestId>
</CreateLiveStreamRecordIndexFilesResponse>
JSON
格式
{
"RecordInfo":{
"AppName":"AppName",
"CreateTime":"2016-05-27T09:40:56Z",
"DomainName":"www.yourdomain.com",
"Duration":588.849,
"EndTime":"2016-05-25T05:47:11Z",
"Height":480,
"OssBucket":"bucket",
"OssEndpoint":"oss-cn-hangzhou.aliyuncs.com",
"OssObject":"atestObject.m3u8",
"RecordId":"c4d7f0a4-b506-43f9-8de3-07732c3f3d82",
"RecordUrl":"http://****/atestObject.m3u8",
"StartTime":"2016-05-25T05:37:11Z",
"StreamName":"testStream",
"Width":640
},
"RequestId":"550439A3-F8EC-4CA2-BB62-B9DB43EEEF30"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | StartTime参数错误,请您确认该StartTime参数是否正确。 |
400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | 结束时间错误,请您确认结束时间是否正确。 |
400 | InvalidEndTime.Mismatch | Specified end time does not math the specified start time. | 结束时间与开始时间不匹配,请您确认时间的匹配度。 |
400 | InvalidOssBucket.Malformed | Specified OssBucket is malformed. | OSSBucket参数错误,请您确认该OSS BUCKET参数是否正确。 |
400 | InvalidOssObject.Malformed | Specified OssObject is malformed. | OSSObject参数错误,请您确认该OSSObject参数是否正确。 |
400 | InvalidStream.NotFound | Speicified stream does not exist. | 直播流不存在,请您确认直播流是否正确。 |
400 | InvalidConfig.Changed | The oss bucket info between StartTime and EndTime has changed. | ossbuckt开始结束时间已经改变。 |
400 | NoRecordContent | The record content between StartTime and EndTime is empty. | 开始时间和结束时间为空。 |
访问错误中心查看更多错误码。