本文介绍智能媒体服务图片水印模板参数和对应模板示例。

名称类型必填描述示例值
Widthnumber是输出视频上水印图片宽。 值有两种形式：
  • 整数型代水印图片宽的像素值。
    • 范围：[8,4096]。
    • 单位：px。
  • 小数型代表相对输出视频分辨率宽的比率。
    • 范围：(0,1)。
    • 支持4位小数，如0.9999，超出部分系统自动丢弃。
32
Heightnumber是输出视频上水印图片高。 值有两种形式：
  • 整数型代水印图片高的像素值。
    • 范围：[8,4096]。
    • 单位：px。
  • 小数型代表相对输出视频分辨率高的比率。
    • 范围：(0,1)。
    • 支持4位小数，如0.9999，超出部分系统自动丢弃。
32
Dxnumber否水印图片相对输出视频的水平偏移量。默认值：0。值有两种形式：
  • 整数型代表偏移像素。
    • 范围：[8,4096]。
    • 单位：px。
  • 小数型代表水平偏移量与输出分辨率宽的比率。
    • 范围：(0,1)。
    • 支持4位小数，如0.9999，超出部分系统自动丢弃。
10
Dynumber否水印图片相对输出视频的垂直偏移量。默认值：0。值有两种形式：
  • 整数型代表偏移像素。
    • 范围：[8,4096]。
    • 单位：px。
  • 小数型代表垂直偏移量与输出分辨率高的比率。
    • 范围：(0,1)。
    • 支持4位小数，如0.9999，超出部分系统自动丢弃。
10
ReferPosstring是水印的位置。默认值：TopRight。可取值：
  • TopRight：右上。
  • TopLeft：左上。
  • BottomRight：右下。
  • BottomLeft：左下。
TopLeft
TimelineJSON否动态水印显示时间设置。详细信息请参见Timeline。{"Start":"00:00:05","Duration":"ToEND"}
FileJSON否水印图片文件。详细信息请参见File。{"Type":"OSS","Media":"oss://examplebucket/path/to/image****.png"}

Timeline

名称类型必填描述示例值
Startstring是水印开始出现时间。
  • 单位：秒。
  • 取值范围：数字。
  • 默认值：0。
00:00:05
Durationstring否水印持续时间。
  • 取值范围：[数字,ToEND]。
  • 默认值：ToEND。
ToEND

File

名称类型必填描述示例值
Typestring是 媒体对象类型。 取值：
  • OSS：OSS文件。
  • Media：媒资ID。
OSS
Mediastring是媒体值。
  • type为OSS时，为URL，支持OSS协议和HTTP协议。
  • type为Media时，为媒资ID。
oss://examplebucket/path/to/image****.png

模板示例

{
  "Dx": 120,
  "Dy": 130,
  "Height": 30,
  "ReferPos": "BottomLeft",
  "File": {
    "Type": "OSS",
    "Media": "https://sample-bucket.oss-cn-shanghai.aliyuncs.com/sample.gif"
  },
  "Width": 20
}