直播截图

最近更新时间:2021-03-26 11:22:19

查看PDF

使用前提

  • 需要先联系商务开通云直播服务、CDN服务、KS3服务
  • 主账号需要有可用的AKSK,用于存放录像文件的bucket设置为公开读写

概念解释

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

  • 截图服务需要您在云直播控制台申请开通,目前原始截图文件支持jpg格式
  • 支持截图的直播中心region:华北1(北京)、华北2(北京)、东南亚1(新加坡)
  • 如需对图片进行后期处理,请参考图片处理详解

存储规则

关闭截图覆盖

说明:关闭截图覆盖后,您的截图文件名被置为{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 截图的存储路径

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

内容不全,不深入
内容更新不及时
描述不清晰,比较混乱
系统或功能太复杂,缺乏足够的引导
内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈