All Products
Search

This Product

    IoT Platform:Gunakan IoT Platform SDK untuk .NET

    Document Center

    IoT Platform:Gunakan IoT Platform SDK untuk .NET

    Last Updated:Jul 06, 2025

    IoT Platform menyediakan SDK untuk pengembang .NET. Topik ini menjelaskan cara menginstal dan mengonfigurasi IoT Platform SDK untuk .NET serta cara menggunakan SDK untuk memanggil operasi API dari IoT Platform.

    Instal IoT Platform SDK untuk .NET

    1. Instal lingkungan pengembangan .NET.

      IoT Platform SDK untuk .NET mendukung lingkungan berikut:

      • .NET Framework 4.5 dan yang lebih baru

      • .NET Standard 2.0 dan yang lebih baru

      • C# 4.0 dan yang lebih baru

      • Visual Studio 2010 dan yang lebih baru

    2. Instal IoT Platform SDK untuk .NET menggunakan manajer paket NuGet.

      Contoh ini menggunakan Visual Studio.

      1. Pada panel Solution Explorer di Visual Studio, klik kanan proyek Anda dan pilih Manage NuGet Packages.

      2. Pada panel NuGet Package Manager, klik Browse.

      3. Pada tab Browse, masukkan aliyun-net-sdk di kotak pencarian dan pilih paket aliyun-net-sdk-iot yang disediakan oleh Alibaba Cloud.

      4. Klik Install.

    Inisialisasi IoT Platform SDK untuk C++

    Contoh berikut menunjukkan cara menginisialisasi SDK jika layanan IoT Platform Anda berada di wilayah China (Shanghai):

    Buat objek clientProfile untuk menyimpan informasi inisialisasi SDK. Kemudian, buat instance klien dari DefaultAcsClient. Gunakan metode DefaultAcsClient(clientProfile) untuk memuat informasi inisialisasi SDK.

    using Aliyun.Acs.Core;
using Aliyun.Acs.Core.Exceptions;
using Aliyun.Acs.Core.Profile;

string accessKeyId = Environment.GetEnvironmentVariable("ALIYUN_ACCESS_KEY_ID");
string accessKeySecret = Environment.GetEnvironmentVariable("ALIYUN_ACCESS_KEY_SECRET");

IClientProfile clientProfile = DefaultProfile.GetProfile("cn-shanghai", accessKeyId, accessKeySecret);
DefaultAcsClient client = new DefaultAcsClient(clientProfile);

    Objek clientProfile digunakan untuk menyimpan informasi inisialisasi SDK.

    Mulai permintaan

    SDK mengenkapsulasi dua kelas untuk setiap operasi API. Nama kelas dalam format ${Nama Operasi API}+"Request" dan ${Nama Operasi API}+"Response".

    • ${Nama Operasi API}+"Request": Kelas ini digunakan untuk memanggil operasi API. Anda dapat menggunakan instance permintaan dari kelas ini dan memanggil metode request.${nama parameter permintaan} untuk mengonfigurasi parameter permintaan.

    • ${Nama Operasi API}+"Response" Anda dapat memanggil metode GetAcsResponse(request) dari instance klien yang dibuat dari DefaultAcsClient untuk mendapatkan respons. Anda dapat memanggil metode response response.${nama parameter respons} dari instance respons dari kelas ${Nama Operasi API}+"Response" untuk mendapatkan nilai parameter respons.

      Sebagai contoh, Anda dapat memanggil metode response.Success() untuk mendapatkan nilai parameter Success. Parameter ini adalah parameter respons umum yang menunjukkan apakah pemanggilan berhasil. Parameter respons umum lainnya termasuk RequestId, ErrorMessage, dan Code.

    Untuk informasi lebih lanjut tentang operasi API dari IoT Platform, lihat Daftar operasi berdasarkan fungsi. Untuk informasi lebih lanjut tentang parameter request dan response dari setiap operasi API, lihat dokumentasi API.

    Contoh berikut menunjukkan cara memanggil operasi Pub untuk menerbitkan pesan ke topik. Untuk informasi lebih lanjut tentang parameter permintaan, lihat Pub.

    Penting

    Pada kode sampel berikut, ${iotInstanceId} menentukan ID suatu instans. Anda dapat melihat ID instans pada halaman Overview di konsol IoT Platform.

    • Jika instans Anda memiliki ID, Anda harus menentukan ID untuk parameter ini. Jika tidak, permintaan akan gagal.

    • Jika tidak ada halaman Overview atau ID yang dihasilkan untuk instans Anda, Anda tidak perlu menentukan parameter ini. Anda harus menghapus kode permintaan yang terkait dengan parameter IotInstanceId atau menentukan string kosong ("") untuk parameter tersebut. Jika tidak, permintaan akan gagal.

    Untuk informasi lebih lanjut tentang instans IoT Platform, lihat Ikhtisar. Untuk informasi lebih lanjut tentang cara membeli instans, lihat Beli instans Edisi Perusahaan. Untuk informasi lebih lanjut tentang pertanyaan yang sering diajukan, lihat FAQ tentang instans IoT Platform.

    PubRequest request = new PubRequest();
request.IotInstanceId = "<iotInstanceId>"; 
request.ProductKey = "<productKey>";
request.TopicFullName = "/<productKey>/<deviceName>/get";
byte[] payload = Encoding.Default.GetBytes("Hello World.");
String payloadStr = Convert.ToBase64String(payload);
request.MessageContent = payloadStr;
request.Qos = 0;
try
{
   PubResponse response = client.GetAcsResponse(request);
   Console.WriteLine("hasil publikasi pesan: " + response.Success);
   Console.WriteLine(response.ErrorMessage);
}
catch (ServerException e)
{
   Console.WriteLine(e.ErrorCode);
   Console.WriteLine(e.ErrorMessage);
}
catch (ClientException e)
{
   Console.WriteLine(e.ErrorCode);
   Console.WriteLine(e.ErrorMessage);
}

    Lampiran: Kode sampel

    Anda dapat melihat atau mengunduh kode sampel operasi API di IoT Platform SDK Sample Center. Kode sampel SDK untuk Java, Python, PHP, .NET, dan Go disediakan.

    Alibaba Cloud OpenAPI Explorer menyediakan alat debugging online untuk operasi API. Di halaman Debugging API, Anda dapat mencari operasi API, memanggil operasi API, dan menghasilkan kode sampel untuk operasi API dari berbagai SDK. Di sisi kanan halaman, Anda dapat melihat kode sampel SDK di tab Kode Sampel. Di tab Hasil Debugging, Anda dapat melihat URL permintaan sebenarnya dan respons dalam format JSON.