本篇文档提供了Java SDK媒体处理模块相关功能的API调用示例,包含提交转码作业、提交截图作业、查询截图数据、导播台视频预处理。
初始化客户端
使用前请先初始化客户端,请参见初始化。
提交转码作业
调用SubmitTranscodeJobs接口,完成提交转码作业功能。
接口参数和返回字段请参见SubmitTranscodeJobs。调用示例如下:
import com.aliyuncs.vod.model.v20170321.SubmitTranscodeJobsRequest;
import com.aliyuncs.vod.model.v20170321.SubmitTranscodeJobsResponse;
/**
* 提交媒体处理作业
*/
public static SubmitTranscodeJobsResponse submitTranscodeJobs(DefaultAcsClient client) throws Exception {
SubmitTranscodeJobsRequest request = new SubmitTranscodeJobsRequest();
//需要转码的视频ID
request.setVideoId("34a6ca54f5c140eece85a289****");
//转码模板ID
request.setTemplateGroupId("e8aa925a9798c630d30cd****");
//构建需要替换的水印参数(只有需要替换水印相关信息才需要构建)
JSONObject overrideParams = buildOverrideParams();
//覆盖参数,暂只支持水印部分参数替换(只有需要替换水印相关信息才需要传递)
request.setOverrideParams(overrideParams.toJSONString());
//构建标准加密配置参数(只有标准加密才需要构建)
JSONObject encryptConfig = buildEncryptConfig(client);
//HLS标准加密配置(只有标准加密才需要传递)
request.setEncryptConfig(encryptConfig.toJSONString());
return client.getAcsResponse(request);
}
/**
* 以下为调用示例
*/
public static void main(String[] args) throws ClientException {
DefaultAcsClient client = initVodClient("<Your AccessKeyId>", "<Your AccessKeySecret>");
SubmitTranscodeJobsResponse response = new SubmitTranscodeJobsResponse();
try {
response = submitTranscodeJobs(client);
//任务ID
System.out.println("JobId = " + response.getTranscodeJobs().get(0).getJobId());
} catch (Exception e) {
System.out.println("ErrorMessage = " + e.getLocalizedMessage());
}
System.out.println("RequestId = " + response.getRequestId());
}
/**
* 构建HLS标准加密的配置信息
* @return
* @throws ClientException
*/
public static JSONObject buildEncryptConfig(DefaultAcsClient client) throws ClientException {
//点播给用户在KMS(秘钥管理服务)中的Service Key,可在用户秘钥管理服务对应的区域看到描述为vod的service key
String serviceKey = "<您的Service Key>";
//随机生成一个加密的秘钥,返回的response包含明文秘钥以及密文秘钥,
//视频标准加密只需要传递密文秘钥即可
//注意:KMS Client建议单独初始化来保证正确的接入区域,可参考VOD初始化方式,传入正确的KMS服务区域。
GenerateDataKeyResponse response = generateDataKey(client, serviceKey);
JSONObject encryptConfig = new JSONObject();
//解密接口地址,该参数需要将每次生成的密文秘钥与接口URL拼接生成,表示每个视频的解密的密文秘钥都不一样
//至于Ciphertext这个解密接口参数的名称,用户可自行制定,这里只作为参考参数名称
encryptConfig.put("DecryptKeyUri", "http://decrypt.demo.com/decrypt?" +
"Ciphertext=" + response.getCiphertextBlob());
//秘钥服务的类型,目前只支持KMS
encryptConfig.put("KeyServiceType", "KMS");
//密文秘钥
encryptConfig.put("CipherText", response.getCiphertextBlob());
return encryptConfig;
}
/**
* 1、构建覆盖参数,目前只支持图片水印文件地址、文字水印的内容覆盖;
* 2、需要替换的水印信息对应水印ID必须是关联在指定的模板ID(即TranscodeTemplateId)中;
* 3、不支持通过媒体处理接口去增加一个没有关联上的水印
* 注意:图片水印的文件存储源站需要和发起转码的视频存储源站一致
* @return
*/
public static JSONObject buildOverrideParams() {
JSONObject overrideParams = new JSONObject();
JSONArray watermarks = new JSONArray();
//图片水印文件地址替换
JSONObject watermark1 = new JSONObject();
//模板上面关联需要替换的水印文件图片水印ID
watermark1.put("WatermarkId", "2ea587477c5a1bc8b57****");
//需要替换成对应图片水印文件的OSS地址,水印文件存储源站需要和视频存储源站一致
watermark1.put("FileUrl", "https:192.168.0.0/16);
//文字水印内容替换
JSONObject watermark2 = new JSONObject();
//模板上面关联需要替换内容的文字水印ID
watermark2.put("WatermarkId", "d297ba31ac5242d207****");
//需要替换成对应的内容
watermark2.put("Content", "用户ID:6****");
watermarks.add(watermark2);
overrideParams.put("Watermarks", watermarks);
return overrideParams;
}
/**
* 生成加密需要的秘钥,response中包含密文秘钥和明文秘钥,用户只需要将密文秘钥传递给点播即可
* 注意:KeySpec 必须传递AES_128,且不能设置NumberOfBytes
* @param client KMS-SDK客户端
* @param serviceKey 点播提供生成秘钥的service key,在用户的秘钥管理服务中可看到描述为vod的加密key
* @return
* @throws ClientException
*/
public static GenerateDataKeyResponse generateDataKey(DefaultAcsClient client, String serviceKey) throws ClientException {
GenerateDataKeyRequest request = new GenerateDataKeyRequest();
request.setKeyId(serviceKey);
request.setKeySpec("AES_128");
return client.getAcsResponse(request);
}
提交截图作业
调用SubmitSnapshotJob接口,完成提交截图作业功能。
接口参数和返回字段请参见SubmitSnapshotJob。调用示例如下:
说明 创建截图模板详细请参见截图模板。
import com.aliyuncs.vod.model.v20170321.SubmitSnapshotJobRequest;
import com.aliyuncs.vod.model.v20170321.SubmitSnapshotJobResponse;
/**
* 提交媒体截图处理作业调用函数
*/
public static SubmitSnapshotJobResponse submitSnapshotJob(DefaultAcsClient client) throws Exception {
SubmitSnapshotJobRequest request = new SubmitSnapshotJobRequest();
//需要截图的视频ID(推荐传递截图模板ID)
request.setVideoId("4d237a8270084849bf4207876181****");
//截图模板ID
request.setSnapshotTemplateId("5d745e6b8baadf589e0702426cfc6****");
//如果设置了SnapshotTemplateId,会忽略下面参数
request.setCount(50L);
request.setSpecifiedOffsetTime(0L);
request.setInterval(1L);
request.setWidth("200");
request.setHeight("200");
JSONObject spriteSnapshotConfig = buildSnapshotTemplateConfig();
request.setSpriteSnapshotConfig(spriteSnapshotConfig.toJSONString());
return client.getAcsResponse(request);
}
/**
* 构建雪碧图截图配置
* @return
*/
public static JSONObject buildSnapshotTemplateConfig() {
JSONObject spriteSnapshotConfig = new JSONObject();
spriteSnapshotConfig.put("CellWidth", "120");
spriteSnapshotConfig.put("CellHeight", "68");
spriteSnapshotConfig.put("Columns", "3");
spriteSnapshotConfig.put("Lines", "10");
spriteSnapshotConfig.put("Padding", "20");
spriteSnapshotConfig.put("Margin", "50");
//保留雪碧图原始图
spriteSnapshotConfig.put("KeepCellPic", "keep");
spriteSnapshotConfig.put("Color", "tomato");
return spriteSnapshotConfig;
}
/**
* 以下为调用示例
*/
public static void main(String[] args) throws ClientException {
DefaultAcsClient client = initVodClient("<Your AccessKeyId>", "<Your AccessKeySecret>");
SubmitSnapshotJobResponse response = new SubmitSnapshotJobResponse();
try {
response = submitSnapshotJob(client);
//任务ID
System.out.println("JobId = " + response.getSnapshotJob().getJobId());
} catch (Exception e) {
System.out.println("ErrorMessage = " + e.getLocalizedMessage());
}
System.out.println("RequestId = " + response.getRequestId());
}
查询截图数据
调用ListSnapshots接口,完成查询截图数据功能。
接口参数和返回字段请参见ListSnapshots。调用示例如下:
import com.aliyuncs.vod.model.v20170321.ListSnapshotsRequest;
import com.aliyuncs.vod.model.v20170321.ListSnapshotsResponse;
/**
* 查询截图数据
*/
public static ListSnapshotsResponse listSnapshots(DefaultAcsClient client) throws Exception {
ListSnapshotsRequest request = new ListSnapshotsRequest();
//视频ID
request.setVideoId("c86c0ceba9796535****");
//截图类型
request.setSnapshotType("CoverSnapshot");
request.setPageNo("1");
request.setPageSize("20");
return client.getAcsResponse(request);
}
/**
* 以下为调用示例
*/
public static void main(String[] args) throws ClientException {
DefaultAcsClient client = initVodClient("<Your AccessKeyId>", "<Your AccessKeySecret>");
ListSnapshotsResponse response = new ListSnapshotsResponse();
try {
response = listSnapshots(client);
//截图地址
System.out.println("Url = " + response.getMediaSnapshot().getSnapshots().get(0).getUrl());
} catch (Exception e) {
System.out.println("ErrorMessage = " + e.getLocalizedMessage());
}
System.out.println("RequestId = " + response.getRequestId());
}
导播台视频预处理
调用SubmitPreprocessJobs接口,完成导播台视频预处理功能。
接口参数和返回字段请参见SubmitPreprocessJobs。调用示例如下:
import com.aliyuncs.vod.model.v20170321.SubmitPreprocessJobsRequest;
import com.aliyuncs.vod.model.v20170321.SubmitPreprocessJobsResponse;
/**
* 导播台视频预处理
*/
public static SubmitPreprocessJobsResponse submitPreprocessJobs(DefaultAcsClient client) throws Exception {
SubmitPreprocessJobsRequest request = new SubmitPreprocessJobsRequest();
//视频ID
request.setVideoId("c86c0ceb8db54ae09796535****");
request.setPreprocessType("PreprocessType");
return client.getAcsResponse(request);
}
/**
* 以下为调用示例
*/
public static void main(String[] args) throws ClientException {
DefaultAcsClient client = initVodClient("<Your AccessKeyId>", "<Your AccessKeySecret>");
SubmitPreprocessJobsResponse response = new SubmitPreprocessJobsResponse();
try {
response = submitPreprocessJobs(client);
//任务ID
System.out.println("JobId = " + response.getPreprocessJobs().get(0).getJobId());
} catch (Exception e) {
System.out.println("ErrorMessage = " + e.getLocalizedMessage());
}
System.out.println("RequestId = " + response.getRequestId());
}
在文档使用中是否遇到以下问题
更多建议
匿名提交