直播截图

最近更新时间:2020-08-10 10:52:01

直播截图

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

存储规则

关闭截图覆盖

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

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

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

目录说明

目录 描述
record 根目录
App 频道名
StreamName 流名
picture 存放截图文件的标识
UnixTimestamp 毫秒时间戳

开启截图覆盖

命名规则:{StreamName}.jpg

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

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

回调接口

配置回调url

用户在使用时需要在云直播控制台配置生成截图文件后的回调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直播下载

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

免费注册