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

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

前提条件

在使用本教程前，请确保已完成以下操作：
  • 使用Alibaba Cloud SDK for Java，您需要一个阿里云账号和访问密钥（AccessKey）。 请在阿里云控制台中的AccessKey管理页面上创建和查看您的AccessKey。
  • 确保您已经安装了Alibaba Cloud SDK for Java，准确的SDK版本号，请参见 阿里云开发工具包（SDK）。 
    <project>
    <modelVersion>4.0.0</modelVersion>
    <groupId>java.demo</groupId>
    <artifactId>test</artifactId>
    <version>1.0-SNAPSHOT</version>
    <dependencies>
        <!-- https://mvnrepository.com/artifact/com.aliyun/aliyun-java-sdk-core -->
        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>aliyun-java-sdk-core</artifactId>
            <version>4.4.3</version>
        </dependency>
    <!-- https://mvnrepository.com/artifact/com.aliyun/aliyun-java-sdk-mts -->
        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>aliyun-java-sdk-mts</artifactId>
            <version>2.7.2</version>
        </dependency>
    </dependencies>
</project>

示例代码

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();
        }
    }
}