Video watermarks (visible watermarks)

Overview

Use cases

• Short video platforms: To protect copyrights, videos that are downloaded and shared often include an image watermark (product logo) and a text watermark (user ID).

• Online video services: Brand logos are typically added to videos during playback to claim copyright ownership. In entertainment shows, stickers are also used as watermarks to make content more engaging or to display advertisements.

Features

Add an image watermark in the console

Add an image watermark during job submission

1. Create a watermark template in the console. For more information, see Watermark templates.

2. Create a transcoding job in the console. For more information, see Create a regular transcoding job. To configure watermark settings, follow these steps:

   1. Turn on the Watermark template switch.

   2. From the Watermark template drop-down list, select the watermark template that you created in step 1.

   3. Next to Watermark Image, click Select. From the Bucket drop-down list, select a bucket. The folders in the bucket are displayed under Path. Select an image file to use as the watermark.

      Note

      Supported formats for image watermarks include static PNG images (.png), APNG images (.apng), MOV files (.mov), and GIF files (.gif).

Add an image watermark by workflow

1. Create a watermark template in the console. For more information, see Watermark templates.

2. Create a workflow in the console. For more information, see Create a workflow. To configure watermark settings, follow these steps:

   Note

   Both transcoding workflows and packaging workflows support adding image watermarks. This section uses a packaging workflow as an example. The procedure is the same for a transcoding workflow.

   1. In the workflow topology, click the icon on the Video Extraction node.

   2. Configure the Name and Transcoding Template parameters as needed.

   3. Turn on the Watermark template switch.

   4. From the Watermark template drop-down list, select the watermark template that you created in step 1.

   5. Next to Watermark Image, click Select. From the Bucket drop-down list, select a bucket. The folders in the bucket are displayed under Path. Select an image file to use as the watermark.

      Note

      Image watermarks support PNG images, APNG images, MOV files, and GIF files.

Add watermarks by API

Add an image watermark during job submission

When you submit a transcoding job, specify the WaterMark parameter to add a watermark. You can use a watermark template for image watermarks.

• Type

  Set this parameter to Image to add an image watermark or an animated watermark.

• InputFile

  Specify the OSS object URL of the image or animated watermark. Supported formats include static PNG (.png), APNG (.apng), MOV (.mov), and GIF (.gif).

• WaterMarkTemplateId

  • A watermark template contains all watermark parameters but does not include the asset file.

  • You can create a watermark template in the console or by calling an API operation. For more information, see Watermark templates.

  Note

  If you do not specify a template, the default parameters are used. Parameters specified in the WaterMark object override the corresponding parameters in the watermark template.

• ReferPos, Dx, and Dy

  Use ReferPos to set the reference position of the watermark, such as TopLeft, BottomLeft, TopRight, or BottomRight.

  Then, use Dx and Dy to specify the horizontal and vertical offsets from the reference position. You can set the values in absolute pixels or as a ratio of the output video's resolution.

• Width and Height

  You can set the values in absolute pixels or as a ratio of the output video's resolution.

• Timeline

  Set the start time and duration for the watermark.

Add a text watermark during job submission

When you submit a transcoding job, specify the WaterMark parameter to add a watermark. You cannot use a watermark template to add a text watermark. You must specify the watermark parameters directly:

• Type

  Set this parameter to Text to add a text watermark.

• TextWaterMark

  • Content: Use the Content parameter. Emojis and line breaks are not supported. Text that is too long is truncated.

  • Font style: Use the FontName, FontSize, FontColor, FontAlpha, BorderWidth, and BorderColor parameters to set the font, size, color, and other styles.

  • Position: Use the Top and Left parameters to set the offset in absolute pixels from the top-left corner of the output video.

  • Example: {"Content":"5rWL6K+V5paH5a2X5******","FontName":"SimSun","FontSize":"16","Top":2,"Left":10}

Sample code