本示例介绍如何使用Alibaba Cloud SDK for Java调用SubmitSnapshotJob接口创建一个提交截图作业。

提交截图作业接口,目前支持生成JPG格式图片,提供如下三种消息模式:
  • 同步模式:接口同步返回截图结果,截图在接口返回时就已经生成到对应的Bucket。
  • 异步模式:不保证接口返回时截图已经生成,截图任务将进入后台排队,异步执行截图。只要设置了IntervalNum中的任何一个参数,就代表使用异步模式。
  • 消息通知:提交截图作业时,只要指定了PipelineId参数,完成后将发送异步消息。

前提条件

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-mts</artifactId>
    <version>2.7.2</version>
</dependency>

示例代码

package com.ygx.program;

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.mts.model.v20140618.SubmitSnapshotJobRequest;
import com.aliyuncs.mts.model.v20140618.SubmitSnapshotJobResponse;
import com.aliyuncs.profile.DefaultProfile;
import com.google.gson.Gson;

public class TestSubmitSnapshotJob {

    /**
     * 提交截图作业
     * SubmitSnapshotJob
     * @param args
     */
    public static void main(String[] args) {
        DefaultProfile profile = DefaultProfile.getProfile(
                "<your-region-id>",            // 地域ID
                "<your-access-key-id>",        // 您的AccessKey ID
                "<your-access-key-secret>" );    // 您的AccessKey Secret
        // 创建API请求并设置参数
        IAcsClient client = new DefaultAcsClient(profile);
        SubmitSnapshotJobRequest request = new SubmitSnapshotJobRequest();
        // 作业输入。JSON对象,Input定义详见术语表。  需在控制台中授予此Bucket权限给媒体转码服务。
        String inputStr = "{\"Bucket\" : \"example-bucket\","
                            + "\"Location\" : \"oss-cn-hangzhou\","
                            + "\"Object\" : \"example.flv\" }";
        request.setInput(inputStr);
        // 截图配置。Json对象,
        /*
         * 同步模式:
         *         {"OutputFile": {"Bucket": "example-001","Location":"oss-cn-hangzhou","Object": "example.jpg"},"Time": "5"}
         * 异步模式(5毫秒开始,每间隔20秒截一张,共截10张):
         *         {"OutputFile": {"Bucket": "example-001","Location": "oss-cn-hangzhou","Object": "{Count}.jpg"},"Time":"5","Num":"10","Interval":"20"}
         */
        String SnapshotConfigStr = "{\"OutputFile\": "
                                            + "{\"Bucket\" : \"example-001\","
                                            + "\"Location\" : \"oss-cn-hangzhou\","
                                            + "\"Object\": \"example.jpg\"},"
                                    + "\"Time\" : \"5\"}";
        request.setSnapshotConfig(SnapshotConfigStr);
        // 管道ID。  须保证此管道绑定了可用的消息主题,否则消息无法正确发送。
        //String PipelineIdStr = "";
        //request.setPipelineId(PipelineIdStr);
        // 用户自定义数据。最大长度1024个字节。
        //String UserDataStr = "";
        //request.setUserData(UserDataStr);

        try {
            SubmitSnapshotJobResponse response = client.getAcsResponse(request);
            // 处理返回值数据
            System.out.println(new Gson().toJson(response));
        } catch (ServerException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (ClientException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
    }
}
				
说明 更多媒体处理服务接口内容,请参见API概述