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

提交截图作业接口,目前支持生成JPG格式图片,提供如下三种消息模式:

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

前提条件

在使用本教程前,请确保已完成以下操作:

  • 使用Alibaba Cloud SDK for Java,您需要一个阿里云账号和访问密钥(AccessKey)。 请在阿里云控制台中的AccessKey管理页面上创建和查看您的AccessKey。
  • 确保您已经安装了Alibaba Cloud SDK for Java,准确的SDK版本号,请参见 阿里云开发工具包(SDK)
    <dependencies>     <!-- https://mvnrepository.com/artifact/com.aliyun/aliyun-java-sdk-core --&gt;     <dependency&gt;         <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>

示例代码

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" title="提交截图作业_媒体处理_调用示例_Java SDK"},"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();         }     } }