如何安装和使用智能媒体管理JavaSDK_智能媒体管理-阿里云帮助中心

阿里云API调试工具OpenAPI Explore提供OpenAPI文档、API调试和SDK示例，帮助您快速入门API开发。本文介绍如何安装和快速使用智能媒体管理Java SDK。

前提条件

已下载并安装J2SE 6.0及以上版本的Java开发环境。
已创建并获取AccessKey。具体操作，请参见创建AccessKey。
已开通OSS服务、创建存储空间并上传文件到存储空间。具体操作，请参见上传文件。
已开通智能媒体管理服务。具体操作，请参见开通产品。
已调用CreateProject - 创建项目接口创建项目。
说明
- 您也可以通过智能媒体管理控制台创建项目。具体操作，请参见创建项目。
- 您可以调用ListProjects - 列出所有项目信息的列表接口列出指定地域下已创建的所有项目信息。

安装SDK

重要

调用2020-09-30版本的API，需要使用2020-09-30版本的SDK。

使用智能媒体管理Java SDK的操作步骤如下：

安装智能媒体管理Java SDK。
您可以直接使用Maven依赖添加智能媒体管理Java SDK，只需在pom.xml中加入相应依赖即可。以1.27.6版本为例，在<dependencies>中加入如下内容：
```
<dependency>    
    <groupId>com.aliyun</groupId>    
    <artifactId>imm20200930</artifactId>    
    <version>1.27.6</version>
</dependency>
```
开始一个Java项目。
使用Java SDK的主要步骤如下：
1. 创建Client实例。
  在创建Client实例时，您需要获取并配置Region ID、AccessKey ID和AccessKey Secret。
2. 创建API请求并设置参数。
3. 发起请求并处理应答或异常。

使用方法

如下以在华东1（杭州）地域中检测图片中的人脸及人脸信息为例介绍如何使用智能媒体管理Java SDK。

说明

复制使用如下示例代码时请将访问域名换成您的IMM项目所在Region的域名，并且IMM项目和OSS文件Region需要保持一致。

package com.alibaba.sample;
import com.aliyun.imm20200930.models.*;
import com.aliyun.teaopenapi.models.*;
public class Sample {
    // 填写项目名称。请确保已创建该项目。
    static String projectName = "imm-java-sdk-doc-demo";
    // 填写图片OSS URI。
    static String sourceURI = "oss://your-bucket-name/your-path/your-image.jpg";
    public static void main(String[] args_) throws Exception {
        Config config = new Config()
                .setRegionId("cn-hangzhou")                    // 填写项目所在地域ID。
                .setAccessKeyId("your_access_key_id")          // 填写RAM用户的AccessKey ID。
                .setAccessKeySecret("your_access_key_secret"); // 填写RAM用户的AccessKey Secret。
        // 初始化IMM客户端。
        com.aliyun.imm20200930.Client client = new com.aliyun.imm20200930.Client(config);
        // 构造检测图片中的人脸及人脸信息请求。
        DetectImageFacesRequest detectImageFacesRequest = new DetectImageFacesRequest();
        detectImageFacesRequest.setProjectName(Sample.projectName);
        detectImageFacesRequest.setSourceURI(Sample.sourceURI);
        // 发起请求。
        DetectImageFacesResponse detectImageFacesResponse = client.detectImageFaces(detectImageFacesRequest);
        // 打印响应结果Body信息。
        System.out.println(detectImageFacesResponse.body.toMap());
    }
}