调用UpdateLiveStreamWatermark更新水印模板。

使用说明

本接口支持对指定TemplateId的⽔印模板各项参数进⾏更新调整。

QPS限制

本接口的单用户QPS限制为60次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 UpdateLiveStreamWatermark

系统规定参数。取值：UpdateLiveStreamWatermark。

TemplateId String 是 445409ec-7eaa-461d-8f29-4bec2eb9****

水印模板ID。

说明 可查看AddLiveStreamWatermark接口返回参数值获取TemplateId。
Name String 否 livewatermark****

水印名称。
Description String 否 my watermark

自定义水印描述信息。
RefWidth Integer 否 1920

参考背景视频宽，单位：px。
RefHeight Integer 否 1080

参考背景视频高，单位：px。
XOffset Float 否 50.0

⽔印X轴偏移，单位：px。

说明 相对于参考背景宽RefWidth， 如果选择的是TopLeft，那么XOffset是指⽔印图⽚的左上⻆和背景视频的左上⻆的相对位置X。其中坐标指向背景视频中⼼的⽅向为正⽅向，即X轴的正⽅向是向右。
YOffset Float 否 100.0

⽔印Y轴偏移，单位：px。

说明 相对于参考背景⾼RefHeight，如果选择的是TopLeft，那么YOffset是指⽔印图⽚的左上⻆和背景视频的左上⻆的相对位置Y。其中坐标指向背景视频中⼼的⽅向为正⽅向，即Y轴的正⽅向是向下。
Height Integer 否 200

水印图片高度，单位：px。对比参考背景RefHeight，最终按照⽐例进⾏⾃适应缩放为准。
Transparency Integer 否 255

水印透明度，数值越小越透明。取值：0~255。
OffsetCorner String 否 TopRight

位置。取值：

  • TopLeft：左上。
  • TopRight：右上。
  • BottomLeft：左下。
  • BottomRight：右下。
PictureUrl String 否 http://example.com

水印图片链接。

返回数据

名称 类型 示例值 描述
RequestId String 5c6a2a0df228-4a64-af62-20e91b9676b3

请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=UpdateLiveStreamWatermark
&TemplateId=445409ec-7eaa-461d-8f29-4bec2eb9****
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<UpdateLiveStreamWatermarkResponse>
    <RequestId>5c6a2a0df228-4a64-af62-20e91b9676b3</RequestId>
</UpdateLiveStreamWatermarkResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "5c6a2a0df228-4a64-af62-20e91b9676b3"
}

错误码

访问错误中心查看更多错误码。