直播云

    • 直播云 > API 文档 > 服务端 API >录制直播回放

    录制直播回放

    最近更新时间：2020-11-27 11:59:06

    录制指定时间段的直播回放，同时可以指定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"}
    以上内容是否对您有帮助？
    • Qvm free helper
    Close