直播云

  • 直播云 > API 文档 > 直播流管理API >录制直播回放

    录制直播回放

    最近更新时间:2022-01-21 11:21:42

    接口描述

    录制目标直播流一段时间内的直播为回放文件保存在存储空间中,并指定保存时间,可选回放文件的格式有m3u8、flv和mp4。其中录制为 flv、mp4 格式需要使用多媒体处理转码服务,录制过程需要一定时间。多媒体处理服务独立计费,使用会额外产生费用,详细费用请参考价格表

    请求参数

    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>,
        "persistentDeleteAfterDays": <persistentDeleteAfterDays>,
        "firstTsType": <firstTsType>
    }
    
    参数 类型 必填 描述
    hub string 直播空间名
    encodedStreamTitle string 经过base64编码的直播流名
    start int64 开始时间,Unix 时间戳,默认为第一次直播开始时间
    end int64 结束时间,Unix 时间戳,默认为当前时间
    fname string 文件名,为空时会随机生成一个文件名
    format string 文件格式,可选文件格式为:
    m3u8: HLS格式,默认值
    flv: FLV格式,将回放切片转封装为单个flv文件,异步模式
    mp4: MP4格式,将回放切片转封装为单个mp4文件,异步模式
    异步模式下,生成回放文件需要一定时间
    pipeline string 异步模式时,指定数据处理的队列,可以将优先级较高的任务配置到独立的队列中进行执行,参考文档:流媒体队列
    notify string 回调地址,异步模式完成任务后的回调通知地址,不指定表示不做回调,参考文档:状态查询
    同步模式下录制结果直接由接口返回,回调不生效
    expireDays int 切片文件的生命周期:
    0: 默认值,表示修改ts文件生命周期为永久保存
    >0: 表示修改ts文件的的生命周期为 ExpireDays 参数值
    -1: 表示不修改ts文件的expire属性,可显著提升接口响应速度
    persistentDeleteAfterDays int 生成文件的生命周期:
    0: 默认值,表示生成文件(m3u8/flv/mp4)永久保存
    >0: 表示生成文件(m3u8/flv/mp4)的生命周期为 PersistentDeleteAfterDays 参数值
    注意,对于m3u8文件,只有当ExpireDays为-1时,persistentDeleteAfterDays才会生效,如果设置了切片文件的生命周期,那生成m3u8文件的生命周期会和切片文件ts的生命周期一致
    firstTsType byte 过滤ts切片文件类型,部分非标准的直播流,在推流初期缺少视频帧或音频帧,过滤功能可以剔除这部分切片,
    0: 默认值,不做过滤
    1: 第一个ts切片需要是纯视频类型,不符合预期的ts切片将被跳过
    2: 第一个ts切片需要是纯音频类型,不符合预期的ts切片将被跳过
    3: 第一个ts切片需要是音视频类型,不符合预期的ts切片将被跳过

    返回数据

    参数 类型 描述
    fname string 文件名
    start int64 开始时间,Unix 时间戳
    end int64 结束时间,Unix 时间戳
    persistentID string 异步任务ID

    示例

    请求体:

    POST /v2/hubs/test/streams/YWJjZA==/saveas HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>
    Content-Type: application/json
    
    {
        "fname": "test",
        "start": 1635197745,
        "end": 1635215745,
        "expireDays": -1,
        "firstTsType": 3
    }
    

    返回体:

    200 OK
    
    {
        "fname": "test.m3u8",
        "start": 1635215356,
        "end": 1635215752
    }
    

    SDK

    七牛云 SDK 已集成该接口功能,可以更方便的调用,前往下载

    以上内容是否对您有帮助?
  • Qvm free helper
    Close