.NET SDK使用说明

调用步骤

1. 已完成SDK客户端初始化。具体内容，请参见初始化SDK。

2. 创建对应API的调用请求，生成${API名称}+"Request"类对象实例request。

3. 通过对象实例request，使用request.${请求参数的名称}方法，设置AIP所需的请求参数值。

4. 创建${API名称}+"Response"类的对象实例response承载响应结果：使用Client对象实例client的${API名称}(request)方法，获取API对应request的响应结果，包含服务端响应的body和headers。

5. 通过对象实例response的body成员对象，使用response.body.${返回参数的名称}方法，可获取对应返回参数的值。

   例如：response.body.RequestId用于获取阿里云为API请求生成的唯一标识符，其中RequestId为API的通用返回参数。通用返回参数还包含Success、ErrorMessage和Code。

6. 使用catch()方法处理异常报错。

物联网平台云端API，请参见API列表。有关request中请求参数说明，及response中返回参数说明，请参见对应API文档。

本文以调用Pub接口发布消息到Topic为例。请求参数信息，请参见Pub。

AlibabaCloud.SDK.Iot20180120.Models.PubRequest request = new AlibabaCloud.SDK.Iot20180120.Models.PubRequest
{
    // 物联网平台实例ID。
    IotInstanceId = "${iotInstanceId}",
    // 产品ProductKey。
    ProductKey = "${productKey}",
    // 要发送的消息主体，hello world Base64 String。
    MessageContent = Convert.ToBase64String(Encoding.Default.GetBytes("Hello World.")),
    // 要接收消息的设备的自定义Topic。
    TopicFullName = "/${productKey}/${deviceName}/user/get",
    // 指定消息的发送方式，支持QoS0和QoS1。
    Qos = 0,
};
//通过client对象获得对应request的响应对象response。
try
{
    AlibabaCloud.SDK.Iot20180120.Models.PubResponse response = client.Pub(request);
    Console.WriteLine("publish message result: " + response.Body.Success);
    Console.WriteLine(response.Body.Code);
    Console.WriteLine(response.Body.ErrorMessage);
}
catch (TeaException error)
{
    Console.WriteLine(error.Code);
    Console.WriteLine(error.Message);
}
catch (Exception _error)
{
    Console.WriteLine(_error.Message);
    Console.WriteLine(_error.StackTrace);
}

完整代码示例

using System;
using System.Collections;
using System.Collections.Generic;
using System.IO;
using System.Text;
using System.Threading.Tasks;

using Tea;
using Tea.Utils;

namespace AlibabaCloud.SDK.Sample
{
    public class Sample
    {
        /**
         * 使用AK&SK初始化Client。
         * @param accessKeyId 
         * @param accessKeySecret
         * @param regionId
         * @return Client
         * @throws Exception
         */
        public static AlibabaCloud.SDK.Iot20180120.Client CreateClient()
        {
            AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config();
            // 您的AccessKey ID。
            config.AccessKeyId = Environment.GetEnvironmentVariable("ACCESS_KEY_ID");
            // 您的AccessKey Secret。
            config.AccessKeySecret = Environment.GetEnvironmentVariable("ACCESS_KEY_SECRET");
            // 您的可用区ID。
            config.RegionId = "cn-shanghai";
            return new AlibabaCloud.SDK.Iot20180120.Client(config);
        }


        public static void Main(string[] args)
        {
            try
            {
                AlibabaCloud.SDK.Iot20180120.Client client = CreateClient("${accessKey}", "${accessKeySecret}");
                AlibabaCloud.SDK.Iot20180120.Models.PubRequest request = new AlibabaCloud.SDK.Iot20180120.Models.PubRequest
                {
                    // 物联网平台实例ID。
                    IotInstanceId = "${iotInstanceId}",
                    // 产品ProductKey。
                    ProductKey = "${productKey}",
                    // 要发送的消息主体，hello world Base64 String。
                    MessageContent = Convert.ToBase64String(Encoding.Default.GetBytes("Hello World.")),
                    // 要接收消息的设备的自定义Topic。
                    TopicFullName = "/${productKey}/${deviceName}/user/get",
                    // 指定消息的发送方式，支持QoS0和QoS1。
                    Qos = 0,
                };
                AlibabaCloud.SDK.Iot20180120.Models.PubResponse response = client.Pub(request);
                Console.WriteLine("publish message result: " + response.Body.Success);
                Console.WriteLine(response.Body.Code);
                Console.WriteLine(response.Body.ErrorMessage);
            }
            catch (TeaException error)
            {
                Console.WriteLine(error.Code);
                Console.WriteLine(error.Message);
            }
            catch (Exception _error)
            {
                Console.WriteLine(_error.Message);
                Console.WriteLine(_error.StackTrace);
            }
        }
    }
}