Object Storage Service：圖片浮水印

使用情境

• 著作權保護：為保護自己的作品不被未授權使用或複製，需要在圖片上加上浮水印來標識著作權。

• 品牌推廣：企業或個人為了宣傳自己的品牌或標識，會在圖片、視頻或文檔上加上帶有品牌標誌或名稱的浮水印。

• 防止篡改：在某些官方檔案、認證或報告上添加浮水印，可以增加篡改的難度，減少檔案被偽造的風險。

• 抵制盜圖：在網路環境中，圖片很容易被他人下載和再次發布。加浮水印可以作為一種警示，減少他人直接盜用圖片的情況。

• 法律要求：某些情況下，法律或合約條款可能要求在特定內容發布時必須加上浮水印，以符合規定。

注意事項

• 您可以通過檔案URL、SDK、API方式設定圖片處理參數。本文以檔案URL為例進行介紹。檔案URL僅適用於公用訪問的圖片。如果是私人訪問的圖片，請使用SDK、API處理圖片。更多資訊，請參見圖片處理操作方式。

• 圖片浮水印只能使用當前儲存空間內的圖片，網路或本地圖片需上傳至當前儲存空間內方可使用。

• 圖片浮水印目前僅支援JPG、PNG、BMP、WebP、TIFF格式。

• 單張圖片最多支援添加3張不同的圖片浮水印，且各個圖片浮水印的位置不能完全重疊。

• 文字浮水印暫不支援繁體中文。

參數說明

操作名稱：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）
  voffset	否	指定浮水印的中線垂直位移。當浮水印位置在左中、中部、右中時，可以指定浮水印位置根據中線往上或者往下位移。	[-1000,1000] 預設值：0 單位：像素（px）
  fill	否	指定是否將圖片浮水印或文字浮水印鋪滿原圖。 說明 如果您需要使用圖片浮水印平鋪功能，請在配額中心申請。	1：將圖片浮水印或文字浮水印鋪滿原圖。 0（預設值）：不將圖片浮水印或文字浮水印鋪滿全圖。
  padx	否	浮水印平鋪時單個浮水印間的水平間隔。僅在浮水印平鋪開啟時有效。	[0,4096] 預設值：0 單位：像素（px）
  pady	否	浮水印平鋪時單個浮水印間的垂直間隔。僅在浮水印平鋪開啟時有效。	[0,4096] 預設值：0 單位：像素（px）

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

  地區數值以及每個地區對應的基準點如下圖所示。

• 圖片浮水印參數

  參數	是否必須	描述	取值範圍
  image	是	用於指定作為圖片浮水印Object的完整名稱，Object名稱需進行Base64編碼。詳情請參見浮水印編碼。 例如，作為圖片浮水印的Object為Bucket內image目錄下的panda.png，則需要編碼的內容為image/panda.png，編碼後的字串為aW1hZ2UvcGFuZGEucG5n。 說明 浮水印圖片只能使用當前儲存空間內的Object。	Base64編碼後的字串。

• 浮水印圖片預先處理參數

  您可以使用圖片縮放、自訂裁剪、索引切割、圓角矩形及圖片旋轉操作中的所有參數對浮水印圖片進行預先處理。此外，浮水印圖片在進行預先處理時，還額外支援縮放參數P：

  參數	描述	取值範圍
  P	指定圖片浮水印按照要添加浮水印的原圖的比例進行縮放，取值為縮放的百分比。如設定參數值為10，如果原圖為100×100， 則圖片浮水印大小為10×10。當原圖變成了200×200，則圖片浮水印大小為20×20。	[1,100]

• 文字浮水印參數

  參數	是否必須	描述	取值範圍
  text	是	指定文字浮水印的文字內容，文字內容需進行Base64編碼。詳情請參見浮水印編碼。	Base64編碼之前中文字串的最大位元組長度為64個字元。
  type	否	指定文字浮水印的字型，字型名稱需進行Base64編碼。	支援的字型及字型編碼詳情請參見文字類型編碼對應表。 預設值：wqy-zenhei（ 編碼後的值為d3F5LXplbmhlaQ）
  color	否	指定文字浮水印的文字顏色，參數值為RGB顏色值。	RGB顏色值，例如：000000表示黑色，FFFFFF表示白色。 預設值：000000（黑色）
  size	否	指定文字浮水印的文字大小。	(0,1000] 預設值：40 單位：px
  shadow	否	指定文字浮水印的陰影透明度。	[0,100] 預設值：0，表示沒有陰影。
  rotate	否	指定文字順時針旋轉角度。	[0,360] 預設值：0，表示不旋轉。

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

  參數值	中文含義	編碼值
  wqy-zenhei	文泉驛正黑	d3F5LXplbmhlaQ
  wqy-microhei	文泉微米黑	d3F5LW1pY3JvaGVp
  fangzhengshusong	方正書宋	ZmFuZ3poZW5nc2h1c29uZw
  fangzhengkaiti	方正楷體	ZmFuZ3poZW5na2FpdGk
  fangzhengheiti	方正黑體	ZmFuZ3poZW5naGVpdGk
  fangzhengfangsong	方正仿宋	ZmFuZ3poZW5nZmFuZ3Nvbmc
  droidsansfallback	DroidSansFallback	ZHJvaWRzYW5zZmFsbGJhY2s

• 圖文混合浮水印參數

  參數	是否必須	描述	取值範圍
  order	否	指定文字和圖片浮水印的前後順序。	0、1 0（預設值）：表示圖片浮水印在前。 1：表示文字浮水印在前。
  align	否	指定文字浮水印和圖片浮水印的對齊。	0、1、2 0：表示文字浮水印和圖片浮水印上對齊。 1：表示文字浮水印和圖片浮水印中對齊。 2（預設值）：表示文字浮水印和圖片浮水印下對齊。
  interval	否	指定文字浮水印和圖片浮水印間的間距。	[0,1000] 預設值：0 單位：px

浮水印編碼

在添加浮水印操作中，文字浮水印的文字內容、文字字型、圖片浮水印的浮水印圖片名稱等參數需要進行URL安全的Base64編碼。編碼步驟如下：

1. 將內容編碼成Base64。

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

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

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

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

推薦通過base64url encoder對文字浮水印的文字內容、文字顏色、文字字型、圖片浮水印的浮水印圖片名稱等參數進行編碼。

操作方式

import com.aliyun.oss.*;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.model.GetObjectRequest;
import java.io.File;

public class Demo {
    public static void main(String[] args) throws Throwable {
        // Endpoint以華東1（杭州）為例，其它Region請按實際情況填寫。
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // 填寫Endpoint對應的Region資訊，例如cn-hangzhou。
        String region = "cn-hangzhou";
        // 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // 填寫Bucket名稱，例如examplebucket。
        String bucketName = "examplebucket";
        // 填寫Object完整路徑。Object完整路徑中不能包含Bucket名稱。
        String objectName = "src.jpg";
        // 填寫本地檔案的完整路徑，例如D:\\localpath\\example-new.jpg。如果指定的本地檔案存在會覆蓋，不存在則建立。
        String pathName = "D:\\dest.jpg";

        // 建立OSSClient執行個體。
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(credentialsProvider)
                .clientConfiguration(clientBuilderConfiguration)
                .region(region)
                .build();

        try {
            // 為圖片添加Hello World文字浮水印。
            String image = "image/watermark,text_SGVsbG8gV29ybGQ";
            GetObjectRequest request = new GetObjectRequest(bucketName, objectName);
            request.setProcess(image);
            // 將處理後的圖片命名為example-new.jpg並儲存到本地。
            // 如果未指定本地路徑只填寫了檔案名稱（例如example-new.jpg），則檔案預設儲存到樣本程式所屬專案對應本地路徑中。
            ossClient.getObject(request, new File("D:\\dest.jpg"));
        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
}

<?php
if (is_file(__DIR__ . '/../autoload.php')) {
    require_once __DIR__ . '/../autoload.php';
}
if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    require_once __DIR__ . '/../vendor/autoload.php';
}
use OSS\Credentials\EnvironmentVariableCredentialsProvider;
use OSS\OssClient;

// 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
$provider = new EnvironmentVariableCredentialsProvider();
// yourEndpoint填寫Bucket所在地區對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
$endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// 填寫Bucket名稱，例如examplebucket。
$bucket= "examplebucket";
// 填寫Object完整路徑，例如exampledir/exampleobject.jpg。Object完整路徑中不能包含Bucket名稱。
$object = "src.jpg";
// 填寫本地檔案的完整路徑，例如D:\\localpath\\example-new.jpg。如果指定的本地檔案存在會覆蓋，不存在則建立。
// 如果未指定本地路徑只填寫了本地檔案名稱（例如example-new.jpg），則檔案預設儲存到樣本程式所屬專案對應本地路徑中。
$download_file = "D:\\dest.jpg";

$config = array(
        "provider" => $provider,
        "endpoint" => $endpoint,        
        "signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
        // 填寫阿里雲通用Region ID。
        "region" => "cn-hangzhou"
    );
$ossClient = new OssClient($config);

// 為圖片添加Hello World的文字浮水印。
$image = "image/watermark,text_SGVsbG8gV29ybGQ";

$options = array(
    OssClient::OSS_FILE_DOWNLOAD => $download_file,
    OssClient::OSS_PROCESS => $image);

// 將處理後的圖片儲存到本地。
$ossClient->getObject($bucket, $object, $options);                           

# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

# 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# yourEndpoint填寫Bucket所在地區對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
## 填寫Bucket所在地區對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'
# 填寫阿里雲通用Region ID。
region = 'cn-hangzhou'
bucket = oss2.Bucket(auth, endpoint, 'examplebucket', region=region)
# 指定原圖名稱。如果圖片不在Bucket根目錄，需攜帶圖片完整路徑，例如exampledir/example.jpg。
key = 'src.jpg'
# 指定處理後的圖片名稱。
new_pic = 'D:\\dest.jpg'

# 為圖片添加Hello World的文字浮水印。
image = 'image/watermark,text_SGVsbG8gV29ybGQ'
bucket.get_object_to_file(key, new_pic, process=image)

package main

import (
	"fmt"
	"os"

	"github.com/aliyun/aliyun-oss-go-sdk/oss"
)

func HandleError(err error) {
	fmt.Println("Error:", err)
	os.Exit(-1)
}

func main() {
	// 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}

	// 建立OSSClient執行個體。
	// yourEndpoint填寫Bucket對應的Endpoint，以華東1（杭州）為例，填寫為https://oss-cn-hangzhou.aliyuncs.com。其它Region請按實際情況填寫。
	client, err := oss.New("https://oss-cn-hangzhou.aliyuncs.com", "", "", oss.SetCredentialsProvider(&provider), oss.AuthVersion(oss.AuthV4), oss.Region("cn-hangzhou"))
	if err != nil {
		HandleError(err)
	}

	// 指定原圖所在的Bucket名稱，例如examplebucket。
	bucketName := "examplebucket"
	bucket, err := client.Bucket(bucketName)
	if err != nil {
		HandleError(err)
	}

	// 指定原圖名稱。如果圖片不在Bucket根目錄，需攜帶圖片完整路徑，例如exampledir/example.jpg。
	sourceImageName := "src.jpg"
	// 指定處理後的圖片名稱。
	targetImageName := "D://dest.jpg"
	// 為圖片添加Hello World的文字浮水印。
	image := "image/watermark,text_SGVsbG8gV29ybGQ"
	err = bucket.GetObjectToFile(sourceImageName, targetImageName, oss.Process(image))
	if err != nil {
		HandleError(err)
	}
}

GET /oss.jpg?x-oss-process=image/watermark,w_100 HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS qn6q**************:77Dv****************

常見問題

如何使用網狀圖片或本地圖片作為浮水印圖片？

通過OSS的圖片處理為圖片添加圖片浮水印時，僅可以使用相同儲存空間內的圖片作為浮水印圖片。若您希望使用網狀圖片或本地圖片作為浮水印圖片，需要先將圖片上傳到原圖所在儲存空間，之後再使用上傳的圖片作為浮水印圖片處理原圖。

添加文字浮水印時提示“font content is too large”怎麼辦？

通過OSS的圖片處理為圖片添加文字浮水印時，最長不能超過64個字元（1個漢字計為3個字元）。當提示“font content is too large”時，建議您縮短文字長度，然後為圖片添加文字浮水印。更多資訊，請參見樣本一：添加文字浮水印。

私人檔案添加圖片浮水印失敗怎麼辦？

私人檔案的訪問URL帶有簽名。OSS不支援在帶簽名的URL後直接添加圖片處理參數。如果您想要對私人檔案進行圖片處理，需要將圖片處理參數加入到簽名中。更多資訊，請參見產生帶圖片處理參數的檔案簽名URL。

添加圖片浮水印時可以為浮水印增加背景色嗎？

不可以。

如何使用簽名URL訪問圖片？

私人檔案的訪問URL帶有簽名。OSS不支援在帶簽名的URL後直接添加圖片處理參數。如果您想要對私人檔案進行圖片處理，需要將圖片處理參數加入到簽名中。更多資訊，請參見圖片處理。

添加浮水印時支援垂直排列嗎？

如果您希望在添加浮水印時垂直排列，可以拆分成多個浮水印操作，通過多個watermark運算元實現垂直排列效果。

例如：https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/watermark,text_SGVsbG8gV29ybGQ/watermark,text_SGVsbG8gV29ybGQy,y_60

如何根據圖片的大小動態調整浮水印的大小？

OSS的圖片處理不支援動態調整浮水印的大小，在實際應用中，您可能需要編寫自訂邏輯來檢測圖片的尺寸，然後根據一定的比例或規則來決定文字浮水印的大小。這一步驟需要您在調用OSS介面前，在用戶端或服務端代碼中實現。

可以同時為圖片增加幾個浮水印？

3個。如果您需要為圖片增加更多浮水印，請提交工單申請。