IoT Platform:.NET 用 IoT Platform SDK の使用

手順

1. SDK を初期化します。詳細については、このトピックの「SDK の初期化」セクションをご参照ください。

2. リクエスト インスタンスを ${API 操作名}+"Request" クラスで生成することで、API リクエストを作成します。

3. request インスタンスの request.${リクエスト パラメーター} メソッドを呼び出して、リクエスト パラメーターを指定します。

4. 応答${API 操作名}+"Response" クラスの ${API 操作名}(リクエスト)クライアント本文ヘッダー インスタンスを作成して、レスポンスを取得します。 インスタンスの メソッドを呼び出して、API リクエストに対するレスポンスを取得します。レスポンスには、サーバーから返された と が含まれます。

5. メソッドを呼び出して、レスポンスパラメーターの値を取得します。

   たとえば、response.body.RequestId メソッドを呼び出して、API リクエストに対して Alibaba Cloud によって生成された一意の識別子を取得できます。 RequestId は一般的なレスポンスパラメータです。一般的なレスポンスパラメータには、Success、ErrorMessage、および Code も含まれます。

6. catch() メソッドを呼び出して、例外を処理します。

IoT Platform の API 操作の詳細については、「関数別の操作リスト」をご参照ください。各 API 操作のリクエストパラメーターとレスポンスパラメーターの詳細については、API リファレンスをご参照ください。

次の例は、Pub 操作を呼び出して Topic にメッセージをパブリッシュする方法を示しています。リクエストパラメーターの詳細については、「Pub」をご参照ください。

AlibabaCloud.SDK.Iot20180120.Models.PubRequest request = new AlibabaCloud.SDK.Iot20180120.Models.PubRequest
{
    // IoT Platform インスタンスの ID。
    IotInstanceId = "${iotInstanceId}",
    // プロダクトの ProductKey。
    ProductKey = "${productKey}",
    // 送信するメッセージの内容。"hello world" を Base64 で文字列としてエンコードします。
    MessageContent = Convert.ToBase64String(Encoding.Default.GetBytes("Hello World.")),
    // メッセージをパブリッシュするために使用されるカスタム Topic。
    TopicFullName = "/${productKey}/${deviceName}/user/get",
    // メッセージ送信モード。IoT Platform SDK は QoS 0 と QoS 1 をサポートしています。
    Qos = 0,
};
// client インスタンスを使用してレスポンスを取得します。
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
    {
        /**
         * AccessKey ID と AccessKey シークレットを使用してクライアントを初期化します。
         * @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 シークレット。
            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
                {
                    // IoT Platform インスタンスの ID。
                    IotInstanceId = "${iotInstanceId}",
                    // プロダクトの ProductKey。
                    ProductKey = "${productKey}",
                    // 送信するメッセージの内容。"hello world" を Base64 で文字列としてエンコードします。
                    MessageContent = Convert.ToBase64String(Encoding.Default.GetBytes("Hello World.")),
                    // メッセージをパブリッシュするために使用されるカスタム Topic。
                    TopicFullName = "/${productKey}/${deviceName}/user/get",
                    // メッセージ送信モード。IoT Platform SDK は QoS 0 と QoS 1 をサポートしています。
                    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);
            }
        }
    }
}