ApsaraVideo VOD：視頻圖文浮水印

1. 登入ApsaraVideo for VOD控制台。

2. 在左側導覽列選擇組態管理 > ApsaraVideo for Media Processing配置 > 浮水印模板，進入到浮水印模板頁面。

3. 單擊添加浮水印，您可按需設定圖片浮水印或文字浮水印。

   圖片浮水印參數說明

   參數	描述
   浮水印類型	選擇圖片。
   浮水印素材	上傳浮水印圖片。 說明 控制台僅支援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]。
   預覽畫面尺寸	可以根據實際視頻資訊輸入，以便預覽浮水印文字在實際視頻上的展示位置和效果。單位：像素。

4. 單擊儲存，完成配置。

   浮水印模板建立成功後，您可以在浮水印模板列表頁面查看已建立的浮水印模板及浮水印模板的ID。

調用AddWatermark - 添加圖文浮水印模板介面，建立浮水印模板。浮水印模板建立成功後，將會返回浮水印模板ID。

• 圖片浮水印

  可通過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。

1. 登入ApsaraVideo for VOD控制台。

2. 在左側導覽列選擇組態管理 > ApsaraVideo for Media Processing配置 > 轉碼模板組，進入到轉碼模板組頁面。

3. 單擊添加轉碼模板組，進入到添加轉碼模板組頁面。

4. 設定轉碼模板組的名稱。

5. 在左側的普通轉碼模板或視頻打包模板地區下單擊添加模板，配置轉碼參數並開啟圖文浮水印。

   • 清晰度：不支援原畫（轉封裝）。

   • 浮水印模板：選擇在步驟一中建立的一個或多個浮水印模板。

   • 其他參數保持預設或根據您的實際需求變更，具體參數解釋及配置建議，請參見轉碼模板。

6. 單擊儲存，完成轉碼模板組的建立。

   建立完成後，您可以在轉碼模板組列表頁面中查看已建立的轉碼模板組及轉碼模板組ID。

調用AddTranscodeTemplateGroup - 建立轉碼模板組介面建立轉碼模板組，在轉碼模板配置TranscodeTemplateList參數中通過傳入WatermarkIds參數來關聯浮水印模板ID。

1. 登入ApsaraVideo for VOD控制台。

2. 在左側導覽列選擇組態管理 > ApsaraVideo for Media Processing配置 > 工作流程管理，進入到工作流程管理頁面。

3. 單擊添加工作流程，進入添加工作流程頁面。

4. 輸入工作流程的名稱。

5. 在工作流程拓撲結構中新增或編輯工作流程節點。

   以添加媒體轉碼節點為例，在開始處單擊+選擇媒體轉碼。單擊媒體轉碼的修改按鈕，按需自訂節點名稱並選擇轉碼模板組為步驟二中建立的已關聯浮水印模板的轉碼模板組。

6. 單擊確認，完成工作流程的建立。

   工作流程建立成功後，您可以在工作流程列表頁面查看已建立的工作流程及工作流程ID。

情境一：上傳時自動觸發添加浮水印任務

1. 登入ApsaraVideo for VOD控制台。

2. 在左側導覽列選擇媒資庫 > 音/視頻，進入到音視頻列表頁面。

3. 單擊上傳音/視頻，單擊添加音/視頻，選擇上傳方式、儲存地址等參數後，選擇用轉碼模板組處理並指定步驟二中建立的已開啟圖文浮水印的轉碼模板組，或選擇用工作流程處理並指定步驟三中建立的包含已開啟圖文浮水印的媒體轉碼節點的工作流程。

   關於上傳的格式支援及參數解釋等資訊，詳情請參見通過ApsaraVideo for VOD控制台上傳檔案。

4. 將待上傳的視頻添加進來後，單擊開始上傳。

   視頻上傳完成後，將根據您設定的轉碼模板組或工作流程自動進行轉碼處理。

情境二：上傳後主動發起添加浮水印任務

1. 登入ApsaraVideo for VOD控制台。

2. 在左側導覽列選擇媒資庫 > 音/視頻，進入到音視頻列表頁面。

3. 在音/視頻列表頁面，在需要發起轉碼的視頻的操作列單擊ApsaraVideo for Media Processing。

4. 根據您的實際需要，選擇用轉碼模板組處理並指定步驟二中建立的已開啟圖文浮水印的轉碼模板組，或選擇用工作流程處理並指定步驟三中建立的包含已開啟圖文浮水印的媒體轉碼節點的工作流程。

5. 單擊確定。

情境一：上傳時自動觸發添加浮水印任務

調用CreateUploadVideo - 擷取音視頻上傳地址和憑證或UploadMediaByURL - URL批量拉取上傳介面上傳音視頻時，將TemplateGroupId參數指定為步驟二中建立的已開啟圖文浮水印的轉碼模板組ID，或將WorkflowId參數指定為步驟三中建立的包含已開啟圖文浮水印的媒體轉碼節點的工作流程ID，則音視頻上傳完成後，點播系統將根據您指定的轉碼模板組或工作流程自動進行轉碼處理。

情境二：上傳後主動發起添加浮水印任務

• 通過轉碼模板組發起轉碼：調用SubmitTranscodeJobs - 提交媒體轉碼作業介面，將TemplateGroupId參數指定為步驟二中建立的已開啟圖文浮水印的轉碼模板組ID。

• 通過工作流程發起轉碼：調用SubmitWorkflowJob - 提交點播工作流程作業介面，將WorkflowId參數指定為驟三中建立的包含已開啟圖文浮水印的媒體轉碼節點的工作流程ID。

1. 登入ApsaraVideo for VOD控制台。

2. 在左側導覽列選擇媒資庫 > 音/視頻，進入到音視頻列表頁面。

3. 在音視頻列表頁面，查看目標視頻的狀態。

   當視頻狀態為正常時，表示浮水印轉碼已處理完成並成功。

4. 單擊視頻所在行的管理，進入到基礎資訊頁面。

5. 單擊視頻地址頁簽，在視頻地址頁面可以查看該視頻輸出的各路轉碼流並擷取相應的播放地址。

您可以通過轉碼任務ID定時輪詢轉碼任務執行狀態和執行結果。轉碼任務相關介面如下：

• GetTranscodeTask - 查詢轉碼任務詳情

• GetTranscodeSummary - 查詢音視頻轉碼摘要

• ListTranscodeTask - 查詢轉碼工作清單