直播截图

最近更新时间:2020-09-08 20:42:11

直播截图

截图规则:以I帧为截图内容,抽取推流开始后首个I帧作为第一张截图文件,可配置截图频率,即最小截图间隔时间。为您举例说明:截图频率20s,抽取首个I帧为第一张截图,后续的第20s(含)后出现的首个I帧为下一个截图文件,以此类推。

  • 截图服务需要您在云直播控制台申请开通,并配置截图文件存放bucket和回调url,目前原始截图文件只支持jpg格式。
  • 如需对图片进行后期处理,请参考图片处理详解
  • 目前仅支持北京region。

存储规则

关闭截图覆盖

说明:关闭截图覆盖后,您的截图文件名被置为{StreamName}-{UnixTimestamp}.jpg,在ks3中会保留全部的截图文件。

命名规则:{StreamName}-{UnixTimestamp}.jpg

存储路径:record/{App}/{StreamName}/picture/{UnixTimeMs}-{SessionId}/{StreamName}-{UnixTimestamp}.jpg

示例:record/myapp/mystream/picture/mystream-1587523655.jpg

目录说明

目录 描述
record 根目录
App 频道名
StreamName 流名
picture 存放截图文件的标识
UnixTimeMs 创建文件目录的毫秒时间戳
SessionId 随机数
UnixTimestamp 推流开始的毫秒时间戳

开启截图覆盖

说明:开启截图覆盖后,您的截图文件名会被置为{StreamName}.jpg,当新文件产生时会自动覆盖旧文件,因此最终您的ks3中只会保留最新的一个截图文件。

命名规则:{StreamName}.jpg

存储路径:record/{App}/{StreamName}/picture/{StreamName}.jpg

示例:record/myapp/mystream/picture/mystream.jpg

回调接口

配置回调url

在云直播控制台配置截图文件生成后的回调url即可,我们将生成的截图文件以HTTP POST的形式通知给您。

回调示例

{
    "status":3,
    "taskid":"xxx",
    "type":"LiveSnapShotCallBack",
    "details":{
        "errnum":0,
        "errmsg":"",
        "uniqname":"myuniqname",
        "stream_name":"12345",
        "timestamp":1464765845,
        "srcWidth":1280,
        "srcHeight":720,
        "bucket":"myBucket",
        "items":[
            {
                "output_format":0,
                "width":480,
                "height":360,
                "setWidth":540,
                "setHeight":360,
                "intelligentSwitch":1,
                "quality":5,
                "dstpath":"upic/2016/05/11/live/1.jpg",
                "container":"webp",
                "suffix":"480"
            },
          //历史字段,忽略即可
             "itmes":[
        {
            "cmd":"tag=avop&f=mp4&res=1280x720&vbr=1500k&abr=128k|tag=saveas&bucket=xxx&object=cmVjb3JkL3VwbG9hZC9WMTQ1NTUwODQyNDExMjY3OC9WMTQ1NTUwODQyNDExMjY3OC5tcDQ=",
            "desc":"success",
            "keys":[
                "record/upload/V1455508424112678/xxx.mp4"
            ],
            "code":3
         }
         ]
        ]
    }
}

参数说明

参数 示例 描述
status 3 任务执行的状态(3:成功;4:失败)
taskid xxx 执行本次点播操作的唯一id
desc success 任务执行的结果
keys record/upload/V1455508424112678/xxx.jpg 截图路径
code 3 执行返回的代码
type LiveSnapShotCallBack 标识该调用类型
errnum 0 错误码
errmsg xxx 错误描述
uniqname myuniqname 域名标识
stream_name 123 流名
timestamp 1464765845 截图产生的时间点
bucket mybucket 截图所在的用户bucket
output_format 0 标识转码参数,代表截图输出参数
width 480 图片的宽
height 360 图片的高
shortside 360 用户指定的短边长度。由于不允许小转大,用户设置值,不一定就是最终输出的宽高中短的一边。如果不设置,回调中不带。
quality 5 用户指定的图片的质量系数,如果是默认质量,则回调中不带。
dstpath upic/2016/05/11/live/1.jpg 截图在bucket中的路径,如果上传失败,该值为空,可以使用alterurl直播下载

金山云,开启您的云计算之旅

免费注册