录制直播回放
录制指定时间段的直播回放,同时可以指定ts文件的保存时间, 直播流音视频格式必须是aac,h264/265才能切片保存下来。
请求包
POST /v2/hubs/<Hub>/streams/<EncodedStreamTitle>/saveas
Host: pili.qiniuapi.com
Authorization: <QiniuToken>
Content-Type: application/json
{
"fname": <fname>,
"start": <Start>,
"end": <End>
"format": "<Format>",
"pipeline": "<Pipeline>",
"notify": "<Notify>",
"expireDays": <ExpireDays>,
"firstTsType": <FirstTsType>
}
参数名称 | 必填 | 说明 |
---|---|---|
Hub | 是 | 直播空间名 |
EncodedStreamTitle | 是 | 对流名做 URL 安全的 Base64 编码后得到的字符串 |
fname | 否 | 保存的文件名,不指定系统会随机生成 |
start | 否 | 整数,Unix 时间戳,要保存的直播的起始时间,不指定或 0 值表示从第一次直播开始 |
end | 否 | 整数,Unix 时间戳,要保存的直播的结束时间,不指定或 0 值表示当前时间 |
format | 否 | 保存的文件格式,默认为m3u8,如果指定其他格式,则保存动作为异步模式。详细信息可以参考 转码 的api |
pipeline | 否 | 异步模式时,数据处理的私有队列,不指定则使用公共队列 |
notify | 否 | 异步模式时,保存成功回调通知地址,不指定则不通知 通知的详细信息查考这里 |
expireDays | 否 | 更改ts文件的过期时间,默认为永久保存。-1 表示不更改ts文件的生命周期,正值表示修改ts文件的生命周期为expireDays。相较于更改ts文件的生命周期,不更改ts文件的生命周期接口响应更快 |
firstTsType | 否 | 过滤ts切片文件类型,默认值为0,表示不做过滤。1 表示第一个ts为纯视频类型; 2 表示第一个ts为纯音频类型; 3 表示第一个ts为音视频类型 |
返回包:
200 {
"fname": "<Fname>",
"persistentID": "<PersistentID>"
}
612 {
"error": "stream not found"
}
619 {
"error": "no data" // 没有直播数据
}
- fname: 字符串,表示保存后在存储空间里的文件名。使用存储空间的下载域名可以访问这文件,形如:
http://<DownloadDomainOfStorageBucket>/<Fname>
- persistentID: 字符串,持久化异步处理任务ID,异步模式才会返回该字段,可以通过该字段查询转码进度,持久化处理状态查询
示例
请求包:
POST /v2/hubs/PiliSDKTest/streams/Y2FydGVyMjAwMA==/saveas HTTP/1.1
Host: pili.qiniuapi.com
User-Agent: pili-sdk-go/v2 go1.6 darwin/amd64
Content-Length: 19
Authorization: Qiniu 7O7hf7Ld1RrC_fpZdFvU8aCgOPuhw2K4eapYOdII:iHISeGMP-Q_L8sGURbdlSxzvEH0=
Content-Type: application/json
Accept-Encoding: gzip
{"start":1463577162,"end":1463577171}
返回包:
HTTP/1.1 200 OK
Content-Length: 66
Content-Type: application/json
Date: Wed, 18 May 2016 13:12:57 GMT
X-Log: PILI:60;PILI-LINA:62
X-Reqid: 7qsRADDGllWwq08U
{"fname":"recordings/z1.PiliSDKTest.carter2000/1463577162_1463577171.m3u8"}
文档反馈
(如有产品使用问题,请提交工单)