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