全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 ET大脑 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
视频直播

添加截图配置

更新时间:2018-03-15 17:57:42

描述

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

请求参数

参数 类型 是否必选 示例值 描述
Action String AddLiveAppSnapshotConfig

系统规定参数。取值:AddLiveAppSnapshotConfig

AppName String testApp

直播流所属应用名称。
支持通配符*号,代表该域名下所有的 AppName。

DomainName String www.yourdomain.com

您的加速域名。

OssBucket String test123

OSSBucket名称。

OssEndpoint String oss-cn-shanghai.aliyuncs.com

OSSEndpoint域名。

TimeInterval Integer 5

截图周期。
取值范围:[5,3600]
单位:秒。

OverwriteOssObject String {AppName}/{StreamName}.jpg

OSS 存储文件名,每次截图都覆盖此文件。

  • 小于 256bytes。
  • 目前仅支持生成 jpg 图片。
  • 支持变量匹配,包含 {AppName}、{StreamName},如:{AppName}/{StreamName}.jpg。

SequenceOssObject String snapshot/{AppName}/{StreamName}/{UnixTimestamp}.jpg

OSS 存储文件名。每次截图都递增存储,DescribeLiveStreamSnapshotInfo 接口查询一段时间的文件。

  • 小于 256bytes。
  • 目前仅支持生成 jpg 图片。
  • 支持变量匹配,包含 {AppName}、{StreamName}、{UnixTimestamp}、{Sequence},其中 {UnixTimestamp}、{Sequence} 必填一个,如:snapshot/{AppName}/{StreamName}/{UnixTimestamp}.jpg。

返回参数

参数 类型 示例值 描述
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

该条任务请求 ID

示例

请求示例

  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. }

异常返回示例

JSON 格式

  1. {
  2. "Code":"InternalError",
  3. "HostId":"live.aliyuncs.com",
  4. "Message":"The request processing has failed due to some unknown error.",
  5. "RequestId":"6EBD1AC4-C34D-4AE1-963E-B688A228BE31"
  6. }

错误码

查看本产品错误码

本文导读目录