直播云

  • 直播云 > API 文档 > 直播流管理API >保存直播截图

    保存直播截图

    最近更新时间:2021-11-02 15:30:43

    接口描述

    保存目标直播流在特定时间点的画面为图片,并保存在存储空间中。截图使用多媒体处理服务并独立计费,会额外产生费用,详细费用请参考价格表

    请求参数

    POST /v2/hubs/<hub>/streams/<encodedStreamTitle>/snapshot
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/json 
    
    {
        "fname": "<fname>",
        "time": <time>,
        "format": "<format>",
        "pipeline": "<pipeline>",
        "notify": "<notify>",
        "deleteAfterDays": <deleteAfterDays>
    }
    
    参数 类型 必填 描述
    hub string 直播空间名
    encodedStreamTitle string 经过base64编码的直播流名
    time int 截图时间,Unix 时间戳,不指定则为当前时间
    fname string 文件名,不指定系统会随机生成
    format string 文件格式,默认为jpg,可取值为jpg和png
    pipeline string 异步模式时,指定数据处理的队列,可以将优先级较高的任务配置到独立的队列中进行执行,参考文档:流媒体队列
    notify string 回调地址,若指定回调地址,则截图动作为异步模式
    deleteAfterDays int 生命周期,- 0: 默认值,表示截图文件永久保存,单位:天

    返回数据

    参数 类型 描述
    fname string 文件名
    persistentID string 异步任务ID

    示例

    请求体:

    POST /v2/hubs/test/streams/YWJjZA==/snapshot HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/json 
    
    {
        "fname": "test",
        "time": 1632810081,
        "deleteAfterDays": 1
    }
    

    返回体:

    200 OK
    
    {
        "fname": "test"
    }
    

    SDK

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

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