IoT Platform menyediakan fitur bayangan perangkat untuk menyimpan data status yang dikirimkan oleh setiap perangkat serta perintah yang dikirim oleh aplikasi. Perangkat yang online dapat menerima perintah dari IoT Platform. Jika perangkat offline, Anda dapat meminta perintah dari IoT Platform setelah perangkat kembali online. Topik ini menjelaskan skenario penggunaan fitur bayangan perangkat dan cara menggunakannya.
Bayangan perangkat
Bayangan perangkat adalah file JSON yang digunakan untuk menyimpan data status yang dikirimkan oleh perangkat dan data status perangkat yang diinginkan oleh aplikasi. Untuk informasi lebih lanjut tentang format JSON, lihat Format JSON Bayangan Perangkat.
Setiap perangkat hanya memiliki satu bayangan. Perangkat dapat memperoleh atau mengonfigurasi bayangan di IoT Platform melalui Message Queuing Telemetry Transport (MQTT) untuk menyinkronkan status.
Perbedaan antara bayangan perangkat dan nilai properti yang diinginkan
Nilai properti yang diinginkan dan bayangan perangkat adalah data yang diinginkan yang disimpan di IoT Platform. Setelah perangkat online, perangkat tersebut memperoleh data yang diinginkan untuk menjalankan logika bisnis yang sesuai. Tabel berikut menjelaskan perbedaan antara nilai properti yang diinginkan dan bayangan perangkat berdasarkan ruang lingkup aplikasi.
Item | Deskripsi |
Nilai properti yang diinginkan | Ruang lingkup aplikasi sempit. Anda hanya dapat menentukan nilai untuk properti Thing Specification Language (TSL) dari suatu perangkat. Sebelum menggunakan fitur ini, Anda harus mendefinisikan model TSL untuk perangkat. Jika Anda ingin menentukan nilai yang diinginkan untuk properti TSL perangkat, Anda dapat menggunakan fitur ini. Untuk lebih banyak contoh, lihat Tentukan nilai properti yang diinginkan untuk mengontrol status lampu. |
Bayangan perangkat | Ruang lingkup aplikasi luas. Fitur ini tidak bergantung pada properti TSL. Anda dapat menggunakan fitur ini untuk menentukan data untuk perangkat, seperti status perangkat. Bagian berikutnya menjelaskan skenario spesifik. Untuk informasi lebih lanjut tentang cara mengonfigurasi bayangan perangkat, lihat Format JSON bayangan perangkat. |
Skenario
Dalam skenario berikut, Anda dapat menggunakan fitur bayangan perangkat untuk memperoleh data status yang dikirimkan oleh perangkat dan data status perangkat yang diinginkan oleh aplikasi.
Aplikasi meminta status perangkat.
Skenario:
Perangkat sering online dan offline karena ketidakstabilan jaringan. Dalam hal ini, perangkat tidak dapat memproses permintaan dari aplikasi.
Beberapa aplikasi mungkin meminta data status perangkat secara bersamaan. Perangkat tidak dapat memproses permintaan bersamaan atau memberikan respons kepada aplikasi.
Anda dapat menyinkronkan status dari perangkat ke bayangan di IoT Platform. Aplikasi dapat memperoleh data status terbaru dari bayangan. Dengan cara ini, aplikasi dipisahkan dari perangkat.
Gambar berikut menunjukkan prosesnya. Untuk informasi lebih lanjut, lihat Perangkat Mengirimkan Status.
Aplikasi mengirimkan perintah untuk mengubah status perangkat.
Deskripsi: Perangkat sedang offline, atau perangkat sering online dan offline karena ketidakstabilan jaringan. Dalam hal ini, perintah dari aplikasi mungkin gagal dikirim ke perangkat.
Anda dapat menyimpan perintah dengan cap waktu di bayangan. Setelah perangkat online, perangkat memperoleh perintah dari bayangan dan menentukan apakah akan memproses perintah berdasarkan cap waktu.
Gambar berikut menunjukkan prosesnya. Untuk informasi lebih lanjut, lihat Aplikasi Mengubah Status Perangkat, Perangkat Meminta Bayangan, dan Perangkat Menghapus Properti Bayangan.
Lihat dan perbarui bayangan perangkat
Anda harus mengonfigurasi fitur bayangan perangkat untuk perangkat. Untuk informasi lebih lanjut, lihat Bayangan Perangkat.
Setelah Anda mengonfigurasi perangkat dan menghubungkan perangkat ke IoT Platform, Anda dapat melihat dan memperbarui status bayangan perangkat di Konsol IoT Platform.
Masuk ke Konsol IoT Platform.
Di halaman Overview, klik All environment. Di tab Semua Lingkungan, temukan instance yang ingin Anda kelola dan klik ID instance atau nama instance.
Di panel navigasi sisi kiri, pilih .
Di halaman Perangkat, temukan perangkat yang ingin Anda kelola dan klik View di kolom Tindakan. Halaman Device Details muncul.
Klik tab Device Shadow. Di tab ini, Anda dapat melihat device shadow yang dikirimkan oleh perangkat.
Klik Update Shadow. Masukkan informasi status yang diinginkan di bagian
"desired".Untuk informasi tentang format shadow perangkat, lihat Format JSON Bayangan Perangkat.
Perangkat memperoleh data status yang diinginkan dengan berlangganan topik tertentu. Jika perangkat sedang online, IoT Platform mendorong status yang diinginkan ke perangkat secara real time.
Jika perangkat sedang offline, bayangan perangkat menyimpan cache data status yang diinginkan. Setelah perangkat kembali online, perangkat menarik data status terbaru yang diinginkan dari IoT Platform.
Operasi API terkait
GetDeviceShadow: menanyakan bayangan perangkat.
UpdateDeviceShadow: memperbarui bayangan perangkat.