tencent cloud

All product documents
Video on Demand
DocumentationVideo on DemandDevelopment GuideMedia ProcessingVideo ProcessingVideo ConversionWatermarking
Watermarking
Download PDF
Last updated: 2020-04-02 17:07:23
Watermarking
Last updated: 2020-04-02 17:07:23
Download PDF
Watermarking is an offline task that adds an image or text at the specified position of the video during video transcoding or screencapturing. VOD supports the following types of watermarks:
Static image watermark: this refers to an image watermark in PNG format. It can be a copyright owner's or TV station's logo and is generally used to indicate the video copyright ownership.
Animated image watermark: this refers to an image watermark in APNG format, which can be animated.
Text watermark: this refers to a multi-lingual text watermark. It can be a user's nickname and is generally used to identify the producer of UGSV content.
VOD can add multiple watermarks to a video or screenshot. The size and position can be customized individually.

Watermarking Template

The target specification of a watermark is subject to parameters such as watermark type, width, height, and position, which can be customized in the form of VOD watermarking template as shown below:
Parameter
Description
Type
Image and text watermarks are supported:
Image watermark: Static or animated images are supported.
Text watermark: Texts in various languages are supported.
Position
Relative position of a watermark in the video.
ImageSize
Size of a watermark in the video.
ImageContent
Binary content of a watermark.
FontSize
Font size of a text watermark.
FontType
Font of a text watermark, e.g., Times New Roman.
FontColor
Color of a text watermark, e.g., 0xRRGGBB.
FontAlpha
Transparency of text watermark. Value range: 0–100%.
You can use the console (for detailed directions, please see Template Settings) or call a server API to create and manage custom watermarking templates.

Task Initiation

There are three ways to initiate a transcoding task with watermark, namely, directly initiating through server API, directly initiating through the console, and specifying a task upon upload. For more information, please see Task Initiation for video processing.
Below are instructions for initiating transcoding tasks with watermark in these ways:
Call the server API ProcessMedia to initiate a task: specify the watermarking template ID in the MediaProcessTask.TranscodeTaskSet parameter in the request.
Initiate a task on a video through the console: add a task flow in the console, set the watermark specification in the task flow, and use the task flow to initiate video processing.
Specify a task upon upload from server: add a task flow in the console, set the target watermark specification in the task flow, and specify this task flow as the procedure in the ApplyUpload request.
Specify a task upon upload from client: add a task flow in the console, set the target watermark specification in the task flow, and specify this task flow as the procedure parameter in the signature for upload from client.
Upload through console: add a task flow in the console, set the target watermark specification in the task flow, upload a video through the console, select Process Video During Upload, and specify to execute this task flow upon video upload completion.

Getting Result

After initiating a transcoding task with watermark, you can wait for result notification asynchronously or perform task query synchronously to get the task execution result. Below is an example of getting the result notification in normal callback mode after the transcoding task with watermark is initiated (the fields with null value are omitted):
{
    "EventType":"ProcedureStateChanged",
    "ProcedureStateChangeEvent":{
        "TaskId":"1256768367-Procedure-2e1af2456351812be963e309cc133403t0",
        "Status":"FINISH",
        "FileId":"5285890784246869930",
        "FileName":"Animal World",
        "FileUrl":"http://1256768367.vod2.myqcloud.com/xxx/xxx/AtUCmy6gmIYA.mp4",
        "MetaData":{
            "AudioDuration":60,
            "AudioStreamSet":[
                {
                    "Bitrate":383854,
                    "Codec":"aac",
                    "SamplingRate":48000
                }
            ],
            "Bitrate":1021028,
            "Container":"mov,mp4,m4a,3gp,3g2,mj2",
            "Duration":60,
            "Height":480,
            "Rotate":0,
            "Size":7700180,
            "VideoDuration":60,
            "VideoStreamSet":[
                {
                    "Bitrate":637174,
                    "Codec":"h264",
                    "Fps":23,
                    "Height":480,
                    "Width":640
                }
            ],
            "Width":640
        },
        "MediaProcessResultSet":[
            {
                "Type":"Transcode",
                "TranscodeTask":{
                    "Status":"SUCCESS",
                    "ErrCode":0,
                    "Message":"",
                    "Input":{
                        "Definition":220,
                        "WatermarkSet": [
                            {
                                "Definition": 23120
                            }
                        ]
                    },
                    "Output":{
                        "Url":"http://1256768367.vod2.myqcloud.com/xxx/xxx/v.f20.m3u8",
                        "Size":63120997,
                        "Container":"mov,mp4,m4a,3gp,3g2,mj2",
                        "Height":1086,
                        "Width":1920,
                        "Bitrate":513402,
                        "Md5":"084d403c73930ca2f835679af1f37bd3",
                        "Duration":60,
                        "VideoStreamSet":[
                            {
                                "Bitrate":473101,
                                "Codec":"h264",
                                "Fps":24,
                                "Height":480,
                                "Width":640
                            }
                        ],
                        "AudioStreamSet":[
                            {
                                "Bitrate":48581,
                                "Codec":"aac",
                                "SamplingRate":44100
                            }
                        ],
                        "Definition":220
                    }
                }
            }
        ],
        "TasksPriority":0,
        "TasksNotifyMode":""
    }
}
In the callback result, ProcedureStateChangeEvent.MediaProcessResultSet contains the transcoding result in Type of Transcode: the transcoding specification Definition is 220, and a watermark is added during transcoding, whose specification Definition is 23120.
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Contact Us
Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

Submit a Ticket
7x24 Phone Support
Hong Kong, China
+852 800 906 020 (Toll Free)
United States
+1 844 606 0804 (Toll Free)
United Kingdom
+44 808 196 4551 (Toll Free)
Canada
+1 888 605 7930 (Toll Free)
Australia
+61 1300 986 386 (Toll Free)
EdgeOne hotline
+852 300 80699
More local hotlines coming soon