CDN：添加浮水印

注意事項

• 支援同時添加多個浮水印，且支援同時添加圖片浮水印和文字浮水印，最多支援添加5個。

• 圖片浮水印暫不支援縮放，浮水印圖片原圖不能超過1 MB。

參數說明

操作名稱：watermark

• 基礎參數（浮水印位置）

  參數	說明	取值範圍
  t	指定浮水印圖片或浮水印文字的透明度。	[0,100] 預設值為100， 表示透明度100%（即不透明）。
  g	指定浮水印在圖片中的位置。	nw：左上 north：中上 ne：右上 west：左中 center：中部 east：右中 sw：左下 south：中下 se：右下 詳情請參見上方基準點圖片。
  x	指定浮水印的水平邊距， 即距離圖片邊緣的水平距離。這個參數只有當浮水印位置是左上、左中、左下、右上、右中、右下才有意義。	[0,4096] 預設值為10 ，單位：px（像素）。
  y	指定浮水印的垂直邊距，即距離圖片邊緣的垂直距離。 這個參數只有當浮水印位置是左上、中上、右上、左下、中下、右下才有意義。	[0,4096] 預設值為10， 單位：px（像素）。

水平邊距、垂直邊距、中線垂直位移不僅可以調節浮水印在圖片中的位置，當圖片存在多重浮水印時，還可以調節浮水印在圖中的布局。

• 圖片浮水印參數

  參數	說明	取值範圍
  image	指定可以訪問的圖片浮水印地址，浮水印地址可以公開訪問，若有鑒權或使用權限設定，可能導致擷取浮水印地址失敗。 浮水印地址需進行Base64編碼。詳細資料，請參見浮水印編碼。	Base64編碼後的字串。

• 文字浮水印參數

  參數	說明	取值範圍
  text	指定文字浮水印的文字內容，文字內容需進行Base64編碼。詳細資料，請參見浮水印編碼。	Base64編碼後的字串，最大長度不能超過60個字元。
  type	指定文字浮水印的字型，字型名稱需進行Base64編碼。詳細資料，請參見浮水印編碼。	共支援10種文字字型，字型及字型編碼請參見文字類型編碼對應表。 說明 如果您使用的是10種文字字型之外的其他字型，系統會識別出您使用的是預設字型alihyaihei。
  color	指定文字浮水印的文字顏色，參數值為RGB顏色值。	RGB顏色值，例如：000000表示黑色，FFFFFF表示白色。 預設值：000000（黑色）。
  rotate	指定文字順時針旋轉角度。	[0,360] 預設值：0，表示不旋轉。
  fill	指定是否將文字浮水印鋪滿原圖。	[0,1]，預設值為0。 0：表示不將文字浮水印鋪滿原圖。 1：表示將文字浮水印鋪滿原圖。
  size	指定文字浮水印的文字大小。	(0,1000] 預設值：40 單位：px

  type參數中可選的文字類型及編碼如下表所示。

  文字字型	中文含義	編碼值
  alihyaihei	阿里漢儀智能黑體，預設字型	YWxpaHlhaWhlaQ
  hysong	漢儀宋體	aHlzb25n
  hyhei	漢儀黑體	aHloZWk
  hyshuangxian	漢儀雙線體	aHlzaHVhbmd4aWFu
  comfortaa	Comfortaa	Y29tZm9ydGFh
  notosans	NotoSans	bm90b3NhbnM

浮水印編碼

添加浮水印時，文字浮水印的文字內容、文字字型和圖片浮水印的浮水印地址需進行URL安全的Base64編碼。編碼方式如下：

1. 將內容編碼成Base64。

   推薦使用URL-safe Base64編碼工具對文字浮水印的文字內容、文字字型和圖片浮水印的浮水印地址進行編碼。浮水印編碼後的內容僅適合應用在浮水印操作的特定參數中，請勿將其用在簽名字串（Signature）的內容裡。

2. 替換編碼結果中的部分編碼。

   • 將結果中的加號（+）替換成短劃線（-）。

   • 將結果中的正斜線（/）替換成底線（_）。

   • 將結果中尾部的等號（=）省略。