功能描述
创建明水印模板。
授权说明
授权策略中 action 设置为 ci:CreateMediaTemplate 。查看所有 action。
服务开通
使用该功能需提前开通数据万象，并绑定存储桶。详情请参见 绑定存储桶。
使用限制
使用该接口时，请先确认相关限制条件。详情请参见 使用限制。
请求
请求示例
POST /template HTTP/1.1Host: <BucketName-APPID>.ci.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>Content-Length: <length>Content-Type: application/xml
<body>
说明Authorization: Auth String（详情请参见 请求签名 文档）。通过子账号使用时，需要授予相关的权限，详情请参见 授权粒度详情 文档。
请求头
此接口仅使用公共请求头部，详情请参见 公共请求头部 文档。
请求体
该请求操作的实现需要有如下请求体。
Watermark TemplateName Text Absolute 128 128 TopRight 0 100.5 水印内容 30 simfang.ttf 0x000000 30
Watermark TemplateName Image Absolute 128 128 TopRight 0 100.5 http://test-1234567890.ci.ap-chongqing.myqcloud.com/shuiyin_2.png Proportion 10 100
具体数据描述如下：
| 节点名称（关键字） | 父节点 | 描述 | 类型 |
| Request | 无 | 保存请求的容器 | Container |
Container 类型 Request 的具体数据描述如下：
| 节点名称（关键字） | 父节点 | 描述 | 类型 | 必选 |
| Tag | Request | 模板类型: Watermark | String | 是 |
| Name | Request | 模板名称，仅支持中文、英文、数字、_、-和*，长度不超过 64 | String | 是 |
| Watermark | Request | 水印信息 | Container | 是 |
Container 类型 Watermark 的具体数据描述如下：
| 节点名称（关键字） | 父节点 | 描述 | 类型 | 默认值 | 是否必选 |
| Type | Request.Watermark | 水印类型Text：文字水印Image：图片水印 | String | 无 | 是 |
| Pos | Request.Watermark | 基准位置TopRightTopLeftBottomRightBottomLeftLeftRightTopBottomCenter | String | 无 | 是 |
| LocMode | Request.Watermark | 偏移方式Relativity：按比例Absolute：固定位置 | String | 无 | 是 |
| Dx | Request.Watermark | 水平偏移在图片水印中，如果 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]。当Pos为Top、Bottom和Center时，该参数无效。 | String | 无 | 是 |
| Dy | Request.Watermark | 垂直偏移在图片水印中，如果 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]。当Pos为Left、Right和Center时，该参数无效。 | String | 无 | 是 |
| StartTime | Request.Watermark | 水印开始时间[0，视频时长] 单位为秒 支持 float 格式，执行精度精确到毫秒 | String | 0 | 否 |
| EndTime | Request.Watermark | 水印结束时间[0，视频时长] 单位为秒 支持 float 格式，执行精度精确到毫秒 | String | 视频结束时间 | 否 |
| SlideConfig | Request.Watermark | 水印滑动配置，配置该参数后水印位移设置不生效，极速高清/H265转码暂时不支持该参数 | Container | 无 | 否 |
| Image | Request.Watermark | 图片水印节点 | Container | 无 | 否 |
| Text | Request.Watermark | 文本水印节点 | Container | 无 | 否 |
Container 类型 SlideConfig 的具体数据描述如下：
| 节点名称（关键字） | 父节点 | 描述 | 类型 | 默认值 | 是否必选 |
| SlideMode | Request.Watermark.SlideConfig | 滑动模式Default: 默认不开启ScrollFromLeft: 从左到右滚动若设置了ScrollFromLeft模式，则Watermark.Pos参数不生效 | String | 无 | 是 |
| XSlideSpeed | Request.Watermark.SlideConfig | 横向滑动速度，取值范围：[0,10]内的整数 | String | 0 | 否 |
| YSlideSpeed | Request.Watermark.SlideConfig | 纵向滑动速度，取值范围：[0,10]内的整数 | String | 0 | 否 |
Container 类型 Image 的具体数据描述如下：
| 节点名称（关键字） | 父节点 | 描述 | 类型 | 默认值 | 是否必选 |
| Url | Request.Watermark.Image | 水印图地址(需要 Urlencode 后传入) | String | 无 | 是 |
| Mode | Request.Watermark.Image | 尺寸模式Original：原有尺寸 Proportion：按比例Fixed：固定大小 | String | 无 | 是 |
| Width | Request.Watermark.Image | 宽当 Mode 为 Original 时，不支持设置水印图宽度 当 Mode 为 Proportion，单位为%，背景图值范围：[100 300]；前景图值范围：[1 100]，相对于视频宽，最大不超过4096px当 Mode 为 Fixed，单位为 px，值范围：[8，4096]若只设置 Width 时，按照水印图比例计算 Height | String | 无 | 否 |
| Height | Request.Watermark.Image | 高当 Mode 为 Original 时，不支持设置水印图高度 当 Mode 为 Proportion，单位为%，背景图值范围：[100 300]；前景图值范围：[1 100]，相对于视频高，最大不超过4096px当 Mode 为 Fixed，单位为 px，值范围：[8，4096]若只设置 Height 时，按照水印图比例计算 Width | String | 无 | 否 |
| Transparency | Request.Watermark.Image | 透明度，值范围：[1 100]，单位% | String | 无 | 是 |
| Background | Request.Watermark.Image | 是否背景图，取值 true、false | String | false | 否 |
水印位置说明：
Container 类型 Text 的具体数据描述如下：
| 节点名称（关键字） | 父节点 | 描述 | 类型 | 默认值 | 是否必选 |
| FontSize | Request.Watermark.Text | 字体大小，值范围：[5 100]，单位 px | String | 无 | 是 |
| FontType | Request.Watermark.Text | 字体类型，参考下表 | String | 无 | 是 |
| FontColor | Request.Watermark.Text | 字体颜色，格式：0xRRGGBB | String | 无 | 是 |
| Transparency | Request.Watermark.Text | 透明度，值范围：[1 100]，单位% | String | 无 | 是 |
| Text | Request.Watermark.Text | 水印内容，长度不超过64个字符，仅支持中文、英文、数字、_、-和* | String | 无 | 是 |
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 数据，包含完整节点数据的内容展示如下：
NjQ0NGNlNDZfMThhYTk0MGFfY********* t1460606b9752148c4ab182f55163ba7cd Watermark TemplateName test-1234567890 Custom Text Absolute 128 128 TopRight 0 100.5 水印内容 30 simfang.ttf 0x000000 30 2020-08-05T11:35:24+0800 2020-08-31T16:15:20+0800
具体的数据内容如下：
| 节点名称（关键字） | 父节点 | 描述 | 类型 |
| Response | 无 | 保存结果的容器 | Container |
Container 节点 Response 的内容：
| 节点名称（关键字） | 父节点 | 描述 | 类型 |
| Template | Response | 保存模板详情的容器 | Container |
| RequestId | Response | 请求的唯一 ID | String |
Container 节点 Template 的内容：
| 节点名称（关键字） | 父节点 | 描述 | 类型 |
| TemplateId | Response.Template | 模板 ID | String |
| Name | Response.Template | 模板名称 | String |
| BucketId | Response.Template | 模板所属存储桶 | String |
| Category | Response.Template | 模板属性，Custom 或者 Official | String |
| Tag | Response.Template | 模板类型，VideoProcess | String |
| UpdateTime | Response.Template | 更新时间 | String |
| CreateTime | Response.Template | 创建时间 | String |
| Watermark | Response.Template | 同请求体中的 Request.Watermark | Container |
错误码
该请求操作无特殊错误信息，常见的错误信息请参见 错误码 文档。
实际案例
请求1（文本水印）
POST /template HTTP/1.1Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0****&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0e****Host: test-1234567890.ci.ap-chongqing.myqcloud.comContent-Length: 1666Content-Type: application/xml
Watermark TemplateName Text Absolute 128 128 TopRight 0 100.5 水印内容 30 simfang.ttf 0x000000 30
响应
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 100Connection: keep-aliveDate: Thu, 14 Jul 2022 12:37:29 GMTServer: tencent-cix-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****
NjQ0NGNlNDZfMThhYTk0MGFfY********* t1460606b9752148c4ab182f55163ba7cd Watermark TemplateName test-1234567890 Custom Text Absolute 128 128 TopRight 0 100.5 水印内容 30 simfang.ttf 0x000000 30 2020-08-05T11:35:24+0800 2020-08-31T16:15:20+0800
请求2（图片水印）
POST /template HTTP/1.1Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0****&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0e****Host: test-1234567890.ci.ap-chongqing.myqcloud.comContent-Length: 1666Content-Type: application/xml
Watermark TemplateName Image Absolute 128 128 TopRight 0 100.5 http://test-1234567890.ci.ap-chongqing.myqcloud.com/shuiyin_2.png Proportion 10 10 30
响应
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 100Connection: keep-aliveDate: Thu, 14 Jul 2022 12:37:29 GMTServer: tencent-cix-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****
NjQ0NGNlNDZfMThhYTk0MGFfY********* t1460606b9752148c4ab182f55163ba7cd Watermark TemplateName test-1234567890 Custom Image Absolute 128 128 TopRight 0 100.5 http://test-1234567890.ci.ap-chongqing.myqcloud.com/shuiyin_2.png Proportion 10 10 30 2020-08-05T11:35:24+0800 2020-08-31T16:15:20+0800
对象存储官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠
转转请注明出处：https://www.yunxiaoer.com/145172.html