盲水印

简介

本文档提供关于盲水印的 API 概览以及 SDK 示例代码。

添加盲水印

功能说明

盲水印支持在上传时添加以及下载时添加。

示例代码：上传时添加盲水印

// bucket名需包含appid
// api 请参考：https://cloud.tencent.com/document/product/436/46782
String bucketName = "examplebucket-1250000000";

String key = "test.png";
File localFile = new File("E://test.png");
PutObjectRequest putObjectRequest = new PutObjectRequest(bucketName, key, localFile);
PicOperations picOperations = new PicOperations();
picOperations.setIsPicInfo(1);
List<PicOperations.Rule> ruleList = new LinkedList<>();
PicOperations.Rule rule = new PicOperations.Rule();
rule.setBucket(bucketName);
rule.setFileId("test-watermark.png");
rule.setRule("watermark/3/type/3/text/dGVuY2VudCBjbG91ZA==");
ruleList.add(rule);
picOperations.setRules(ruleList);
putObjectRequest.setPicOperations(picOperations);
try {
    PutObjectResult putObjectResult = cosClient.putObject(putObjectRequest);
    CIUploadResult ciUploadResult = putObjectResult.getCiUploadResult();
    System.out.println(putObjectResult.getRequestId());
    System.out.println(ciUploadResult.getOriginalInfo().getEtag());
    for(CIObject ciObject:ciUploadResult.getProcessResults().getObjectList()) {
        System.out.println(ciObject.getLocation());
    }
} catch (CosServiceException e) {
    e.printStackTrace();
} catch (CosClientException e) {
    e.printStackTrace();
}

参数说明

PicOperations 类用于记录图像操作，其主要成员说明如下：

返回参数说明

CIUploadResult 类用于返回图片处理结果信息，其主要成员说明如下：

OriginalInfo 类用于记录原图信息，其主要成员说明如下：

ImageInfo 类用于记录原图图片信息，其主要成员说明如下：

ProcessResults 类用于记录图片处理结果，其主要成员说明如下：

CIObject 类用于记录一个图片处理结果，其主要成员说明如下：

示例代码：下载时添加盲水印

GetObjectRequest getObj = new GetObjectRequest(bucketName, key);
// 这里是盲水印规则，具体请参考数据万象API，这里仅是示例
String rule = "watermark/3/type/3/text/dGVuY2VudCBjbG91ZA==";
getObj.putCustomQueryParameter(rule, null);

cosClient.getObject(getObj);

提取盲水印

下面示例展示了如何对已添加盲水印的图片提取盲水印。

示例代码

String bucketName = "examplebucket-1250000000";
String key = "qrcode-watermark.png";
File localFile = new File("E://qrcode-watermark.png");
PutObjectRequest putObjectRequest = new PutObjectRequest(bucketName, key, localFile);
PicOperations picOperations = new PicOperations();
picOperations.setIsPicInfo(1);
List<PicOperations.Rule> ruleList = new LinkedList<>();
PicOperations.Rule rule = new PicOperations.Rule();
rule.setBucket(bucketName);
rule.setFileId("qrcode-watermark-extract.png");
rule.setRule("watermark/4/type/2/image/aHR0cDovL2V4YW1wbGVidWNrZXQtMTI1MDAwMDAwMC5jb3MuYXAtZ3Vhbmd6aG91Lm15cWNsb3VkLmNvbS9zaHVpeWluLnBuZw==");
ruleList.add(rule);
picOperations.setRules(ruleList);
putObjectRequest.setPicOperations(picOperations);
try {
    PutObjectResult putObjectResult = cosClient.putObject(putObjectRequest);
    CIUploadResult ciUploadResult = putObjectResult.getCiUploadResult();
    System.out.println(putObjectResult.getRequestId());
    System.out.println(ciUploadResult.getOriginalInfo().getEtag());
    for(CIObject ciObject:ciUploadResult.getProcessResults().getObjectList()) {
        System.out.println(ciObject.getLocation());
        System.out.println(ciObject.getWatermarkStatus());
    }
} catch (CosServiceException e) {
    e.printStackTrace();
} catch (CosClientException e) {
    e.printStackTrace();
}

参数说明

PicOperations 类用于记录图像操作，其主要成员说明如下：

返回参数说明

CIUploadResult 类用于返回图片处理结果信息，其主要成员说明如下：

OriginalInfo 类用于记录原图信息，其主要成员说明如下：

ImageInfo 类用于记录原图图片信息，其主要成员说明如下：

ProcessResults 类用于记录图片处理结果，其主要成员说明如下：

CIObject 类用于记录一个图片处理结果，其主要成员说明如下：