全部产品
视频直播

添加截图配置

更新时间:2017-09-19 11:33:11   分享:   

描述

针对直播流下的 AppName 配置截图信息,输出内容保存到 OSS 中,重新推流生效。

请求参数

参数 类型 是否必须 描述
Action String 操作接口名,系统规定参数,取值:AddLiveAppSnapshotConfig
DomainName String 您的加速域名
AppName String 直播流所属应用名称,支持通配符*号,代表该域名下所有的 AppName
TimeInterval Integer 截图周期,范围:5~3600,单位秒
OssEndpoint String oss endpoint
OssBucket String oss 存储 bucket 名称
OverwriteOssObject String oss 存储文件名,每次截图都覆盖此文件,小于 256byte,目前仅支持生成 jpg 图片,支持变量匹配,包含 {AppName}、{StreamName},如:{AppName}/{StreamName}.jpg
SequenceOssObject String oss 存储文件名,每次截图都递增存储,DescribeLiveStreamSnapshotInfo 接口查询一段时间的文件,小于 256byte,目前仅支持生成 jpg 图片,支持变量匹配,包含 {AppName}、{StreamName}、{UnixTimestamp}、{Sequence},其中 {UnixTimestamp}、{Sequence} 必填一个,如:snapshot/{AppName}/{StreamName}/{UnixTimestamp}.jpg

返回参数

名称 类型 描述
RequestId String 该条任务请求 ID

特殊错误码

错误代码 描述 Http 状态码 语义
InvalidOssEndpoint.Malformed Specified parameter OssEndpoint is not valid. 400 OssEndpoint 参数不合法
InvalidOssBucket.Malformed Specified parameter OssBucket is not valid. 400 OssBucket 参数不合法
InvalidOssBucket.NotFound The parameter OssBucket does not exist. 400 该 OssBucket 不存在
InvalidTimeInterval Specified parameter TimeInterval is not valid. 400 TimeInterval 参数不合法
InvalidOverwriteOssObject.Malformed Specified parameter OverwriteOssObject is not valid. 400 OverwriteOssObject 参数不合法
InvalidSequenceOssObject.Malformed Specified parameter SequenceOssObject is not valid. 400 SequenceOssObject 参数不合法
InvalidOverwriteOssObjectOrSequenceOssObject.Malformed Specified paramters OverwriteOssObject or SequenceOssObject should have one. 400 两者必须有一个
ConfigAlreadyExists Config has already exist. 400 配置已存在

示例

请求示例:

  1. https://live.aliyuncs.com?Action=AddLiveAppSnapshotConfig&DomainName=test101.aliyunlive.com&AppName=xxx&TimeInterval=10&OssEndpoint=endpoint&OssBucket=bucket&OverwriteOssObject=object&SequenceOssObject=object<公共请求参数>

关于公共请求参数详细内容,请参考 公共请求参数

返回示例:

JSON格式:

  1. {
  2. "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
  3. }
本文导读目录
本文导读目录
以上内容是否对您有帮助?