视频点播：视频图文水印

1. 登录视频点播控制台。

2. 在左侧导航栏选择配置管理 > 媒体处理配置 > 水印模板，进入到水印模板页面。

3. 单击添加水印，您可按需设置图片水印或文字水印。

   图片水印参数说明

   参数	描述
   水印类型	选择图片。
   水印素材	上传水印图片。 说明 控制台仅支持PNG和GIF格式，大小不超过20 MB。
   水印名称	输入水印模板名称。 说明 名称可包含中英文、数字、#、-。
   尺寸（宽x高）	设置水印图片的大小。更多信息，请参见水印位置及水印尺寸参数详解。 正整型：单位，像素。取值范围为[8,4096]。 画面占比：单位，%。取值范围为（0,100），精确到小数点后2位。 说明 水印图片的宽或高如果只设置一边，则另外一边会按照原图的比例进行缩放。
   位置	水印图片相对输出视频画面的大概位置。默认为右上，用于标示水印初始位置。更多信息，请参见水印位置及水印尺寸参数详解。取值： 左上 左下 右上 右下
   水平偏移	水印图片在输出视频画面上水平偏移距离。更多信息，请参见水印位置及水印尺寸参数详解。 正整型：单位，像素。取值范围[8，4096]。 画面占比：单位，%。取值范围（0，100），精确到小数点后2位。
   垂直偏移	水印图片在输出视频画面上垂直偏移距离。更多信息，请参见水印位置及水印尺寸参数详解。 正整型：单位，像素。取值范围[8，4096]。 画面占比：单位，%。取值范围（0，100），精确到小数点后2位。
   时间线	水印时间线用于控制水印图片在视频画面上的开始显示时间以及持续显示时间，可以通过多组水印配置控制水印图片在视频画面中的动态显示效果。 说明 文字水印暂不支持该参数。
   预览画面尺寸（宽x高）	可以根据实际视频信息输入，以便预览水印图片在实际视频上的展示位置和效果。单位：像素。

   文字水印参数说明

   参数	说明
   水印类型	选择文字。
   水印内容	输入需要作为水印的文字内容。
   水印名称	输入水印模板的名称。 说明 名称可包含中英文、数字、#、-。
   字体	水印文字的字体。取值： 宋体 文泉驿正黑 文泉驿等宽正黑 文泉驿点阵正黑 圆体-简常规体
   字号	水印文字的字体大小，单位：像素。
   透明度	水印文字的透明度，值越小越透明。单位：像素，精确到小数点后2位。取值范围：(0, 1]。
   字体颜色	设置水印文字的字体颜色。
   描边宽度	字体描边的宽度大小，单位：像素。取值范围：(0, 4096]。
   描边颜色	设置字体描边颜色。
   垂直偏移	水印文字在输出视频画面上的垂直偏移距离。更多信息，请参见水印位置及水印尺寸参数详解。 正整型：单位，像素。取值范围[8,4096]。
   水平偏移	水印文字在输出视频画面上的水平偏移距离。更多信息，请参见水印位置及水印尺寸参数详解。 正整型：单位，像素。取值范围[8,4096]。
   预览画面尺寸	可以根据实际视频信息输入，以便预览水印文字在实际视频上的展示位置和效果。单位：像素。

4. 单击保存，完成配置。

   水印模板创建成功后，您可以在水印模板列表页面查看已创建的水印模板及水印模板的ID。

调用AddWatermark - 添加水印接口，创建水印模板。水印模板创建成功后，将会返回水印模板ID。

• 图片水印

  可通过ReferPos、Dx、Dy、Width、Height控制图片在输出视频画面中的显示位置以及效果。

  API参数	控制台参数	描述
  ReferPos	位置	水印相对输出视频画面的大概位置。 左上角：TopLeft 左下角：BottomLeft 右上角：TopRight 右下角：BottomRight
  Dx	水平偏移	水印在输出视频画面上水平偏移距离。取值： 正整型，单位：像素；取值范围[8,4096]。 画面占比，单位：%；取值范围(0,1)。
  Dy	垂直偏移	水印在输出视频画面上垂直偏移距离。取值： 正整型，单位：像素；取值范围[8,4096]。 画面占比，单位：%；取值范围(0,1)。
  Width	尺寸（宽）	水印在输出视频画面中显示的宽。取值： 正整型，单位：像素；取值范围[8,4096]。 画面占比，单位：%；取值范围(0,1)。
  Height	尺寸（高）	水印在输出视频画面中显示的高。取值： 正整型，单位：像素；取值范围[8,4096]。 画面占比，单位：%；取值范围(0,1)。
  Timeline	时间线	水印时间线用于控制图片水印在视频画面上的开始显示时间以及持续显示时间，可以通过多组水印配置控制图片水印在视频画面的动态显示效果。更多信息，请参见水印时间线 Timeline。 重要 文字水印暂不支持该参数。

  示意图

  如需水印居中显示，则可按照画面占比设置Dx=0.5、Dy=0.5参数调整（水印的偏移位置为视频输出画面宽高的50%）。

• 文字水印

  文字水印暂时只支持相对输出视频画面的左上角开始偏移，偏移参数为Top、Left，暂只支持像素取值，不支持画面占比类参数取值。

  API参数	控制台参数	描述
  Top	垂直偏移	文字水印距离输出视频画面的上边距离。单位：像素，取值范围[8,4096]。
  Left	水平偏移	文字水印距离输出视频画面的左边距离。单位：像素，取值范围[8,4096]。

  示意图

• 计算方式

  图片水印的Dx、Dy、Width、Height参数支持正整型和画面占比取值两种计算模式，文字水印的Top和Left只支持正整型取值，具体如下：

  • 正整型取值，单位：像素，取值范围[8,4096]。

    重要

    如果设置的参数超过视频输出画面的大小，则可能导致水印局部显示或者不显示。

    例如：视频输出画面为640×360，相对位置为TopLeft，Dx=4000，Dy=4000，则输出画面上看不到水印（文字水印亦是如此）。

  • 画面占比取值：相对输出视频分辨率宽度、高度的占比值，取值范围(0,1)，精确到小数点后四位。

    重要

    如果输出画面比例多变不可控，建议按照画面占比设置水印位置、尺寸相关参数。

    例如：0.9999。计算示例：Width/视频宽 = 0.1；Height/视频高 = 0.06；Dx/视频宽 = 0.02；Dy/视频高 = 0.03。

• 默认值

  • 水印宽、高都不设置：水印宽=视频输出画面宽×0.12，水印高按照水印原图比例等比缩放。

  • 宽、高设置其中一个：设置的一边按照设置的参数输出，另一边按照水印原图比例等比缩放。例如：Width=44，原图宽高比例是2：1，则Height=22。

  • 宽、高都设置：则水印尺寸按照设置的参数输出。

  • Dx、Dy不设置时，则默认取值为0。

1. 登录视频点播控制台。

2. 在左侧导航栏选择配置管理 > 媒体处理配置 > 转码模板组，进入到转码模板组页面。

3. 单击添加转码模板组，进入到添加转码模板组页面。

4. 设置转码模板组的名称。

5. 在左侧的普通转码模板或视频打包模板区域下单击添加模板，配置转码参数并开启图文水印。

   • 清晰度：不支持原画（转封装）。

   • 水印模板：选择在步骤一中创建的一个或多个水印模板。

   • 其他参数保持默认或根据您的实际需求进行更改，具体参数解释及配置建议，请参见配置普通转码模板。

6. 单击保存，完成转码模板组的创建。

   创建完成后，您可以在转码模板组列表页面中查看已创建的转码模板组及转码模板组ID。

调用AddTranscodeTemplateGroup - 创建转码模板组接口创建转码模板组，在转码模板配置TranscodeTemplateList参数中通过传入WatermarkIds参数来关联水印模板ID。

1. 登录视频点播控制台。

2. 在左侧导航栏选择配置管理 > 媒体处理配置 > 工作流管理，进入到工作流管理页面。

3. 单击添加工作流，进入添加工作流页面。

4. 输入工作流的名称。

5. 在工作流拓扑结构中新增或编辑工作流节点。

   以添加媒体转码节点为例，在开始处单击+选择媒体转码。单击媒体转码的修改按钮，按需自定义节点名称并选择转码模板组为步骤二中创建的已关联水印模板的转码模板组。

6. 单击确认，完成工作流的创建。

   工作流创建成功后，您可以在工作流列表页面查看已创建的工作流及工作流ID。

场景一：上传时自动触发添加水印任务

1. 登录视频点播控制台。

2. 在左侧导航栏选择媒资库 > 音/视频，进入到音视频列表页面。

3. 单击上传音/视频，单击添加音/视频，选择上传方式、存储地址等参数后，选择用转码模板组处理并指定步骤二中创建的已开启图文水印的转码模板组，或选择用工作流处理并指定步骤三中创建的包含已开启图文水印的媒体转码节点的工作流。

   关于上传的格式支持及参数解释等信息，详情请参见通过视频点播控制台上传文件。

4. 将待上传的视频添加进来后，单击开始上传。

   视频上传完成后，将根据您设置的转码模板组或工作流自动进行转码处理。

场景二：上传后主动发起添加水印任务

1. 登录视频点播控制台。

2. 在左侧导航栏选择媒资库 > 音/视频，进入到音视频列表页面。

3. 在音/视频列表页面，在需要发起转码的视频的操作列单击媒体处理。

4. 根据您的实际需要，选择用转码模板组处理并指定步骤二中创建的已开启图文水印的转码模板组，或选择用工作流处理并指定步骤三中创建的包含已开启图文水印的媒体转码节点的工作流。

5. 单击确定。

场景一：上传时自动触发添加水印任务

调用CreateUploadVideo - 获取音视频上传地址和凭证或UploadMediaByURL - URL批量拉取上传接口上传音视频时，将TemplateGroupId参数指定为步骤二中创建的已开启图文水印的转码模板组ID，或将WorkflowId参数指定为步骤三中创建的包含已开启图文水印的媒体转码节点的工作流ID，则音视频上传完成后，点播系统将根据您指定的转码模板组或工作流自动进行转码处理。

场景二：上传后主动发起添加水印任务

• 通过转码模板组发起转码：调用SubmitTranscodeJobs - 提交媒体转码作业接口，将TemplateGroupId参数指定为步骤二中创建的已开启图文水印的转码模板组ID。

• 通过工作流发起转码：调用SubmitWorkflowJob - 提交点播工作流作业接口，将WorkflowId参数指定为骤三中创建的包含已开启图文水印的媒体转码节点的工作流ID。

1. 登录视频点播控制台。

2. 在左侧导航栏选择媒资库 > 音/视频，进入到音视频列表页面。

3. 在音视频列表页面，查看目标视频的状态。

   当视频状态为正常时，表示水印转码已处理完成并成功。

4. 单击视频所在行的管理，进入到基础信息页面。

5. 单击视频地址页签，在视频地址页面可以查看该视频输出的各路转码流并获取相应的播放地址。

您可以通过转码任务ID定时轮询转码任务执行状态和执行结果。转码任务相关接口如下：

• GetTranscodeTask - 查询转码任务详情

• GetTranscodeSummary - 查询音视频转码摘要

• ListTranscodeTask - 查询转码任务列表