Java SDK_SDK参考_智能媒体管理_阿里云技术文档

下载地址

IMM Service 的 Java SDK 让 Java 开发人员可以非常方便地使用 Java 程序操作服务。开发者可以直接使用 Maven 依赖添加 SDK。目前，SDK 支持 J2SE 6.0 及以上版本，已经开源到 github。

操作步骤

为快速开始使用 IMM Service Java SDK，请按照如下步骤进行。

步骤 1 创建阿里云账号

具体方法请参考阿里云账号注册流程。

为了更好地使用阿里云服务，建议尽快完成实名认证，否则部分阿里云服务将无法使用。具体实名认证流程，请参考这里。

步骤 2 获取阿里云访问密钥

为了使用 IMM Service Java SDK，您必须申请阿里云的访问密钥。

登录阿里云密钥管理页面。选择一对用于 SDK 的访问密钥对。如果没有，请创建一对新访问密钥，且保证它处于启用状态。有关如何创建访问密钥，参见创建访问密钥。

该密钥对会在下面的步骤使用，且需要保管好，不能对外泄露。另外，您可以参考 SDK 配置了解更多 SDK 如何使用访问密钥的信息。

步骤 3 创建项目

在使用 IMM 服务 Java SDK 之前，请先在控制台上创建好项目（Project）。有关如何创建 Project ，参见创建项目。

步骤 4 安装 Java 开发环境

目前，IMM Java SDK 支持 J2SE 6.0 及以上的 Java 运行环境，您可以从 Java 官方网站下载并按说明安装 Java 开发环境。

步骤 5 安装 Imm Service Java SDK

安装完 Java 开发环境后，您需要安装 IMM Service Java SDK，将下面的依赖加入 pom.xml 。

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>4.1.2</version>
</dependency>
<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.8.5</version>
</dependency>
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-imm</artifactId>
    <version>1.14.0</version>
</dependency>

注意：请关注 github 提供的最新版本，查看相关功能并选择使用。

步骤 6 开始一个新的 Java 项目

import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.imm.model.v20170906.*;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
public class Demo {
    // 初始化 IMM 客户端
    static IAcsClient client = new DefaultAcsClient(DefaultProfile.getProfile("cn-shanghai", "your_access_key_id","your_access_key_secret"));
    // 项目名称，请确保该项目已经创建
    static String projectName = "myproject1";
    public static void main(String[] args) throws ClientException {
        // 调用文档转换请求
        docConvertDemo();
    }
    public static void docConvertDemo() throws ClientException{
        // 创建文档转换异步请求任务
        CreateOfficeConversionTaskRequest req = new CreateOfficeConversionTaskRequest();
        req.setProject(projectName);
        // 设置待转换对文件OSS路径
        req.setSrcUri("oss://preview-office-bucket/docs/input/demo.pptx");
        // 设置文件输出格式为 vector
        req.setTgtType("vector");
        // 设置转换后的输出路径
        req.setTgtUri("oss://preview-office-bucket/docs/output/demo_pptx");
        CreateOfficeConversionTaskResponse res = client.getAcsResponse(req);
        String taskId = res.getTaskId();
        // 获取文档转换任务结果，最多轮询 30 次
        // 每次轮询的间隔为 1 秒
        GetOfficeConversionTaskRequest getOfficeConversionTaskRequest = new GetOfficeConversionTaskRequest();
        getOfficeConversionTaskRequest.setProject(projectName);
        getOfficeConversionTaskRequest.setTaskId(taskId);
        int maxCount = 30;
        int count = 0;
        try {
            while (true) {
                Thread.sleep(1000); // 1 秒
                GetOfficeConversionTaskResponse getOfficeConversionTaskResponse = client.getAcsResponse(getOfficeConversionTaskRequest);
                if (!getOfficeConversionTaskResponse.getStatus().equals("Running")) {
                    // 输出文档转换任务执行结果
                    System.out.println(getOfficeConversionTaskResponse.getTaskId());
                    System.out.println(getOfficeConversionTaskResponse.getFailDetail().getCode());
                    System.out.println("Done");
                    break;
                }
                count = count + 1;
                if(count >= maxCount) {
                    System.out.println("OfficeConversion Timeout for 30 seconds");
                    break;
                }
                System.out.println("Task is still running.");
            }
        } catch (InterruptedException e){
            e.printStackTrace();
        }
    }
}

若在使用中有疑问，请参考 FAQ，或者进入钉钉用户群实时交流。

Java SDK_SDK参考_智能媒体管理

Java SDK