全部產品
Search
文件中心

Edge Security Acceleration:添加浮水印

更新時間:Apr 01, 2025

添加浮水印可以用於品牌推廣和宣傳,還可以協助保護圖片的著作權,防止他人未經授權使用圖片。ESA支援圖片浮水印和文字浮水印,可以將浮水印放在圖片的特定位置,並調整浮水印的透明度,以便在不干擾圖片內容的情況下顯示浮水印。

參數說明

操作名稱:watermark

  • 基礎參數(浮水印位置)浮水印位置

    參數

    說明

    取值範圍

    t

    指定浮水印圖片或浮水印文字的透明度。

    0 ~ 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種字型,字型及字型編碼請參見type參數中可選的文字類型及編碼

    color

    指定文字浮水印的文字顏色,參數值為RGB顏色值。

    RGB顏色值,預設值:000000-黑色。

    rotate

    指定文字順時針旋轉角度。

    0~360,預設值:0-不旋轉,單位:度。

    fill

    指定是否將文字浮水印鋪滿原圖。

    可選值0或者1,預設值為0

    • 0:不將文字浮水印鋪滿原圖。

    • 1:將文字浮水印鋪滿原圖。

    size

    指定文字浮水印的文字大小。

    1 ~ 1000,預設值:40,單位:px

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

    文字字型

    中文含義

    編碼值

    alihyaihei

    阿里漢儀智能黑體,預設字型

    YWxpaHlhaWhlaQ

    hysong

    漢儀宋體

    aHlzb25n

    hyhei

    漢儀黑體

    aHloZWk

    hyshuangxian

    漢儀雙線體

    aHlzaHVhbmd4aWFu

    fzltzhk

    方正蘭亭中黑

    ZnpsdHpoaw

    fzshengsks

    方正盛世楷書

    ZnpzaGVuZ3Nrcw

    fzqusongjian

    方正趣宋簡體

    ZnpxdXNvbmdqaWFu

    zzgfxingyan

    造字工房星岩

    enpnZnhpbmd5YW4

    comfortaa

    Comfortaa

    Y29tZm9ydGFh

    notosans

    NotoSans

    bm90b3NhbnM

    說明

    若您使用的字型未在下表的10種字型中,系統將自動切換為預設字型alihyaihei

浮水印編碼

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

  1. 將內容編碼成Base64。

    說明

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

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

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

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

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

操作樣本

  • 僅添加文字浮水印:

    對文字浮水印的內容Hello World進行URL安全的Base64位編碼。具體操作,請參見浮水印編碼,編碼結果為SGVsbG8gV29ybGQ;hysong字型的為編碼為aHlzb25n。圖片處理URL為:http(s)://example.com/image01.png?image_process=watermark,text_SGVsbG8gV29ybGQ,type_aHlzb25n

  • 同時添加文字和圖片浮水印:

    • 文字浮水印內容:新年快樂,進行URL安全的Base64位編碼結果為:5paw5bm05b-r5LmQ,浮水印位置是右下、水平邊距10、垂直邊距10:g_se,x_10,y_10

    • 圖片浮水印地址:http://example-test.oss-ap-southeast-1.aliyuncs.com/image/shuiyin.png,Base64編碼後為aHR0cDovL2V4YW1wbGUtdGVzdC5vc3MtYXAtc291dGhlYXN0LTEuYWxpeXVuY3MuY29tL2ltYWdlL3NodWl5aW4ucG5n。浮水印圖片位於原圖的左上方、水平邊距10、垂直邊距10:g_nw,x_10,y_10

    • 圖片處理URL:http(s)://example.com/image01.png?image_process=watermark,text_5paw5bm05b-r5LmQ,g_se,x_10,y_10/watermark,image_aHR0cDovL2V4YW1wbGUtdGVzdC5vc3MtYXAtc291dGhlYXN0LTEuYWxpeXVuY3MuY29tL2ltYWdlL3NodWl5aW4ucG5n,g_nw,x_10,y_10