:How do I add a watermark?

Type

Parameter description

When submitting transcoding tasks,you can specify a watermark template and material to add watermark information for the output video.

You can specify several WaterMark objects for each transcoding task. A WaterMark object contains the following parameters:

• WaterMarkTemplateId (watermark template ID)

  A watermark template contains common parameters such as Type, ReferPos, Width, Height, Dx, and Dy.

  You can create a template on the Media Processing console. For more information, see Watermark transcoding template.

  Note The parameters in WaterMark objects have a higher priority than the corresponding parameters in the template. The parameters in WaterMark objects overwrite those parameters in the template.
• Type (watermark type)

  When adding image or animated watermarks, you can set Type to Image and specify InputFile, which is the OSS file path of the watermark materials.

  When adding text watermarks, you can set Type to Text and specify the TextWaterMark parameter, including text font, size, color, and transparency.

• ReferPos (watermark position)

  The reference position where a watermark is displayed. Dx and Dy are calculated based on ReferPos. See Watermark template configuration.

  Watermark coordinate description:
• Width, Height, Dx, and Dy
  Specify the width, height, horizontal offset, and vertical offset of a watermark. The values can be calculated in the following two ways:

  • Absolute value:

    Units: pixels. Value range: [8,4096].

  • Relative scale:

    The width and height relative to the output video resolution. Value range: (0, 1). Up to four digits are allowed after the decimal point, for example, 0.9999.

  • Default value:

    • The default value is 0 when Dx and Dy are not set.

    • When neither Width nor Height is set, the watermark width is 0.12 times the resolution width of the output video. The watermark height scales proportionally according to the aspect ratio of the original watermark image.

    • When either Width or Height is set, the unspecified parameter scales proportionally based on the aspect ratio of the original watermark image.

    • When both Width and Height are set, the watermark image is set based on the specified values.

• InputFile (input file)
  Specifies the OSS file location of an image or animated watermark. Images in PNG format and animations in MOV and APNG formats can be used as watermarks.

  Note The file extension of an animated watermark must be mov or apng in lowercase. File extensions of images are not limited.
• TextWaterMark (text watermark)
  Specifies the detailed parameters of text watermarks.

  Note The reference position and relative scale cannot be set for text watermarks. You can specify the upper-left corner as the reference position and specify Dx and Dy offsets according to the absolute values.

Scenarios

Short videos

In this scenario, you can add an image watermark (product logo) and a text watermark (user ID) to downloaded or shared short videos to protect copyright.

Example:

Audio and video websites

For audio and video websites, you can add brand logos to videos to demonstrate copyright ownership. Additionally, you can also add stickers to videos of entertainment programs to make the programs more interesting or increase advertisement exposure.

Code example