.NET SDK

前提条件

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

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

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

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

  说明

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

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

安装SDK

使用方法

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

   说明

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

   // 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"
       }
     ]
   }