視頻水印，指在視頻上添加相關標志性信息（如企業Logo、電視臺臺標、用戶昵稱、用戶ID等），以突出品牌、維護版權、增加產品的識別度。視頻點播支持靜態圖片水印、動圖水印和文字水印三種水印類型，您可按需選擇。
工作原理
視頻點播的水印基于轉碼實現，即指在視頻的編解碼過程中將圖片、文字等信息壓制到視頻流中合并輸出一個帶圖文水印的新的視頻文件。
應用場景
短視頻
短視頻場景中，被下載和分享的視頻，通常帶有一個圖片水?。óa品Logo）和一個文字水?。ㄓ脩鬒D），用于保護版權。
音視頻網站
音視頻網站，通常會在視頻上添加品牌Logo，宣示版權歸屬。同時，在綜藝節目中，也會加入貼紙元素，增加趣味性或增加廣告展現。
水印類型
類型 | 支持格式 | 使用說明 |
圖片 |
|
|
文字 | - | 支持設置文字的字體、字號、顏色、透明度、字體描邊等效果。 |
費用說明
視頻點播的水印基于轉碼實現，轉碼涉及費用產生，計費詳情請參見媒資轉碼計費。
如何使用
步驟一：創建水印模板
為了簡化水印任務的處理過程，視頻點播將復雜的水印位置、水印大小、水印文字的字體、顏色等水印參數固化成模板，并通過具有唯一性的模板ID來指代。
控制臺方式
登錄視頻點播控制臺。
在左側導航欄選擇配置管理 > 媒體處理配置 > 水印模板，進入到水印模板頁面。
單擊添加水印，您可按需設置圖片水印或文字水印。
圖片水印參數說明
參數
描述
水印類型
選擇圖片。
水印素材
上傳水印圖片。
說明控制臺僅支持PNG和GIF格式，大小不超過20 MB。
水印名稱
輸入水印模板名稱。
說明名稱可包含中英文、數字、
#、-。尺寸（寬x高）
設置水印圖片的大小。更多信息，請參見水印位置及水印尺寸參數詳解。
正整型：單位，像素。取值范圍為[8,4096]。
畫面占比：單位，%。取值范圍為（0,100），精確到小數點后2位。
說明水印圖片的寬或高如果只設置一邊，則另外一邊會按照原圖的比例進行縮放。
位置
水印圖片相對輸出視頻畫面的大概位置。默認為右上，用于標示水印初始位置。更多信息，請參見水印位置及水印尺寸參數詳解。取值：
左上
左下
右上
右下
水平偏移
水印圖片在輸出視頻畫面上水平偏移距離。更多信息，請參見水印位置及水印尺寸參數詳解。
正整型：單位，像素。取值范圍[8，4096]。
畫面占比：單位，%。取值范圍（0，100），精確到小數點后2位。
垂直偏移
水印圖片在輸出視頻畫面上垂直偏移距離。更多信息，請參見水印位置及水印尺寸參數詳解。
正整型：單位，像素。取值范圍[8，4096]。
畫面占比：單位，%。取值范圍（0，100），精確到小數點后2位。
時間線
水印時間線用于控制水印圖片在視頻畫面上的開始顯示時間以及持續顯示時間，可以通過多組水印配置控制水印圖片在視頻畫面中的動態顯示效果。
說明文字水印暫不支持該參數。
預覽畫面尺寸（寬x高）
可以根據實際視頻信息輸入，以便預覽水印圖片在實際視頻上的展示位置和效果。單位：像素。
文字水印參數說明
參數
說明
水印類型
選擇文字。
水印內容
輸入需要作為水印的文字內容。
水印名稱
輸入水印模板的名稱。
說明名稱可包含中英文、數字、
#、-。字體
水印文字的字體。取值：
宋體
文泉驛正黑
文泉驛等寬正黑
文泉驛點陣正黑
圓體-簡常規體
字號
水印文字的字體大小，單位：像素。
透明度
水印文字的透明度，值越小越透明。單位：像素，精確到小數點后2位。取值范圍：(0, 1]。
字體顏色
設置水印文字的字體顏色。
描邊寬度
字體描邊的寬度大小，單位：像素。取值范圍：(0, 4096]。
描邊顏色
設置字體描邊顏色。
垂直偏移
水印文字在輸出視頻畫面上的垂直偏移距離。更多信息，請參見水印位置及水印尺寸參數詳解。
正整型：單位，像素。取值范圍[8,4096]。
水平偏移
水印文字在輸出視頻畫面上的水平偏移距離。更多信息，請參見水印位置及水印尺寸參數詳解。
正整型：單位，像素。取值范圍[8,4096]。
預覽畫面尺寸
可以根據實際視頻信息輸入，以便預覽水印文字在實際視頻上的展示位置和效果。單位：像素。
單擊保存，完成配置。
水印模板創建成功后，您可以在水印模板列表頁面查看已創建的水印模板及水印模板的ID。
OpenAPI方式
調用AddWatermark - 添加水印接口，創建水印模板。水印模板創建成功后，將會返回水印模板ID。
通過接口創建圖片類型的水印模板時，需要調用CreateUploadAttachedMedia - 獲取輔助媒資上傳地址和憑證接口先將水印圖片上傳到視頻點播中。如何上傳，請參見通過視頻點播API上傳媒體文件。
水印位置及水印尺寸參數詳解
圖片水印
可通過ReferPos、Dx、Dy、Width、Height控制圖片在輸出視頻畫面中的顯示位置以及效果。
API參數
控制臺參數
描述
ReferPos
位置
水印相對輸出視頻畫面的大概位置。
左上角：TopLeft
左下角：BottomLeft
右上角：TopRight
右下角：BottomRight
Dx
水平偏移
水印在輸出視頻畫面上水平偏移距離。取值：
正整型，單位：像素；取值范圍[8,4096]。
畫面占比，單位：%；取值范圍(0,1)。
Dy
垂直偏移
水印在輸出視頻畫面上垂直偏移距離。取值：
正整型，單位：像素；取值范圍[8,4096]。
畫面占比，單位：%；取值范圍(0,1)。
Width
尺寸（寬）
水印在輸出視頻畫面中顯示的寬。取值：
正整型，單位：像素；取值范圍[8,4096]。
畫面占比，單位：%；取值范圍(0,1)。
Height
尺寸（高）
水印在輸出視頻畫面中顯示的高。取值：
正整型，單位：像素；取值范圍[8,4096]。
畫面占比，單位：%；取值范圍(0,1)。
Timeline
時間線
水印時間線用于控制圖片水印在視頻畫面上的開始顯示時間以及持續顯示時間，可以通過多組水印配置控制圖片水印在視頻畫面的動態顯示效果。更多信息，請參見水印時間線 Timeline。
重要文字水印暫不支持該參數。
示意圖
如需水印居中顯示，則可按照畫面占比設置Dx=0.5、Dy=0.5參數調整（水印的偏移位置為視頻輸出畫面寬高的50%）。
文字水印
文字水印暫時只支持相對輸出視頻畫面的左上角開始偏移，偏移參數為Top、Left，暫只支持像素取值，不支持畫面占比類參數取值。
API參數
控制臺參數
描述
Top
垂直偏移
文字水印距離輸出視頻畫面的上邊距離。單位：像素，取值范圍[8,4096]。
Left
水平偏移
文字水印距離輸出視頻畫面的左邊距離。單位：像素，取值范圍[8,4096]。
示意圖
計算方式
圖片水印的Dx、Dy、Width、Height參數支持正整型和畫面占比取值兩種計算模式，文字水印的Top和Left只支持正整型取值，具體如下：
正整型取值，單位：像素，取值范圍[8,4096]。
重要如果設置的參數超過視頻輸出畫面的大小，則可能導致水印局部顯示或者不顯示。
例如：視頻輸出畫面為640×360，相對位置為TopLeft，Dx=4000，Dy=4000，則輸出畫面上看不到水?。ㄎ淖炙∫嗍侨绱耍?。
畫面占比取值：相對輸出視頻分辨率寬度、高度的占比值，取值范圍(0,1)，精確到小數點后四位。
重要如果輸出畫面比例多變不可控，建議按照畫面占比設置水印位置、尺寸相關參數。
例如：0.9999。計算示例：Width/視頻寬 = 0.1；Height/視頻高 = 0.06；Dx/視頻寬 = 0.02；Dy/視頻高 = 0.03。
默認值
水印寬、高都不設置：水印寬=視頻輸出畫面寬×0.12，水印高按照水印原圖比例等比縮放。
寬、高設置其中一個：設置的一邊按照設置的參數輸出，另一邊按照水印原圖比例等比縮放。例如：Width=44，原圖寬高比例是2：1，則Height=22。
寬、高都設置：則水印尺寸按照設置的參數輸出。
Dx、Dy不設置時，則默認取值為0。
步驟二：創建轉碼模板組并關聯水印模板
視頻水印基于轉碼實現，轉碼任務需基于轉碼模板組發起。一個轉碼模板可同時關聯多個水印模板。
控制臺方式
OpenAPI方式
調用AddTranscodeTemplateGroup - 創建轉碼模板組接口創建轉碼模板組，在轉碼模板配置TranscodeTemplateList參數中通過傳入WatermarkIds參數來關聯水印模板ID。
步驟三（可選）：創建工作流并關聯轉碼模板組
在工作流中將轉碼、審核、截圖等各種類型的媒體處理任務按一定流程進行編排，后續在上傳媒體或媒體處理環節觸發工作流時，可以使媒體文件按預先編排好的一系列任務流程自動發起處理。當前僅支持通過控制臺方式創建工作流。更多信息，請參見工作流。
控制臺方式
登錄視頻點播控制臺。
在左側導航欄選擇配置管理 > 媒體處理配置 > 工作流管理，進入到工作流管理頁面。
單擊添加工作流，進入添加工作流頁面。
輸入工作流的名稱。
在工作流拓撲結構中新增或編輯工作流節點。
以添加媒體轉碼節點為例，在開始處單擊+選擇媒體轉碼。單擊媒體轉碼的修改按鈕，按需自定義節點名稱并選擇轉碼模板組為步驟二中創建的已關聯水印模板的轉碼模板組。
單擊確認，完成工作流的創建。
工作流創建成功后，您可以在工作流列表頁面查看已創建的工作流及工作流ID。
步驟四（可選）：配置轉碼事件通知
建議您在發起轉碼任務之前，配置視頻點播的事件通知，以便在轉碼任務完成后，能從接收到的回調消息中獲取到轉碼任務的狀態及結果等信息。事件通知的配置方法，請參見回調設置。
轉碼涉及的事件通知類型如下：
步驟五：發起水印轉碼任務
視頻點播支持在上傳媒體和媒體處理環節去觸發轉碼?？梢灾苯踊谵D碼模板組發起轉碼，或基于包含媒體轉碼節點的工作流去發起轉碼。
控制臺方式
場景一：上傳時自動觸發添加水印任務
登錄視頻點播控制臺。
在左側導航欄選擇媒資庫 > 音/視頻，進入到音視頻列表頁面。
單擊上傳音/視頻，單擊添加音/視頻，選擇上傳方式、存儲地址等參數后，選擇用轉碼模板組處理并指定步驟二中創建的已開啟圖文水印的轉碼模板組，或選擇用工作流處理并指定步驟三中創建的包含已開啟圖文水印的媒體轉碼節點的工作流。
關于上傳的格式支持及參數解釋等信息，詳情請參見通過視頻點播控制臺上傳文件。
將待上傳的視頻添加進來后，單擊開始上傳。
視頻上傳完成后，將根據您設置的轉碼模板組或工作流自動進行轉碼處理。
場景二：上傳后主動發起添加水印任務
登錄視頻點播控制臺。
在左側導航欄選擇媒資庫 > 音/視頻，進入到音視頻列表頁面。
在音/視頻列表頁面，在需要發起轉碼的視頻的操作列單擊媒體處理。
根據您的實際需要，選擇用轉碼模板組處理并指定步驟二中創建的已開啟圖文水印的轉碼模板組，或選擇用工作流處理并指定步驟三中創建的包含已開啟圖文水印的媒體轉碼節點的工作流。
單擊確定。
OpenAPI方式
場景一：上傳時自動觸發添加水印任務
CreateUploadVideo - 獲取音視頻上傳地址和憑證接口僅用于獲取上傳地址和憑證以及創建媒資基礎信息，并非上傳文件，需要開發者自行實現所有上傳邏輯。通過接口上傳的完整示例，請參見通過視頻點播API上傳媒資文件。
調用CreateUploadVideo - 獲取音視頻上傳地址和憑證或UploadMediaByURL - URL批量拉取上傳接口上傳音視頻時，將TemplateGroupId參數指定為步驟二中創建的已開啟圖文水印的轉碼模板組ID，或將WorkflowId參數指定為步驟三中創建的包含已開啟圖文水印的媒體轉碼節點的工作流ID，則音視頻上傳完成后，點播系統將根據您指定的轉碼模板組或工作流自動進行轉碼處理。
場景二：上傳后主動發起添加水印任務
通過轉碼模板組發起轉碼：調用SubmitTranscodeJobs - 提交媒體轉碼作業接口，將
TemplateGroupId參數指定為步驟二中創建的已開啟圖文水印的轉碼模板組ID。通過工作流發起轉碼：調用SubmitWorkflowJob - 提交點播工作流作業接口，將
WorkflowId參數指定為驟三中創建的包含已開啟圖文水印的媒體轉碼節點的工作流ID。
步驟六：獲取結果
異步等待結果通知
如果您已配置事件通知，可以通過接收單個清晰度轉碼完成或全部清晰度轉碼完成回調消息獲取水印轉碼任務信息。
同步進行查詢任務
登錄視頻點播控制臺。
在左側導航欄選擇媒資庫 > 音/視頻，進入到音視頻列表頁面。
在音視頻列表頁面，查看目標視頻的狀態。
當視頻狀態為正常時，表示水印轉碼已處理完成并成功。
單擊視頻所在行的管理，進入到基礎信息頁面。
單擊視頻地址頁簽，在視頻地址頁面可以查看該視頻輸出的各路轉碼流并獲取相應的播放地址。
您可以通過轉碼任務ID定時輪詢轉碼任務執行狀態和執行結果。轉碼任務相關接口如下：
實際應用示例
結合視頻點播可同時設置多個水印及通過API來動態替換水印內容的能力，針對常用場景介紹水印設置流程。
短視頻版權聲明--文字水印動態替換
場景說明
在短視頻場景中，用戶上傳到短視頻平臺的視頻，經短視頻平臺被其他用戶下載或分享時，通常都會攜帶短視頻平臺的Logo以及視頻原創者的ID或者昵稱。
期望效果
圖片水印 + 文字水印，不同用戶文字水印的內容不同。
實現流程
創建2個水印模板，一個為圖片水印模板（水印圖片設置為短視頻平臺Logo），一個為文字水印模板（水印文字設置為視頻原創者的ID或者昵稱）。具體操作，請參見步驟一：創建水印模板。
創建轉碼模板組并關聯上一步創建的2個水印模板。具體操作，請參見步驟二：創建轉碼模板組并關聯水印模板。
通過SubmitTranscodeJobs - 提交媒體轉碼作業接口發起轉碼，轉碼時通過
OverrideParams參數傳入WatermarkId和Content，實現對指定水印模板的水印文字內容進行覆蓋替換。OverrideParams的傳參示例：{"Watermarks":[{"WatermarkId":"修改為圖片水印的模板ID"},{"WatermarkId":"修改為文字水印的模板ID","Content":"修改為需替換的水印文字內容"}]}您需要根據您的實際業務情況自行設計轉碼任務的觸發邏輯，例如在用戶上傳視頻時觸發轉碼，轉碼時自動讀取視頻原創者的ID或者昵稱進行文字水印的內容替換。
視頻網站品牌宣傳--圖片水印動態替換
場景說明
某視頻網站經正規渠道獲得某影視劇的總版權后，再二次授權給多個不同的視頻網站供用戶觀看，則在各視頻網站中投放的視頻需要攜帶網站自己的品牌Logo。
期望效果
圖片水印，不同視頻網站圖片水印不同。
實現流程
調用CreateUploadAttachedMedia - 獲取輔助媒資上傳地址和憑證接口先將水印圖片（各視頻網站的品牌Logo）上傳到視頻點播中。如何上傳，請參見通過視頻點播API上傳媒體文件。
創建一個圖片水印模板，水印圖片設置為視頻網站的品牌Logo。具體操作，請參見步驟一：創建水印模板。
創建轉碼模板組并關聯上一步創建的圖片水印模板。具體操作，請參見步驟二：創建轉碼模板組并關聯水印模板。
通過SubmitTranscodeJobs - 提交媒體轉碼作業接口發起轉碼，轉碼時通過
OverrideParams參數傳入WatermarkId和FileUrl，實現對指定水印模板的水印圖片進行覆蓋替換。OverrideParams的傳參示例：{"Watermarks":{"WatermarkId":"修改為圖片水印的模板ID","FileUrl":"修改為需替換的水印圖片地址"}}您需要根據您的實際業務情況自行設計轉碼任務的觸發邏輯，例如在上傳視頻時觸發轉碼。
SDK示例
常見問題
在視頻點播控制臺添加水印圖片失敗，提示圖片地址不可用
如已在點播中配置加速域名，則需要為域名配置HTTPS證書，配置方法請參見HTTPS安全加速設置。
相關文檔
視頻點播支持數字水印功能，數字水印是一種暗水印，通過將水印信息隱藏到載體中的技術，人眼無法從視頻畫面中感知到水印的存在，水印信息經過特殊編碼，難以被篡改，使數字水印具有效果美觀、安全可靠等特點，可廣泛應用于版權保護、泄露溯源等場景。更多信息，請參見數字水印。
如需實現視頻播放時實時展示播放用戶的昵稱或ID等信息以震懾侵權行為，可以通過阿里云播放器SDK的跑馬燈功能實現。更多信息，請參見播放器動態水印（ID跑馬燈）。