文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>多媒体处理>API 文档>模板接口>水印模板>更新水印模板

更新水印模板

最近更新时间：2024-11-16 14:26:53

我的收藏

本页目录：

功能描述

UpdateMediaTemplate 用于更新水印模板。

请求

请求示例

PUT /template/<TemplateId> HTTP/1.1
Host: <BucketName-APPID>.ci.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Content-Length: <length>
Content-Type: application/xml

<body>
说明：
Authorization: Auth String （详情请参见 请求签名 文档）。

请求头

此接口仅使用公共请求头部，详情请参见 公共请求头部 文档。

请求体

该请求操作的实现需要有如下请求体。
<Request>
    <TemplateId>t1460606b9752148c4ab182f55163ba7cd</TemplateId>
    <Tag>Watermark</Tag>
    <Name>TemplateName</Name>
    <Watermark>
        <Type>Text</Type>
        <LocMode>Absolute</LocMode>
        <Dx>128</Dx>
        <Dy>128</Dy>
        <Pos>TopRight</Pos>
        <StartTime>0</StartTime>
        <EndTime>100.5</EndTime>
        <Text>
            <Text>水印内容</Text>
            <FontSize>30</FontSize>
            <FontType></FontType>
            <FontColor>0xRRGGBB</FontColor>
            <Transparency>30</Transparency>
        </Text>
    </Watermark>
</Request>
具体数据描述如下：
节点名称（关键字）
父节点
描述
类型
必选
Request
无
保存请求的容器
Container
是
Container 类型 Request 的具体数据描述如下：
节点名称（关键字）
父节点
描述
类型
必选
Tag
Request
模板类型：Watermark
String
是
Name
Request
模板名称仅支持中文、英文、数字、_、-和*
String
是
Watermark
Request
水印信息
Container
是
Container 类型 Watermark 的具体数据描述如下：
节点名称（关键字）
父节点
描述
类型
必选
默认值
限制
Type
Request.Watermark
水印类型
String
是
无
Text：文字水印
Image：图片水印
Pos
Request.Watermark
基准位置
String
是
无
TopRight：右上
TopLeft：左上
BottomRight：右下
BottomLeft：左下
LocMode
Request.Watermark
偏移方式
String
是
无
Relativity：按比例
Absolute：固定位置
Dx
Request.Watermark
水平偏移
String
是
无
在图片水印中，如果 Background 为 true，当 locMode 为 Relativity 时，单位为%，值范围：[-300 0]；当 locMode 为 Absolute 时，单位为 px，值范围：[-4096 0]
在图片水印中，如果 Background 为 false，当 locMode 为 Relativity 时，单位为%，值范围：[0 100]；当 locMode 为 Absolute 时，单位为 px，值范围：[0 4096]
在文字水印中，当 locMode 为 Relativity 时，单位为%，值范围：[0 100]；当 locMode 为 Absolute 时，单位为 px，值范围：[0 4096]
Dy
Request.Watermark
垂直偏移
String
是
无
在图片水印中，如果 Background 为 true，当 locMode 为 Relativity 时，单位为%，值范围：[-300 0]；当 locMode 为 Absolute 时，单位为 px，值范围：[-4096 0]
在图片水印中，如果 Background 为 false，当 locMode 为 Relativity 时，单位为%，值范围：[0 100]；当 locMode 为 Absolute 时，单位为 px，值范围：[0 4096]
在文字水印中，当 locMode 为 Relativity 时，单位为%，值范围：[0 100]；当 locMode 为 Absolute 时，单位为 px，值范围：[0 4096]
StartTime
Request.Watermark
水印开始时间
String
否
0
[0 视频时长]
单位为秒
支持 float 格式，执行精度精确到毫秒
EndTime
Request.Watermark
水印结束时间
String
否
视频结束时间
[0 视频时长]
单位为秒
支持 float 格式，执行精度精确到毫秒
Image
Request.Watermark
图片水印节点
Container
否
无
无
Text
Request.Watermark
文本水印节点
Container
否
无
无
Container 类型 Image 的具体数据描述如下：
节点名称（关键字）
父节点
描述
类型
必选
默认值
限制
Url
Request.Watermark.Image
水印图地址
String
是
无
水印图片地址
如果水印图片为私有对象时，请携带签名信息
Mode
Request.Watermark.Image
尺寸模式
String
是
无
Original：原有尺寸
Proportion：按比例
Fixed：固定大小
Width
Request.Watermark.Image
宽
String
否
无
当 Mode 为 Original 时，不支持设置水印图宽度
当 Mode 为 Proportion，单位为%，背景图值范围：[100 300]；前景图值范围：[1 100]
当 Mode 为 Fixed，单位为 px，值范围：[8，4096]，若只设置 Width 时，按照视频原始比例计算 Height
Height
Request.Watermark.Image
高
String
否
无
当 Mode 为 Original 时，不支持设置水印图高度
当 Mode 为 Proportion，单位为%，背景图值范围：[100 300]；前景图值范围：[1 100]
当 Mode 为 Fixed，单位为px，值范围：[128，4096]，若只设置 Height 时，按照视频原始比例计算 Width
Transparency
Request.Watermark.Image
透明度
String
是
无
值范围：[0 100]，单位为%
Background
Request.Watermark.Image
是否背景图
String
否
false
true、false
Container 类型 Text 的具体数据描述如下：
节点名称（关键字）
父节点
描述
类型
必选
默认值
限制
FontSize
Request.Watermark.Text
字体大小
String
是
无
值范围：[0 100]，单位为 px
FontType
Request.Watermark.Text
字体类型
String
是
无
参考下表
FontColor
Request.Watermark.Text
字体颜色
String
是
无
格式：0xRRGGBB
Transparency
Request.Watermark.Text
透明度
String
是
无
值范围：[0 100]，单位为%
Text
Request.Watermark.Text
水印内容
String
是
无
长度不超过64个字符，仅支持中文、英文、数字、_、-和*
Text 的 FontType 具体数据描述如下：
字体名称
支持的语言
描述
simfang.ttf
中/英
仿宋
simhei.ttf
中/英
黑体
simkai.ttf
中/英
楷体
simsun.ttc
中/英
宋体
STHeiti-Light.ttc
中/英
华文黑体
STHeiti-Medium.ttc
中/英
华文黑体中
youyuan.TTF
中/英
幼圆
ariblk.ttf
英
无
arial.ttf
英
无
ahronbd.ttf
英
无
Helvetica.dfont
英
无
HelveticaNeue.dfont
英
无

响应

响应头

此接口仅返回公共响应头部，详情请参见 公共响应头部 文档。

响应体

该响应体返回为 application/xml 数据，包含完整节点数据的内容展示如下：
<Response>
    <Template>
        <TemplateId>t1460606b9752148c4ab182f55163ba7cd</TemplateId>
        <Tag>Watermark</Tag>
        <Name>TemplateName</Name>
        <Watermark>
            <Type>Text</Type>
            <LocMode>Absolute</LocMode>
            <Dx>128</Dx>
            <Dy>128</Dy>
            <Pos>TopRight</Pos>
            <StartTime>0</StartTime>
            <EndTime>100.5</EndTime>
            <Text>
                <Text>水印内容</Text>
                <FontSize>30</FontSize>
                <FontType></FontType>
                <FontColor>0xRRGGBB</FontColor>
                <Transparency>30</Transparency>
            </Text>
        </Watermark>
        <CreateTime>2020-08-05T11:35:24+0800</CreateTime>
        <UpdateTime>2020-08-31T16:15:20+0800</UpdateTime>
    </Template>
</Response>

具体的数据内容如下：
节点名称（关键字）
父节点
描述
类型
Response
无
保存结果的容器
Container
Container 节点 Response 的内容：
节点名称（关键字）
父节点
描述
类型
TemplateId
Response
模板 ID
String
Watermark
Response
水印信息，详情请见同页面请求体 Watermark 的具体数据描述
Container

错误码

该请求操作无特殊错误信息，常见的错误信息请参见 错误码 文档。

实际案例

请求

PUT /template/<TemplateId> HTTP/1.1
Authorization: q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=****************************************
Host: examplebucket-1250000000.ci.ap-beijing.myqcloud.com
Content-Length: 1666
Content-Type: application/xml

<Request>
    <TemplateId>t1460606b9752148c4ab182f55163ba7cd</TemplateId>
    <Tag>Watermark</Tag>
    <Name>TemplateName</Name>
    <Watermark>
        <Type>Text</Type>
        <LocMode>Absolute</LocMode>
        <Dx>128</Dx>
        <Dy>128</Dy>
        <Pos>TopRight</Pos>
        <StartTime>0</StartTime>
        <EndTime>100.5</EndTime>
        <Text>
            <Text>水印内容</Text>
            <FontSize>30</FontSize>
            <FontType></FontType>
            <FontColor>0xRRGGBB</FontColor>
            <Transparency>30</Transparency>
        </Text>
    </Watermark>
</Request>

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 100
Connection: keep-alive
Date: Thu, 15 Jun 2017 12:37:29 GMT
Server: tencent-ci
x-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****

<Response>
    <Template>
        <TemplateId>t1460606b9752148c4ab182f55163ba7cd</TemplateId>
        <Tag>Watermark</Tag>
        <Name>TemplateName</Name>
        <Watermark>
            <Type>Text</Type>
            <LocMode>Absolute</LocMode>
            <Dx>128</Dx>
            <Dy>128</Dy>
            <Pos>TopRight</Pos>
            <StartTime>0</StartTime>
            <EndTime>100.5</EndTime>
            <Text>
                <Text>水印内容</Text>
                <FontSize>30</FontSize>
                <FontType></FontType>
                <FontColor>0xRRGGBB</FontColor>
                <Transparency>30</Transparency>
            </Text>
        </Watermark>
        <CreateTime>2020-08-05T11:35:24+0800</CreateTime>
        <UpdateTime>2020-08-31T16:15:20+0800</UpdateTime>
    </Template>
</Response>

中国站
目录