.NET SDK

前提条件

• 已创建并获取AccessKey。具体操作，请参见创建AccessKey。

• 已开通OSS服务、创建存储空间并上传文件到存储空间。具体操作，请参见控制台上传文件。

• 已开通智能媒体管理服务。具体操作，请参见开通产品。

• 已通过智能媒体管理控制台创建项目。具体操作，请参见创建项目。

  说明

  • 您也可以调用API接口创建项目。具体操作，请参见CreateProject - 创建项目。

  • 您可以调用ListProjects - 列出所有项目信息的列表接口列出指定地域下已创建的所有项目信息。

安装SDK

访问凭证

您可以选择以下类型的访问凭证。

• 临时访问凭证：对于需要高安全性的场景，例如临时授权应用访问IMM，建议使用临时访问凭证。临时访问凭证可以限制访问的有效期，从而减少访问凭证泄露的风险。此外，临时访问凭证支持权限控制，可以有效地避免权限过大的问题。

• 长期访问凭证：出于安全性考虑，不建议您使用长期访问凭证，建议您使用临时访问凭证。对于需要便利性的场景，长期访问凭证可以在较长时间内免除多次刷新的麻烦。建议每三个月更换一次长期访问凭证，以提高账号的安全性。当长期访问凭证泄露或者不再使用时，应该及时删除或者禁用相关的访问凭证，以免造成安全风险。

使用临时访问凭证

当您准备临时使用.NET SDK访问IMM服务时，可以参考配置临时访问凭证。

使用长期访问凭证

如下以在华东1（杭州）地域中检测图片中的人脸及人脸信息为例，介绍如何使用临时访问凭证通过智能媒体管理.NET SDK调用对应API。

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

   // This file is auto-generated, don't edit it. Thanks.
   
   using System;
   using System.Collections;
   using System.Collections.Generic;
   using System.IO;
   using System.Threading.Tasks;
   using Newtonsoft.Json;
   using Tea;
   using Tea.Utils;
   
   
   namespace AlibabaCloud.SDK.Sample
   {
       public class Sample 
       {
   
           /**
            * 使用AK&SK初始化账号Client
            * @return Client
            * @throws Exception
            */
           public static AlibabaCloud.SDK.Imm20200930.Client CreateClient()
           {
               // 工程代码泄露可能会导致 AccessKey 泄露，并威胁账号下所有资源的安全性。以下代码示例仅供参考。
               // 建议使用更安全的 STS 方式，更多鉴权访问方式请参见：https://help.aliyun.com/document_detail/378671.html。
               AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config
               {
                   // 必填，请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID。
                   AccessKeyId = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
                   // 必填，请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_SECRET。
                   AccessKeySecret = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),
               };
               // Endpoint 请参考 https://api.aliyun.com/product/imm
               config.Endpoint = "imm.cn-beijing.aliyuncs.com";
               return new AlibabaCloud.SDK.Imm20200930.Client(config);
           }
   
           public static void Main(string[] args)
           {
               AlibabaCloud.SDK.Imm20200930.Client client = CreateClient();
               AlibabaCloud.SDK.Imm20200930.Models.DetectImageFacesRequest detectImageFacesRequest = new AlibabaCloud.SDK.Imm20200930.Models.DetectImageFacesRequest
               {
                   ProjectName = "test",
                   SourceURI = "oss://your-bucket-name/your-path/your-image.jpg",
               };
               AlibabaCloud.TeaUtil.Models.RuntimeOptions runtime = new AlibabaCloud.TeaUtil.Models.RuntimeOptions();
               try
               {
                   // 复制代码运行请自行打印 API 的返回值
                  Console.WriteLine(JsonConvert.SerializeObject(client.DetectImageFacesWithOptions(detectImageFacesRequest, runtime).Body));
               }
               catch (TeaException error)
               {
                   // 此处仅做打印展示，请谨慎对待异常处理，在工程项目中切勿直接忽略异常。
                   // 错误 message
                   Console.WriteLine(error.Message);
                   // 诊断地址
                   Console.WriteLine(error.Data["Recommend"]);
                   AlibabaCloud.TeaUtil.Common.AssertAsString(error.Message);
               }
               catch (Exception _error)
               {
                   TeaException error = new TeaException(new Dictionary<string, object>
                   {
                       { "message", _error.Message }
                   });
                   // 此处仅做打印展示，请谨慎对待异常处理，在工程项目中切勿直接忽略异常。
                   // 错误 message
                   Console.WriteLine(error.Message);
                   // 诊断地址
                   Console.WriteLine(error.Data["Recommend"]);
                   AlibabaCloud.TeaUtil.Common.AssertAsString(error.Message);
               }
           }
   
   
       }
   }

2. 执行csc /out:D:\Program.cs D:\Program.exe编译，运行Program.exe输出结果如下。

   {
     "RequestId": "2CCA6D7E-C9FB-5C87-8AC5-D6E6AC493096",
     "Faces": [
       {
         "Beard": "none",
         "MaskConfidence": 0.83,
         "Gender": "female",
         "Boundary": {
           "Left": 81,
           "Top": 62,
           "Height": 127,
           "Width": 96
         },
         "BeardConfidence": 1,
         "FigureId": "0fccc5f9-22df-4507-ac53-f6a37f11a15a",
         "Mouth": "open",
         "Emotion": "happiness",
         "Age": 25,
         "MouthConfidence": 0.998,
         "FigureType": "face",
         "GenderConfidence": 1,
         "HeadPose": {
           "Pitch": -27.196,
           "Roll": 6.075,
           "Yaw": 3.477
         },
         "Mask": "none",
         "EmotionConfidence": 0.999,
         "HatConfidence": 1,
         "GlassesConfidence": 1,
         "Sharpness": 1,
         "FigureClusterId": "figure-cluster-id-unavailable",
         "FaceQuality": 0.998,
         "Attractive": 0.998,
         "AgeSD": 7,
         "Glasses": "none",
         "FigureConfidence": 0.999,
         "Hat": "none"
       }
     ]
   }