最近更新时间:2023-05-05 18:43:47
截图规则:以I帧为截图内容,抽取推流开始后第一个I帧作为第一张截图文件,可配置截图频率,即最小截图间隔时间。为您举例说明:截图频率20s,抽取第一个I帧为第一张截图,后续的第20s(含)后出现的第一个I帧为下一个截图文件,以此类推。
说明:关闭截图覆盖后,您的截图文件名被置为{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即可,我们将截图文件信息以HTTP POST的形式通知给您。
{
"details": {
"bucket": "yourbucket",
"errnum": 0,
"items": [{
"dstpath": "record/app/streamname/picture/1683269715474_153042646/streamname-1683279837.jpg",
"height": 1280,
"output_format": 0,
"size": "96733",
"width": 720
}],
"region": "BEIJING",
"srcHeight": 1280,
"srcWidth": 720,
"stream_name": "streamname",
"timestamp": 1683279838,
"uniqname": "youruniquename"
},
"status": 3,
"taskid": "24dcb5bbd84f419e3dbfdc2cbad74742",
"type": "LiveSnapShotCallBack",
// 历史字段,忽略即可
"itmes": [{
"app": "yourapp",
"cmd": "Nzk4MzcuanBn",
"code": 3,
"desc": "success",
"domain": "yourpubdomain",
"keys": ["record/app/streamname/picture/1683269715474_153042646/streamname-1683279837.jpg"]
}]
}
参数 | 类型 | 描述 |
---|---|---|
taskid | string | 任务ID |
type | string | 回调类型 |
details | json | 回调主体,任务细节描述 |
errnum | int | 任务状态执行码,0代表成功 |
errmsg | string | errmsg!=0时,描述错误细节信息 |
uniqname | string | 域名空间 |
stream_name | string | 截图来源的直播流名 |
timestamp | int | 截图产生的时间点 |
srcWidth | int | 用户设置的截图宽。截图失败时,不带此参数 |
srcHeight | int | 用户设置的截图高。截图失败时,不带此参数 |
bucket | string | 上传最终截图的bucket,如果有一转多,暂时只支持上传到同一个bucket |
width | int | 截图的宽 |
height | int | 截图的高 |
intelligentSwitch | int | 智能转码开关。1:不允许小转大。0:允许小转大。默认为0.如果不改变原图分辨率,该值无效 |
quality | int | 输出截图质量,影响截图文件大小。取值1-10,超出无效,默认5 |
dstpath | string | 截图指定bucket中上传路径(objectKey) |
suffix | string | 生成文件后缀名,模板参数 |
container | string | 截图格式 |
status | int | 已废弃,任务执行状态码以errnum为准 |
纯净模式