调用UpdateLiveAppSnapshotConfig更新播流下的截图配置。输出内容保存到OSS中,重新推流后生效。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | UpdateLiveAppSnapshotConfig |
系统规定参数。取值:UpdateLiveAppSnapshotConfig |
AppName | String | 是 | testApp |
播流所属应用名称。 |
DomainName | String | 是 | live.yourdomain.com |
播流域名。 |
TimeInterval | Integer | 否 | 5 |
截图周期。取值范围:5~3600。单位:秒。 |
OssEndpoint | String | 否 | oss-cn-shanghai.aliyuncs.com |
OSS存储的Endpoint名称。 |
OssBucket | String | 否 | test123 |
OSS存储Bucket名称。 |
OverwriteOssObject | String | 否 | {AppName}/{StreamName}.jpg |
覆盖截图存储文件名。每次截图都覆盖此文件。
|
SequenceOssObject | String | 否 | snapshot/{AppName}/{StreamName}/{UnixTimestamp}.jpg |
实时截图存储文件名。每次截图都递增存储,调用DescribeLiveStreamSnapshotInfo接口,可以查询某一段时间的文件。
|
Callback | String | 否 | https://example.aliyunlive.com |
截图回调地址。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 |
请求ID。 |
示例
请求示例
http(s)://live.aliyuncs.com/?Action=UpdateLiveAppSnapshotConfig
&AppName=testApp
&DomainName=live.yourdomain.com
&<公共请求参数>
正常返回示例
XML
格式
<UpdateLiveAppSnapshotConfigResponse>
<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</UpdateLiveAppSnapshotConfigResponse>
JSON
格式
{
"RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidOverwriteOssObjectOrSequenceOssObject.Malformed | Specified paramters OverwriteOssObject or SequenceOssObject should have one. | OverwriteOssObject与SequenceOssObject参数任选其一。 |
400 | InvalidOssEndpoint.Malformed | Specified parameter OssEndpoint is not valid. | OSSEndpoint参数错误,请您确认该OSSEndpoint参数是否正确。 |
400 | InvalidOssBucket.Malformed | Specified parameter OssBucket is not valid. | OSSBucket参数错误,请您确认该OSS BUCKET参数是否正确。 |
400 | InvalidOssBucket.NotFound | The parameter OssBucket does not exist. | OSSBucket参数错误,请您确认该OSS BUCKET参数是否正确。 |
400 | InvalidOverwriteOssObject.Malformed | Specified parameter OverwriteOssObject is not valid. | OverwriteOSSObject参数错误,请您确认该OverwriteOSSObject参数是否正确。 |
400 | InvalidSequenceOssObject.Malformed | Specified parameter SequenceOssObject is not valid. | SequenceOssObject参数错误,请您确认该SequenceOssObject参数是否正确。 |
400 | InvalidConfig.NotFound | The speicified config does not exist. | OssBucket错误,请您确认该OssBucket是否正确。 |
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交