直播云

  • 录制直播回放

    最近更新时间:2018-08-28 10:30:14

    录制指定时间段的直播回放,同时可以指定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>
    }
    
    参数名称 必填 说明
    Hub 直播空间名
    EncodedStreamTitle 对流名做 URL 安全的 Base64 编码后得到的字符串
    fname 保存的文件名,不指定系统会随机生成
    start 整数,Unix 时间戳,要保存的直播的起始时间,不指定或 0 值表示从第一次直播开始
    end 整数,Unix 时间戳,要保存的直播的结束时间,不指定或 0 值表示当前时间
    format 保存的文件格式,默认为m3u8,如果指定其他格式,则保存动作为异步模式。详细信息可以参考 转码 的api
    pipeline 异步模式时,数据处理的私有队列,不指定则使用公共队列
    notify 异步模式时,保存成功回调通知地址,不指定则不通知 通知的详细信息查考这里
    expireDays 更改ts文件的过期时间,默认为永久保存。-1 表示不更改ts文件的生命周期,正值表示修改ts文件的生命周期为expireDays

    返回包:

    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"}
    
    以上内容是否对您有帮助?
  • Icon free helper
    Close