IoT Platform memungkinkan Anda menggunakan grup konsumen untuk berlangganan pesan topik dan meneruskan pesan tersebut ke server Protokol Antrian Pesan Lanjutan (AMQP). Topik ini menjelaskan cara mengonfigurasi dan mengelola langganan sisi server AMQP di Konsol IoT Platform.
Prasyarat
Grup konsumen telah dibuat. Grup konsumen digunakan untuk berlangganan pesan dari topik. Anda dapat menggunakan grup konsumen default (DEFAULT_GROUP) atau membuat grup konsumen baru di IoT Platform. Untuk informasi lebih lanjut, lihat Kelola Grup Konsumen.
Konfigurasikan langganan
Untuk menentukan jenis pesan yang ingin dilanggan, ikuti langkah-langkah berikut:
Masuk ke Konsol IoT Platform.
Di halaman Overview, klik All environment. Di tab All environment, temukan instance yang ingin dikelola dan klik ID instance atau nama instance.
Di panel navigasi sisi kiri, pilih .
Di halaman Server-side Subscription, klik Create Subscription.
Di kotak dialog Create Subscription, konfigurasikan parameter yang diperlukan dan klik OK. Tabel berikut menjelaskan parameter tersebut.
Parameter
Deskripsi
Produk
Pilih produk tempat perangkat-perangkat tersebut berada. Pesan-pesan yang dikirim oleh perangkat akan didorong ke konsumen.
Tipe Langganan
Pilih AMQP.
Grup Konsumen
Pilih grup konsumen. Anda dapat menentukan beberapa grup konsumen untuk satu produk dan membuat beberapa langganan untuk beberapa produk dalam satu grup konsumen.
IoT Platform menyediakan grup konsumen default untuk mengonsumsi pesan. Jika Anda ingin mengelompokkan konsumen, lakukan langkah-langkah berikut untuk membuat grup konsumen: Di pojok kanan bawah kotak dialog Select Consumer Groups, klik Create Consumer Group dan konfigurasikan parameter sesuai petunjuk. Untuk informasi lebih lanjut, lihat Kelola grup konsumen.
Tipe Pesan
Pilih tipe-tipe pesan. Anda dapat berlangganan tipe-tipe pesan perangkat berikut. Untuk informasi lebih lanjut tentang topik komunikasi dasar, topik penerusan pesan, dan format data terkait, lihat Format data.
PentingJika Anda menggunakan produk dan perangkat gateway cloud, IoT Platform hanya mendorong pesan Device Upstream Notification, Device Status Change Notification, dan Device Changes Throughout Lifecycle ke produk dan perangkat tersebut. Untuk informasi lebih lanjut tentang topik penerusan pesan dan format data, lihat Pengiriman pesan melalui MQTT open source, Pengiriman pesan melalui JT/T 808, dan Pengiriman pesan melalui GB/T 32960.
Device Upstream Notification: pesan-pesan dalam topik yang parameter Allowed Operations-nya disetel ke Publish. Untuk informasi lebih lanjut, lihat Topik.
Pesan-pesan tersebut mencakup data kustom dan data Thing Specification Language (TSL) yang dikirim oleh perangkat. Data TSL hulu mencakup data properti, data acara, respons terhadap permintaan pengaturan properti, dan respons terhadap panggilan layanan. Data TSL yang didorong ke server pengguna diproses oleh IoT Platform. Untuk informasi lebih lanjut, lihat Format data.
Sebagai contoh, kategori topik berikut didefinisikan untuk sebuah produk:
/${YourProductKey}/${YourDeviceName}/user/get. Parameter Operasi yang Diizinkan untuk kategori topik ini disetel ke Berlangganan./${YourProductKey}/${YourDeviceName}/user/update. Parameter Operasi yang Diizinkan untuk kategori topik ini disetel ke Publikasikan./${YourProductKey}/${YourDeviceName}/thing/event/property/post. Parameter Operasi yang Diizinkan untuk kategori topik ini disetel ke Publikasikan.
Fitur langganan sisi server mendorong pesan dari kategori topik berikut:
/${YourProductKey}/${YourDeviceName}/user/updatedan/${YourProductKey}/${YourDeviceName}/thing/event/property/post.PentingJika Anda ingin berlangganan data respons dari panggilan layanan asinkron, pastikan ID pesan yang dikembalikan oleh perangkat sama dengan ID pesan yang dihasilkan ketika IoT Platform mengirimkan data hilir.
Device Status Change Notification: notifikasi yang dikirim oleh perangkat saat perangkat online atau offline.
Gateway's sub-devices discovery report: data sub-perangkat yang dikirimkan oleh gateway ketika gateway mendeteksi sub-perangkat baru. Gateway harus memiliki aplikasi yang dapat digunakan untuk mendeteksi sub-perangkat. Jenis pesan ini spesifik untuk gateway.
Device Topological Relation Changes: notifikasi yang dikirim oleh gateway saat hubungan topologis antara sub-perangkat dan gateway dibuat atau dihapus. Jenis pesan ini spesifik untuk gateway.
Device Changes Throughout Lifecycle: notifikasi yang dikirim oleh perangkat saat perangkat dibuat, dihapus, diaktifkan, atau dinonaktifkan.
TSL Historical Data Reporting: properti historis dan acara yang dikirimkan oleh perangkat.
OTA Update Status Notification: notifikasi yang dikirim oleh perangkat selama verifikasi firmware dan pembaruan massal. Saat tugas pembaruan perangkat berhasil, gagal, dibatalkan, atau sedang dilakukan, notifikasi akan didorong.
Device tag change: pesan-pesan yang dikirim oleh perangkat saat tag perangkat diubah.
Submit a module version number: pesan-pesan yang dikirim oleh perangkat saat nomor versi modul over-the-air (OTA) diubah.
Batch status notification: notifikasi yang dikirim oleh perangkat saat status batch pembaruan OTA berubah.
CatatanSaat Anda mendengarkan pesan perangkat, Anda mungkin perlu memfilter atau memproses pesan tersebut. Dalam hal ini, Anda dapat meneruskan pesan ke grup konsumen AMQP dengan menggunakan aturan penerusan data. Kemudian, Anda dapat menerima pesan tersebut dengan menggunakan klien AMQP. Untuk informasi lebih lanjut, lihat Penerusan data.
Untuk informasi lebih lanjut tentang cara meneruskan pesan ke server AMQP dan topik perangkat yang dapat Anda langgani, lihat Format data.
Kelola langganan produk
Setelah mengonfigurasi langganan, buka halaman Server-side Subscription dan temukan produk tempat langganan dibuat. Anda dapat melakukan beberapa operasi pada langganan tersebut. Tabel berikut menjelaskan operasi-operasi tersebut.
Operasi | Prosedur |
Edit | Anda dapat mengubah grup konsumen dan tipe pesan.
|
Hapus | Peringatan Jika data perangkat yang Anda langgani untuk produk tersebut digunakan di aplikasi lain, layanan Anda mungkin menjadi tidak tersedia atau bisnis Anda mungkin terpengaruh. Lanjutkan dengan hati-hati.
|
Apa yang harus dilakukan selanjutnya
Konfigurasikan Klien AMQP: Disarankan untuk menggunakan SDK AMQP yang disediakan oleh IoT Platform. Alibaba Cloud tidak memberikan dukungan teknis untuk SDK AMQP yang dikembangkan pengguna.
Setelah konfigurasi selesai dan data perangkat yang dikirimkan diterima oleh klien AMQP, lakukan langkah-langkah berikut untuk melihat log di Konsol IoT Platform: Pilih . Tab Log jalankan cloud menampilkan entri log yang dihasilkan saat perangkat mengirimkan data, IoT Platform meneruskan data ke klien AMQP, dan klien AMQP mengembalikan pesan ACK.