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

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

前提条件

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

安装SDK

重要

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

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

安装智能媒体管理.NET SDK。
如下以使用NuGet依赖安装智能媒体管理.NET SDK为例。
1. 创建一个文件夹demo。
```
mkdir demo
```
2. 进入demo文件夹，生成一个console工程。
```
cd demo
dotnet new console
```
  生成的目录结构如下：
```
demo
 |--demo.csproj
 |--Program.cs
 |-- obj/
```
3. 将如下依赖加入工程下demo.csproj文件的<Project>元素中。
  
  重要
  调用2020-09-30版本的API，需要使用2020-09-30版本的SDK。
```
  <ItemGroup>
    <PackageReference Include="AlibabaCloud.OpenApiClient" Version="0.1.1" />
    <PackageReference Include="AlibabaCloud.SDK.Imm20200930" Version="1.27.6" />
  </ItemGroup>
```
开始一个C#项目。
使用.NET SDK的主要步骤如下：
1. 创建Client实例。
  在创建Client实例时，您需要获取并配置Region ID、AccessKey ID和AccessKey Secret。
2. 创建API请求并设置参数。
3. 发起请求并处理应答或异常。

使用方法

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

说明

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

using System;
using System.Collections;
using System.Collections.Generic;
using System.IO;
using System.Threading.Tasks;
using Tea;
using Tea.Utils;
namespace net_test
{
    public class Program
    {
        /**
         * 使用AccessKey ID和AccessKey Secret初始化账号Client。
         * @param accessKeyId
         * @param accessKeySecret
         * @return Client
         * @throws Exception
         */
        public static AlibabaCloud.SDK.Imm20200930.Client CreateClient(string accessKeyId, string accessKeySecret)
        {
            AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config
            {
                // 填写您的AccessKey ID。
                AccessKeyId = accessKeyId,
                // 填写您的AccessKey Secret。
                AccessKeySecret = accessKeySecret,
            };
            // 填写访问域名。
            config.Endpoint = "imm.cn-hangzhou.aliyuncs.com";
            return new AlibabaCloud.SDK.Imm20200930.Client(config);
        }
        public static void Main(string[] args)
        {
            AlibabaCloud.SDK.Imm20200930.Client client = CreateClient("your_access_key_id", "your_access_key_secret");
            AlibabaCloud.SDK.Imm20200930.Models.DetectImageFacesRequest detectImageFacesRequest = new AlibabaCloud.SDK.Imm20200930.Models.DetectImageFacesRequest
            {
                // 填写IMM项目名称。
                ProjectName = "test",
                // 填写图片的OSS URI。
                SourceURI = "oss://your-bucket-name/your-path/your-image.jpg",
            };
            AlibabaCloud.TeaUtil.Models.RuntimeOptions runtime = new AlibabaCloud.TeaUtil.Models.RuntimeOptions();
            try
            {
                // 复制代码运行请自行打印API的返回值。
                client.DetectImageFacesWithOptions(detectImageFacesRequest, runtime);
            }
            catch (TeaException error)
            {
                // 如有需要，请打印错误信息。
                AlibabaCloud.TeaUtil.Common.AssertAsString(error.Message);
            }
            catch (Exception _error)
            {
                TeaException error = new TeaException(new Dictionary<string, object>
                {
                    { "message", _error.Message }
                });
                // 如有需要，请打印错误信息。
                AlibabaCloud.TeaUtil.Common.AssertAsString(error.Message);
            }
        }
    }
}