You need to enable JavaScript to run this app.
导航
动态替换文字水印内容
最近更新时间:2024.08.26 11:16:50首次发布时间:2023.03.27 20:43:15

本文为您介绍如何通过配置自定义文字水印变量 Key,实现在触发工作流时动态替换文字水印内容。

注意

该功能为白名单功能。使用前请提交工单联系火山引擎技术支持团队申请开通。

配置自定义变量 key

您需要在点播控制台创建水印贴片模板时配置自定义变量 key,具体步骤如下:

  1. 登录视频点播控制台,进入指定空间。
  2. 单击左侧导航栏媒体处理设置 > 媒体处理模板
  3. 水印贴片模板页签下,单击添加水印贴片模板按钮。
  4. 开启添加水印按钮并开启添加明水印按钮。
  5. 根据页面提示,完成文字水印的参数配置。请注意以下参数配置:
    1. 水印类型选择 Text
    2. 水印内容设置规则为 var://<variable_key>,详细说明如下所示。
      1. var:// 为固定值。
      2. <variable_key> 为自定义变量 key,需满足的规则:首字符为字母或下划线,其他字符为字母、数字或者下划线,长度不超过 64 个字符。例如:input_text

      说明

      单个文字水印仅支持设置一个变量 key。您可添加多个文字水印,设置不同的变量。

  6. 单击保存按钮,完成模板创建。

设置自定义变量 value

在视频点播控制台配置自定义变量 key 后,您可以在调用 StartWorkflow 接口时,通过设置 WorkflowParams 参数来配置自定义变量的 value。具体参数使用如下所示。

WorkflowParams

参数

类型

是否必选

描述

OverrideParams

OverrideParams

用于覆盖模板中的参数。

OverrideParams

参数

类型

是否必选

描述

Logo

Array of LogoOverride

水印内容覆盖参数

LogoOverride

参数

类型

是否必选

描述

TemplateId

String

水印贴片模板 ID。支持设为 All,表示对所有水印贴片模板生效。

Vars

JSON MAP

水印覆盖内容。格式为 key:value

  • key:String 类型,水印模板。该值为配置自定义文字水印模板中的 input_text
  • value:String 类型,水印覆盖的内容。您可根据自身业务需求,自定义文字水印内容,例如“测试”。

示例

以下为配置自定义变量 input_text 的工作流参数:

{
  "Uri": "",
  "Decryption": {
    "Type": "",
    "Key": ""
  },
  "OverrideParams": {
    "Logo": [
      {
        "TemplateId": "all",
        "Vars": {
          "input_text": "YOUR_INPUT_TEXT"
        }
      }
    ]
  },
  "Condition": {},
}