為視頻檔案添加可見的圖文浮水印 - ApsaraVideo Media Processing

在視頻中添加可見的明浮水印（例如，企業Logo、電視台台標），可以突出品牌和著作權，增加產品識別度。ApsaraVideo for Media Processing支援圖片浮水印、動畫浮水印和文字浮水印三種浮水印類型，您可按需選擇。本文介紹視頻明浮水印的功能特性及使用方式。

功能概述

功能	說明	API相關參數	控制台操作
圖片浮水印	單個視頻最多添加4組浮水印，支援設定浮水印開始時間、持續時間長度、出現的固定位置、浮水印大小。圖片浮水印支援PNG靜態圖片（副檔名.png）、PNG動圖（副檔名.apng）、MOV檔案（副檔名.mov）、GIF檔案（副檔名.gif）。支援使用浮水印模板簡化開發。	WaterMarks	支援
文字浮水印	單個視頻最多添加4組浮水印，支援設定浮水印開始時間、持續時間長度、出現的固定位置、浮水印大小。文字浮水印可設定文字內容、字型大小、字型、顏色、透明度、描邊效果等。支援的字型及顏色請參見字型支援、顏色。不支援使用浮水印模板。	WaterMarks	不支援

說明

當前ApsaraVideo for Media Processing控制台僅支援添加圖片浮水印，如需添加文字浮水印請通過API操作。

提交轉碼作業時，指定WaterMark參數添加浮水印。圖片浮水印支援使用模板。

Type（浮水印類型）
添加圖片浮水印、動畫浮水印時，設定為Image。
InputFile（浮水印檔案）
設定圖片浮水印或動畫浮水印的OSS檔案地址，支援PNG靜態圖片（副檔名.png）、PNG動圖（副檔名.apng）、MOV檔案（副檔名.mov）、GIF檔案（副檔名.gif）。
WaterMarkTemplateId（圖片浮水印模板ID）
- 浮水印模板包含了所有浮水印參數，但不包括素材。
- 浮水印模板可以通過控制台或API建立，參見浮水印模板。
說明
若不設定模板，則使用預設參數。WaterMark對象中的對應參數比浮水印模板的參數優先順序更高，會覆蓋模板中配置的對應參數。
ReferPos、Dx、Dy（浮水印圖片位置參數）
使用ReferPos設定浮水印顯示的參考位置，如左上方、左下角、右上方、右下角。
再設定基於該參考位置的偏離量Dx、Dy。支援按照像素絕對值和相對輸出視頻解析度的比例設定。
Width、Height（浮水印尺寸參數）
支援按照像素絕對值和相對輸出視頻解析度的比例設定。
Timeline（圖片浮水印的顯示時間）
設定浮水印開始時間、持續時間長度。

提交轉碼作業時，指定WaterMark參數添加浮水印。文字浮水印不支援使用模板，需直接指定如下浮水印參數：

Type（浮水印類型）
添加文字浮水印時，設定為Text
TextWaterMark（文字浮水印設定）
- 文字內容：使用Content參數。不支援emoji，文字不支援換行，太長會超出畫面截斷；
- 字型樣式：使用FontName、FontSize、FontColor、FontAlpha、BorderWidth、BorderColor參數，設定字型、字型大小、顏色等。
- 浮水印位置：設定浮水印距離輸出視頻左上方的偏離像素絕對值Top、Left。
- 樣本：{"Content":"5rWL6K+V5paH5a2X5******","FontName":"SimSun","FontSize":"16","Top":2,"Left":10}

在轉碼成720P（1280×720）清晰度的MP4視頻檔案時，同時設定3個浮水印，並顯式覆蓋浮水印參數：

具體範例程式碼如下：