调用DynamicUpdateWaterMarkStreamRule动态更新水印。
使用说明
动态更新水印是指在直播过程中替换水印模板ID。
调用本接口更新水印前需准备用于替换的水印模板ID,用于定义本接口中TemplateId参数。您可以调用DescribeLiveStreamWatermarks接口获取可用的水印模板ID。
QPS限制
本接口的单用户QPS限制为60次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DynamicUpdateWaterMarkStreamRule |
系统规定参数,取值:DynamicUpdateWaterMarkStreamRule。 |
App | String | 是 | liveApp**** |
播流所属应用名称。 |
Domain | String | 是 | pull.aliyundoc.com |
主播流域名。 |
Stream | String | 是 | liveStream**** |
水印流名称。 |
TemplateId | String | 是 | 749b7594-86d6-37b1-513b-e1e19845**** |
水印模板ID,可调用DescribeLiveStreamWatermarks接口获取可用的水印模板ID。 说明 此参数TemplateId用于替换直播过程中的水印模板ID。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | BE9407FF-F897-4DBD-338D-98A750AD805F |
请求ID。 |
示例
请求示例
http(s)://live.aliyuncs.com/?Action=DynamicUpdateWaterMarkStreamRule
&App=liveApp****
&Domain=pull.aliyundoc.com
&Stream=liveStream****
&TemplateId=749b7594-86d6-37b1-513b-e1e19845****
&<公共请求参数>
正常返回示例
XML
格式
<DynamicUpdateWaterMarkStreamRuleResponse>
<RequestId>BE9407FF-F897-4DBD-338D-98A750AD805F</RequestId>
</DynamicUpdateWaterMarkStreamRuleResponse>
JSON
格式
{
"RequestId": "BE9407FF-F897-4DBD-338D-98A750AD805F"
}
错误码
访问错误中心查看更多错误码。