Menggunakan properti dalam solusi Azure IoT Central

Panduan cara ini menunjukkan kepada Anda cara menggunakan properti perangkat yang ditentukan dalam templat perangkat di aplikasi Azure IoT Central Anda.

Properti mewakili nilai titik waktu. Misalnya, perangkat dapat menggunakan properti untuk melaporkan suhu target yang coba dijangkaunya. Secara default, properti perangkat bersifat baca-saja di IoT Central. Properti bisa-tulis memungkinkan Anda menyinkronkan status antara perangkat dan aplikasi Azure IoT Central Anda.

Anda juga dapat menentukan properti cloud dalam aplikasi Azure IoT Central. Nilai properti cloud tidak pernah ditukar dengan perangkat dan tidak dicakup dalam artikel ini.

Untuk mempelajari tentang konvensi properti IoT Plug and Play, lihat Konvensi IoT Plug and Play.

Untuk mempelajari selengkapnya tentang data properti yang ditukar perangkat dengan IoT Central, lihat Payload telemetri, properti, dan perintah.

Untuk mempelajari cara mengelola properti dengan menggunakan REST API IoT Central, lihat Cara menggunakan REST API IoT Central untuk mengontrol perangkat.

Untuk mempelajari cara menerapkan properti di perangkat tanpa menggunakan SDK perangkat, lihat Berkomunikasi dengan hub IoT menggunakan protokol MQTT.

Tentukan properti Anda

Properti adalah bidang data yang mewakili status perangkat Anda. Gunakan properti untuk mewakili status perangkat yang tahan lama, seperti status aktif/nonaktif perangkat. Properti juga dapat mewakili properti perangkat dasar, seperti versi perangkat lunak perangkat. Anda mendeklarasikan properti sebagai baca-saja atau bisa-tulis.

Cuplikan layar berikut menunjukkan definisi properti dalam aplikasi Azure IoT Central.

Tabel berikut memperlihatkan pengaturan konfigurasi untuk kapabilitas properti.

Bidang	Description
Nama tampilan	Nama tampilan untuk nilai properti yang digunakan pada petak peta dasbor dan formulir perangkat.
Nama	Nama properti . Azure IoT Central menghasilkan nilai untuk bidang ini dari nama tampilan, tetapi Anda dapat memilih nilai Anda sendiri jika perlu. Bidang ini harus alfanumerik. Kode perangkat menggunakan nilai Nama ini.
Jenis kapabilitas	Harta benda.
Jenis semantik	Jenis semantik properti, seperti suhu, status, atau peristiwa. Pilihan jenis semantik menentukan bidang mana dari yang berikut ini yang tersedia.
Schema	Jenis data properti, seperti ganda, string, atau vektor. Jenis semantik menentukan pilihan yang tersedia. Skema tidak tersedia untuk jenis semantik peristiwa dan status.
Bisa-tulis	Jika properti tidak dapat ditulis, perangkat dapat melaporkan nilai properti ke Azure IoT Central. Jika properti dapat ditulis, perangkat dapat melaporkan nilai properti ke Azure IoT Central. Kemudian Azure IoT Central dapat mengirim pembaruan properti ke perangkat.
Severity	Hanya tersedia untuk jenis peristiwa semantik. Tingkat keparahannya adalah Kesalahan, Informasi, atau Peringatan.
Nilai status	Hanya tersedia untuk jenis semantik status. Tentukan nilai status yang mungkin, yang masing-masing memiliki nama tampilan, nama, jenis enumerasi, dan nilai.
Unit	Unit untuk nilai properti, seperti mph, %, atau °C.
Unit tampilan	Unit tampilan untuk digunakan pada ubin dasbor dan formulir perangkat.
Comment	Komentar apa pun tentang kemampuan dari properti tersebut.
Description	Deskripsi kapabilitas properti.

Untuk mempelajari tentang Digital Twin Definition Language (DTDL) yang digunakan Azure IoT Central untuk menentukan properti dalam templat perangkat, lihat konvensi IoT Plug and Play > Properti baca-saja.

Bidang opsional, seperti nama dan deskripsi tampilan, memungkinkan Anda menambahkan detail selengkapnya ke antarmuka dan kemampuan.

Saat membuat properti, Anda dapat menentukan jenis skema kompleks seperti Objek dan Enum.

Saat Anda memilih Skema kompleks, seperti Objek, Anda perlu menentukan skema objek.

Menerapkan properti baca-saja

Secara bawaan, properti bersifat hanya-baca. Properti baca-saja memungkinkan perangkat melaporkan pembaruan nilai properti ke aplikasi Azure IoT Central Anda. Aplikasi Azure IoT Central Anda tidak dapat mengatur nilai properti baca-saja.

Azure IoT Central menggunakan perangkat ganda untuk menyinkronkan nilai properti antara perangkat dan aplikasi Azure IoT Central. Nilai properti perangkat menggunakan properti yang dilaporkan kembar perangkat. Untuk informasi selengkapnya, lihat Tutorial: Mengonfigurasi perangkat Anda dari layanan back-end.

Perangkat mengirim pembaruan properti sebagai payload JSON. Untuk informasi selengkapnya, lihat Payload telemetri, properti, dan perintah.

Anda dapat menggunakan SDK perangkat Azure IoT untuk mengirim pembaruan properti ke aplikasi Azure IoT Central Anda.

Misalnya implementasi dalam beberapa bahasa, lihat Tutorial: Membuat dan menyambungkan aplikasi klien ke aplikasi Azure IoT Central Anda.

Tampilan berikut di aplikasi Azure IoT Central memperlihatkan properti baca-saja perangkat:

Menerapkan properti bisa-tulis

Operator IoT Central mengatur properti bisa-tulis pada formulir. Azure IoT Central mengirimkan properti ke perangkat. Azure IoT Central mengharapkan pengakuan dari perangkat.

Misalnya implementasi dalam beberapa bahasa, lihat Membuat dan menyambungkan aplikasi klien ke aplikasi Azure IoT Central Anda.

Pesan respons harus menyertakan ac dan av. Bidang ad bersifat opsional. Untuk mempelajari lebih lanjut, lihat konvensi IoT Plug and Play > Properti bisa-tulis.

Saat operator mengatur properti yang dapat ditulis di antarmuka pengguna Azure IoT Central, aplikasi menggunakan properti yang diinginkan dari kembar perangkat untuk mengirim nilai ke perangkat. Perangkat kemudian merespons dengan menggunakan properti yang dilaporkan dari device twin. Saat Azure IoT Central menerima nilai properti yang dilaporkan, azure IoT Central memperbarui tampilan properti dengan status Diterima.

Saat Anda memasukkan nilai dan memilih Simpan, status awal tertunda. Saat perangkat menerima perubahan, status berubah menjadi Diterima.

Menggunakan properti pada perangkat yang tidak ditetapkan

Anda dapat melihat dan memperbarui properti yang dapat ditulis pada perangkat yang tidak ditetapkan ke template perangkat.

Untuk melihat properti yang sudah ada pada perangkat yang tidak ditetapkan, navigasikan ke perangkat di bagian Perangkat , pilih Kelola perangkat, lalu Properti Perangkat:

Anda dapat memperbarui properti yang dapat ditulis dalam tampilan ini.

Langkah selanjutnya

Sekarang setelah Anda tahu cara menggunakan properti di aplikasi Azure IoT Central Anda, lihat:

• Konvensi IoT Plug and Play
• Payload telemetri, properti, dan perintah
• Tutorial: Membuat dan menyambungkan aplikasi klien ke aplikasi Azure IoT Central Anda