Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Referensi ini mencantumkan Azure SDK yang dapat Anda gunakan untuk membangun solusi IoT, termasuk SDK perangkat, layanan, dan manajemen untuk IoT Hub dan Device Provisioning Service (DPS), pratinjau SDK untuk manajemen sertifikat, dan tautan ke api sarana kontrol dan sarana data Azure Digital Twins.
SDK Perangkat
SDK perangkat Microsoft Azure IoT berisi kode yang memfasilitasi pembuatan aplikasi yang tersambung dan dikelola oleh layanan Azure IoT Hub. SDK ini dapat berjalan pada perangkat komputasi yang berbasis MPU umum seperti PC, tablet, smartphone, atau Raspberry Pi. SDK mendukung pengembangan dalam C dan dalam bahasa terkelola modern termasuk dalam C#, Node.js, Python, dan Java.
SDK yang tersedia dalam berbagai bahasa memberikan fleksibilitas yang dapat Anda pilih berdasarkan pada tim dan skenario Anda.
| Bahasa | Paket | Sumber | Quickstarts | Samples | Referensi |
|---|---|---|---|---|---|
| .NET | NuGet | GitHub | Hubungkan ke IoT Hub | Sampel | Referensi |
| Python | pip | GitHub | Hubungkan ke IoT Hub | Sampel | Referensi |
| Node.js | npm | GitHub | Hubungkan ke IoT Hub | Sampel | Referensi |
| Java | Maven | GitHub | Hubungkan ke IoT Hub | Sampel | Referensi |
| C | paket | GitHub | Hubungkan ke IoT Hub | Sampel | Referensi |
SDK perangkat Java mencakup sampel untuk Android.
SDK perangkat C mencakup sampel untuk iOS yang menggunakan CocoaPods.
Peringatan
Azure IoT C SDK tidak cocok untuk aplikasi yang disematkan karena manajemen memori dan model utasnya. Untuk opsi SDK untuk perangkat tertanam, lihatlah SDK perangkat tertanam.
Gunakan SDK perangkat untuk mengembangkan kode agar berjalan pada perangkat IoT yang tersambung ke IoT Hub atau IoT Central.
SDK perangkat tertanam
SDK ini telah dirancang dan dibuat untuk berjalan pada perangkat dengan sumber daya komputasi dan memori yang terbatas dan diimplementasikan dengan menggunakan bahasa C.
SDK perangkat yang disematkan tersedia untuk beberapa sistem operasi yang memberikan fleksibilitas untuk memilih yang paling sesuai dengan skenario Anda.
| RTOS | SDK | Sumber | Samples | Referensi |
|---|---|---|---|---|
| Eclipse ThreadX | Azure RTOS Middleware | GitHub | Mulai Cepat | Referensi |
| FreeRTOS | Middleware FreeRTOS | GitHub | Sampel | Referensi |
| logam polos | Azure SDK untuk Embedded C | GitHub | Sampel | Referensi |
Gunakan SDK perangkat yang disematkan untuk mengembangkan kode agar berjalan pada perangkat IoT yang tersambung ke IoT Hub atau IoT Central.
Untuk mempelajari selengkapnya tentang kapan menggunakan SDK perangkat yang disematkan, lihat skenario penggunaan C SDK dan Embedded C SDK.
Siklus hidup dan dukungan SDK Perangkat
Bagian ini merangkum siklus hidup dan kebijakan dukungan SDK Perangkat Azure IoT. Untuk informasi selengkapnya, lihat Azure SDK Siklus Hidup dan kebijakan dukungan.
Siklus hidup paket
Paket dirilis dalam kategori berikut. Setiap kategori memiliki struktur dukungan yang ditentukan.
Beta - Juga dikenal sebagai Pratinjau atau Kandidat Rilis. Tersedia untuk tujuan akses awal dan umpan balik dan tidak disarankan untuk digunakan dalam produksi. Dukungan versi pratinjau terbatas pada masalah GitHub. Rilis pratinjau biasanya ditayangkan selama kurang dari enam bulan, setelah itu dihentikan penggunaannya atau dirilis menjadi aktif.
Aktif - Umumnya tersedia dan didukung penuh, menerima pembaruan fitur baru, serta perbaikan bug dan keamanan. Gunakan versi terbaru karena versi tersebut menerima perbaikan dan pembaruan.
Tidak digunakan lagi - Digantikan oleh rilis yang lebih baru. Depresiasi terjadi bersamaan dengan saat rilis baru mulai aktif. Rilis yang tidak digunakan lagi membahas perbaikan bug paling penting dan perbaikan keamanan selama 12 bulan lagi.
Dapatkan dukungan
Jika Anda mengalami masalah saat menggunakan SDK Azure IoT, cari dukungan melalui opsi berikut:
Reporting bug - Semua pelanggan dapat melaporkan bug di halaman masalah untuk repositori GitHub yang terkait dengan SDK yang relevan.
Microsoft tim Dukungan Pelanggan - Pengguna yang memiliki paket dukungan dapat melibatkan tim Dukungan Pelanggan Microsoft dengan membuat tiket dukungan langsung dari portal Azure.
SDK layanan IoT Hub
SDK layanan Azure IoT berisi kode untuk memfasilitasi pembuatan aplikasi yang berinteraksi langsung dengan IoT Hub untuk mengelola perangkat dan keamanan.
| Platform | Paket | Repositori kode | Samples | Referensi |
|---|---|---|---|---|
| .NET | NuGet | GitHub | Sampel | Referensi |
| Java | Maven | GitHub | Sampel | Referensi |
| Simpul | npm | GitHub | Sampel | Referensi |
| Python | pip | GitHub | Sampel | Referensi |
Untuk mempelajari selengkapnya tentang menggunakan SDK layanan untuk berinteraksi dengan perangkat melalui hub IoT, lihat panduan pengembang layanan IoT Plug and Play.
SDK manajemen IoT Hub
SDK manajemen IoT Hub membantu Anda membangun aplikasi backend yang mengelola hub IoT di langganan Azure Anda.
| Platform | Paket | Repositori kode | Referensi |
|---|---|---|---|
| .NET | NuGet | GitHub | Referensi |
| Java | Maven | GitHub | Referensi |
| Node.js | npm | GitHub | Referensi |
| Python | pip | GitHub | Referensi |
Alternatif untuk SDK manajemen termasuk Azure CLI, PowerShell, dan REST API.
SDK perangkat DPS
SDK perangkat DPS menyediakan implementasi Register API dan lainnya yang digunakan perangkat untuk melakukan provisi melalui DPS. SDK perangkat dapat berjalan pada perangkat komputasi berbasis MPU umum seperti PC, tablet, smartphone, atau Raspberry Pi. SDK mendukung pengembangan dalam C dan dalam bahasa terkelola modern termasuk dalam C#, Node.js, Python, dan Java.
Tabel berikut mencantumkan SDK perangkat yang tersedia untuk setiap bahasa yang didukung.
| Platform | Paket | Repositori kode | Samples | Mulai Cepat | Referensi |
|---|---|---|---|---|---|
| .NET | NuGet | GitHub | Sampel | Quickstart | Referensi |
| C | apt-get, MBED, Arduino IDE atau iOS | GitHub | Sampel | Quickstart | Referensi |
| Java | Maven | GitHub | Sampel | Quickstart | Referensi |
| Node.js | npm | GitHub | Sampel | Quickstart | Referensi |
| Python | pip | GitHub | Sampel | Quickstart | Referensi |
Peringatan
SDK C yang tercantum di atas tidak cocok dengan aplikasi tersematkan karena manajemen memori dan model pengalurannya (threading). Untuk perangkat tersematkan, lihat SDK perangkat terisematkan.
SDK perangkat tertanam DPS
SDK ini telah dirancang dan dibuat untuk berjalan pada perangkat dengan sumber daya komputasi dan memori yang terbatas dan diimplementasikan dengan menggunakan bahasa C.
| RTOS | SDK | Sumber | Samples | Referensi |
|---|---|---|---|---|
| Eclipse ThreadX | Azure RTOS Middleware | GitHub | Mulai Cepat | Referensi |
| FreeRTOS | Middleware FreeRTOS | GitHub | Sampel | Referensi |
| logam polos | Azure SDK untuk Embedded C | GitHub | Sampel | Referensi |
Pelajari selengkapnya tentang perangkat dan SDK perangkat yang disematkan di SDK IoT.
SDK layanan DPS
SDK layanan DPS membantu Anda membangun aplikasi backend untuk mengelola pendaftaran dan rekaman pendaftaran dalam instans DPS.
| Platform | Paket | Repositori kode | Samples | Mulai Cepat | Referensi |
|---|---|---|---|---|---|
| .NET | NuGet | GitHub | Sampel | Quickstart | Referensi |
| Java | Maven | GitHub | Sampel | Quickstart | Referensi |
| Node.js | npm | GitHub | Sampel | Quickstart | Referensi |
SDK manajemen DPS
SDK manajemen DPS membantu Anda membangun aplikasi backend yang mengelola instans DPS dan metadatanya dalam langganan Azure Anda.
| Platform | Paket | Repositori kode | Referensi |
|---|---|---|---|
| .NET | NuGet | GitHub | Referensi |
| Java | Maven | GitHub | Referensi |
| Node.js | npm | GitHub | Referensi |
| Python | pip | GitHub | Referensi |
SDK manajemen sertifikat (pratinjau)
Untuk SDK yang mendukung manajemen sertifikat X.509 yang didukung Microsoft dalam pratinjau, gunakan instruksi dan sampel berikut. Untuk menggunakan SDK manajemen sertifikat dalam pratinjau, Anda harus menggunakan Azure IoT Hub dengan instans DPS tertaut, dan perangkat harus menyediakan melalui DPS.
SDK perangkat manajemen sertifikat (pratinjau)
Tabel berikut mencantumkan SDK platform yang saat ini mendukung manajemen sertifikat X.509 yang didukung Microsoft dalam pratinjau.
| Bahasa | Paket | Sumber/Cabang | Samples |
|---|---|---|---|
| .NET | NuGet | Azure/azure-iot-sdk-csharp pada feature/iot-csr-preview | CertificateSigningRequestSample |
| Python | pip | Azure/azure-iot-sdk-python pada feature/iot-csr-preview | sampel cert-mgmt |
| Node.js | npm | Tidak tersedia | Tidak tersedia |
| Java | Maven | Azure/azure-iot-sdk-java di feature/csr | certificate-signing-sample |
| C | paket | Azure/azure-iot-sdk-c di feature/dps-csr-preview | iothub_ll_client_sample_certificate_signing_request |
SDK perangkat yang disematkan manajemen sertifikat (pratinjau)
Tabel berikut mencantumkan SDK tersemat yang saat ini mendukung manajemen sertifikat X.509 yang didukung Microsoft dalam pratinjau.
| RTOS | SDK | Sumber | Samples |
|---|---|---|---|
| FreeRTOS | Middleware FreeRTOS | Azure/azure-iot-middleware-freertos di feature/dps-csr-preview | Tidak tersedia |
| logam polos | Azure SDK untuk Embedded C | Azure/azure-sdk-for-c di feature/dps-csr-preview | paho_iot_hub_csr_sample.c |
AZURE DIGITAL TWINS API sarana kontrol
API sarana kontrol ARM API yang digunakan untuk mengelola instans Azure Digital Twins Anda secara keseluruhan, sehingga mencakup operasi seperti membuat atau menghapus seluruh instans Anda. Anda juga akan menggunakan API ini untuk membuat dan menghapus titik akhir.
Untuk memanggil API secara langsung, referensikan folder Swagger terbaru di repositori Swagger bidang control. Folder ini juga menyertakan folder contoh yang menampilkan penggunaan.
Berikut adalah SDK yang saat ini tersedia untuk API sarana kontrol Azure Digital Twins.
AZURE DIGITAL TWINS API data plane
API data plane adalah API Azure Digital Twins yang digunakan untuk mengelola elemen dalam instans Azure Digital Twins Anda. API ini meliputi operasi seperti membuat rute, mengunggah model, menciptakan hubungan, dan mengelola kembaran, dan dapat dibagi secara luas menjadi kategori berikut:
-
DigitalTwinModels- Kategori DigitalTwinModels berisi API untuk mengelola model dalam instans Azure Digital Twins. Kegiatan pengelolaan meliputi pengunggahan, validasi, pengambilan, dan penghapusan model yang ditulis dalam DTDL. -
DigitalTwins- Kategori DigitalTwins berisi API yang memungkinkan pengembang membuat, memodifikasi, dan menghapus kembar digital dan hubungannya dalam instans Azure Digital Twins. -
Query- Kategori Kueri memungkinkan pengembang menemukan kumpulan kembar digital dalam grafik kembar melalui hubungan. -
Event Routes- Kategori Rute Peristiwa berisi API untuk merutekan data, melalui sistem dan ke layanan hilir. -
Import Jobs- API Impor Pekerjaan memungkinkan Anda mengelola tindakan asinkron yang berjalan lama untuk mengimpor model, kembar , dan hubungan secara massal. -
Delete Jobs- Delete Jobs API memungkinkan Anda mengelola tindakan asinkron yang berjalan lama untuk menghapus semua model, kembar, dan hubungan dalam suatu instans.
Untuk memanggil API secara langsung, referensikan folder Swagger terbaru di repositori Swagger bidang data. Folder ini juga menyertakan folder contoh yang menampilkan penggunaan. Anda juga dapat melihat dokumentasi referensi API bidang data.
Berikut adalah SDK yang saat ini tersedia untuk API sarana data Azure Digital Twins.
| Bahasa SDK | Tautan paket | Dokumentasi rujukan | Kode sumber |
|---|---|---|---|
| .NET (C#) | Azure. DigitalTwins.Core di NuGet | Reference untuk pustaka klien Azure IoT Digital Twins untuk .NET | pustaka klien Azure IoT Digital Twins untuk .NET pada GitHub |
| Java | com.azure:azure-digitaltwins-core pada Maven | Reference untuk SDK Azure Digital Twins untuk Java | pustaka klien Azure IoT Digital Twins untuk Java pada GitHub |
| JavaScript | pustaka klien Azure Azure Digital Twins Core untuk JavaScript di npm | Reference for @azure/digital-twins-core | pustaka klien Azure Azure Digital Twins Core untuk JavaScript di GitHub |
| Python | pustaka klien Azure Azure Digital Twins Core untuk Python di PyPI | Referensi untuk Azure DigitalTwins Core | pustaka klien Azure Azure Digital Twins Core untuk Python pada GitHub |
Langkah berikutnya
Langkah berikutnya yang disarankan meliputi: