在視頻中添加可見的明水印(例如,企業Logo、電視臺臺標),可以突出品牌和版權,增加產品識別度。媒體處理支持圖片水印、動畫水印和文字水印三種水印類型,您可以按需選擇。本文提供了Java SDK為視頻添加可見明水印相關功能的API調用示例,包含創建水印模板、提交文字水印作業、提交圖片水印作業。
前提條件
使用前請先初始化客戶端,詳細操作請參見初始化。
創建水印模板
水印模板是一系列包含水印位置、大小的參數,使用水印模板,可以幫助您簡化開發操作。調用AddWaterMarkTemplate接口,完成水印模板創建。
/**
* 創建水印模板
* @param client
* @return
* @throws Exception
*/
public static AddWaterMarkTemplateResponse addWaterMarkTemplate(DefaultAcsClient client) throws Exception {
AddWaterMarkTemplateRequest request = new AddWaterMarkTemplateRequest();
request.setName("test name");
//水印參數詳情, 參見http://m.bestwisewords.com/document_detail/29253.htm#section-k53-tt4-8b0
JSONObject waterMarkConfig = new JSONObject();
waterMarkConfig.put("Dx","10");
waterMarkConfig.put("Dy","5");
waterMarkConfig.put("ReferPos","TopRight");
request.setConfig(waterMarkConfig.toJSONString());
return client.getAcsResponse(request);
}
提交水印任務
為視頻添加水印會改變畫面的內容,需要對視頻重新編碼。在媒體處理中,您需要調用SubmitJobs接口,提交水印任務。
說明
通過SDK提交作業時,Object需經URLEncode,否則會導致作業失敗。詳細說明,請參見URL Encoding說明。
請按照規范填寫文件名稱,否則會找不到文件導致作業失敗。詳細名稱規范,請參見參數詳情。
建議您在提交作業時記錄任務的JobID,便于后續進行其他相關操作。
文字水印
/**
* 提交文字水印轉碼作業
* @param client
* @return
* @throws Exception
*/
public static SubmitJobsResponse submitTextWaterMarkJobs(DefaultAcsClient client) throws Exception {
SubmitJobsRequest request = new SubmitJobsRequest();
//構建輸出參數
JSONArray outputs = new JSONArray();
//構建input, 需要保證Location區域和服務client區域一致
JSONObject input = new JSONObject();
input.put("Location", "oss-cn-beijing");
input.put("Bucket", "<your bucket name>");
//構建一個輸出對象
JSONObject output = new JSONObject();
try {
input.put("Object", URLEncoder.encode("mps-test/demo/test.mp4", "utf-8"));
String outPutObject = URLEncoder.encode("mps-test/demo/test-out-watermark.mp4", "utf-8");
output.put("OutputObject", outPutObject);
} catch (UnsupportedEncodingException e) {
throw new RuntimeException("input URL encode failed");
}
output.put("TemplateId", templateId);
//構建水印輸出配置
JSONArray waterMarks = new JSONArray(); //水印數組大小上限為4,即同一路輸出最多支持4個水印
//文字水印
JSONObject textWaterMarks = new JSONObject();
textWaterMarks.put("Type","Text");
//Content為文字水印內容(示例中的Content原文為:測試文字水印),內容需經過Base64編碼
textWaterMarks.put("TextWaterMark","{\"Content\":\"5rWL6K+V5paH5a2X5rC05Y2w\",\"FontName\":\"SimSun\",\"FontSize\":\"16\",\"Top\":2,\"Left\":10}");
waterMarks.add(textWaterMarks);
output.put("WaterMarks", waterMarks);
outputs.add(output);
request.setInput(input.toJSONString());
request.setOutputs(outputs.toJSONString());
//指定輸出bucket
request.setOutputBucket("<your bucket name>");
//輸出bucket的所在區域,格式: oss-cn-****, 例如北京 oss-cn-beijing
request.setOutputLocation("oss-cn-beijing");
// 指定管道ID
request.setPipelineId(pipelineId);
return client.getAcsResponse(request);
}
圖片水印
/**
* 提交圖片水印轉碼作業
* @param client
* @return
* @throws Exception
*/
public static SubmitJobsResponse submitImageWaterMarkJobs(DefaultAcsClient client) throws Exception {
SubmitJobsRequest request = new SubmitJobsRequest();
//構建輸出參數
JSONArray outputs = new JSONArray();
//構建input, 需要保證Location區域和服務client區域一致
JSONObject input = new JSONObject();
input.put("Location", "oss-cn-beijing");
input.put("Bucket", "<your bucket name>");
//構建一個輸出對象
JSONObject output = new JSONObject();
try {
input.put("Object", URLEncoder.encode("mps-test/demo/test.mp4", "utf-8"));
String outPutObject = URLEncoder.encode("mps-test/demo/test-out-watermark.mp4", "utf-8");
output.put("OutputObject", outPutObject);
} catch (UnsupportedEncodingException e) {
throw new RuntimeException("input URL encode failed");
}
output.put("TemplateId", templateId);
//構建水印輸出配置
JSONArray waterMarks = new JSONArray(); //水印數組大小上限為4,即同一路輸出最多支持4個水印
//圖片水印
JSONObject imageWaterMarks = new JSONObject();
imageWaterMarks.put("WaterMarkTemplateId",waterMarkTemplateId);
imageWaterMarks.put("Type","Image");
imageWaterMarks.put("Width","200");
imageWaterMarks.put("Height","100");
//水印圖片路徑
JSONObject logoFile = new JSONObject();
logoFile.put("Bucket","<your bucket name>");
logoFile.put("Location","oss-cn-beijing");
logoFile.put("Object", URLEncoder.encode("logo.png", "utf-8"));
imageWaterMarks.put("InputFile",logoFile.toJSONString());
waterMarks.add(imageWaterMarks);
output.put("WaterMarks", waterMarks);
outputs.add(output);
request.setInput(input.toJSONString());
request.setOutputs(outputs.toJSONString());
//指定輸出bucket
request.setOutputBucket("<your bucket name>");
//輸出bucket的所在區域,格式: oss-cn-****, 例如北京 oss-cn-beijing
request.setOutputLocation("oss-cn-beijing");
// 指定管道ID
request.setPipelineId(pipelineId);
return client.getAcsResponse(request);
}
完整代碼
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONArray;
import com.alibaba.fastjson.JSONObject;
import com.aliyun.mps.utils.InitClient;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.mts.model.v20140618.*;
import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;
/**
* ***** 使用須知 ******
* 本demo為基本的水印轉碼任務處理示例
*
* ***** 方法介紹 ******
* addWaterMarkTemplate 添加水印模板 http://m.bestwisewords.com/document_detail/602851.html
* submitTextWaterMarkJobs 提交文字水印轉碼作業 http://m.bestwisewords.com/document_detail/602834.html
* submitImageWaterMarkJobs 提交圖片水印轉碼作業 http://m.bestwisewords.com/document_detail/602834.html
*
* 具體參數詳情參考 http://m.bestwisewords.com/document_detail/29253.htm#section-qdu-5fe-ftz
*/
public class WaterMark {
//管道ID, 可以在MPS控制臺 > 全局設置 > 管道及回調查看
private static String pipelineId = "bee7a5bfe40a0cbf4a526f****";
//轉碼模板ID, 預置模板參考 http://m.bestwisewords.com/document_detail/29256.html
private static String templateId = "S00000001-200010";
//水印模板ID, 可以在MPS控制臺 > 模板管理 > 水印模板查看
private static String waterMarkTemplateId = "bee7a4a526fa0cbf****";
public static void main(String[] args) throws ClientException {
//初始化調用 client
DefaultAcsClient client = InitClient.initMpsClient();
AddWaterMarkTemplateResponse response;
try {
response = addWaterMarkTemplate(client);
System.out.println("RequestId is:" + response.getRequestId());
System.out.println("WaterMarkTemplateId is:" + JSON.toJSON(response.getWaterMarkTemplate().getId()));
} catch (Exception e) {
e.printStackTrace();
}
// SubmitJobsResponse response;
// try {
// //文字水印
// //response = submitTextWaterMarkJobs(client);
// //圖片水印
// response = submitImageWaterMarkJobs(client);
// System.out.println("RequestId is:"+response.getRequestId());
// //多個output請遍歷getJobResultList()獲取結果
// if (response.getJobResultList().get(0).getSuccess()) {
// System.out.println("JobId is:" + response.getJobResultList().get(0).getJob().getJobId());
// System.out.println("Response is:" + JSON.toJSONString(response));
// } else {
// System.out.println("SubmitJobs Failed code:" + response.getJobResultList().get(0).getCode() +
// " message:" + response.getJobResultList().get(0).getMessage());
// }
// } catch (Exception e) {
// e.printStackTrace();
// }
}
/**
* 創建水印模板
* @param client
* @return
* @throws Exception
*/
public static AddWaterMarkTemplateResponse addWaterMarkTemplate(DefaultAcsClient client) throws Exception {
AddWaterMarkTemplateRequest request = new AddWaterMarkTemplateRequest();
request.setName("test name");
//水印參數詳情, 參考 http://m.bestwisewords.com/document_detail/29253.htm#section-k53-tt4-8b0
JSONObject waterMarkConfig = new JSONObject();
waterMarkConfig.put("Dx","10");
waterMarkConfig.put("Dy","5");
waterMarkConfig.put("ReferPos","TopRight");
request.setConfig(waterMarkConfig.toJSONString());
return client.getAcsResponse(request);
}
/**
* 提交文字水印轉碼作業
* @param client
* @return
* @throws Exception
*/
public static SubmitJobsResponse submitTextWaterMarkJobs(DefaultAcsClient client) throws Exception {
SubmitJobsRequest request = new SubmitJobsRequest();
//構建輸出參數
JSONArray outputs = new JSONArray();
//構建input, 需要保證Location區域和服務client區域一致
JSONObject input = new JSONObject();
input.put("Location", "oss-cn-beijing");
input.put("Bucket", "<your bucket name>");
//構建一個輸出對象
JSONObject output = new JSONObject();
try {
input.put("Object", URLEncoder.encode("mps-test/demo/test.mp4", "utf-8"));
String outPutObject = URLEncoder.encode("mps-test/demo/test-out-watermark.mp4", "utf-8");
output.put("OutputObject", outPutObject);
} catch (UnsupportedEncodingException e) {
throw new RuntimeException("input URL encode failed");
}
output.put("TemplateId", templateId);
//構建水印輸出配置
JSONArray waterMarks = new JSONArray(); //水印數組大小上限為4,即同一路輸出最多支持4個水印
//文字水印
JSONObject textWaterMarks = new JSONObject();
textWaterMarks.put("Type","Text");
//Content為文字水印內容,內容需做Base64編碼
textWaterMarks.put("TextWaterMark","{\"Content\":\"5rWL6K+V5paH5a2X5rC05Y2w\",\"FontName\":\"SimSun\",\"FontSize\":\"16\",\"Top\":2,\"Left\":10}");
waterMarks.add(textWaterMarks);
output.put("WaterMarks", waterMarks);
outputs.add(output);
request.setInput(input.toJSONString());
request.setOutputs(outputs.toJSONString());
//指定輸出bucket
request.setOutputBucket("<your bucket name>");
//輸出bucket的所在區域,格式: oss-cn-****, 例如北京 oss-cn-beijing
request.setOutputLocation("oss-cn-beijing");
// 指定管道ID
request.setPipelineId(pipelineId);
return client.getAcsResponse(request);
}
/**
* 提交圖片水印轉碼作業
* @param client
* @return
* @throws Exception
*/
public static SubmitJobsResponse submitImageWaterMarkJobs(DefaultAcsClient client) throws Exception {
SubmitJobsRequest request = new SubmitJobsRequest();
//構建輸出參數
JSONArray outputs = new JSONArray();
//構建input, 需要保證Location區域和服務client區域一致
JSONObject input = new JSONObject();
input.put("Location", "oss-cn-beijing");
input.put("Bucket", "<your bucket name>");
//構建一個輸出對象
JSONObject output = new JSONObject();
try {
input.put("Object", URLEncoder.encode("mps-test/demo/test.mp4", "utf-8"));
String outPutObject = URLEncoder.encode("mps-test/demo/test-out-watermark.mp4", "utf-8");
output.put("OutputObject", outPutObject);
} catch (UnsupportedEncodingException e) {
throw new RuntimeException("input URL encode failed");
}
output.put("TemplateId", templateId);
//構建水印輸出配置
JSONArray waterMarks = new JSONArray(); //水印數組大小上限為4,即同一路輸出最多支持4個水印
//圖片水印
JSONObject imageWaterMarks = new JSONObject();
imageWaterMarks.put("WaterMarkTemplateId",waterMarkTemplateId);
imageWaterMarks.put("Type","Image");
imageWaterMarks.put("Width","200");
imageWaterMarks.put("Height","100");
//水印圖片路徑
JSONObject logoFile = new JSONObject();
logoFile.put("Bucket","<your bucket name>");
logoFile.put("Location","oss-cn-beijing");
logoFile.put("Object", URLEncoder.encode("logo.png", "utf-8"));
imageWaterMarks.put("InputFile",logoFile.toJSONString());
waterMarks.add(imageWaterMarks);
output.put("WaterMarks", waterMarks);
outputs.add(output);
request.setInput(input.toJSONString());
request.setOutputs(outputs.toJSONString());
//指定輸出bucket
request.setOutputBucket("<your bucket name>");
//輸出bucket的所在區域,格式: oss-cn-****, 例如北京 oss-cn-beijing
request.setOutputLocation("oss-cn-beijing");
// 指定管道ID
request.setPipelineId(pipelineId);
return client.getAcsResponse(request);
}
}
相關文檔
文檔內容是否對您有幫助?