IoT Platform：.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);
            }
        }
    }
}