Tema ini menjelaskan fitur properti pengguna MQTT 5.0.
Informasi latar belakang
Paket MQTT 5.0 mendukung fitur properti. Anda dapat menambahkan properti tambahan dalam format kunci-nilai ke paket kontrol. Beberapa fitur MQTT 5.0 diimplementasikan berdasarkan fitur properti pengguna, seperti kedaluwarsa sesi, kedaluwarsa pesan, dan pola permintaan-respons. Properti pengguna adalah sejenis properti yang mirip dengan header HTTP. Anda dapat mengonfigurasi properti pengguna kustom lengkap yang berisi string UTF-8 dalam format kunci-nilai. Properti pengguna dapat dikonfigurasi untuk semua paket kontrol MQTT 5.0, kecuali untuk paket heartbeat. Properti pengguna digunakan untuk mentransmisikan informasi kustom tambahan antara perangkat dan aplikasi. Contoh:
Topik: “sys/${productkey}/${devicename}/update”
Payload: "hello world!"
UserProperty: "key1_timestamp:value1_12345"
UserProperty: "key2_msgid:value2_123"Batasan
Anda dapat menentukan hingga 20 properti pengguna.
IoT Platform hanya memproses properti pengguna dari paket
Connect/Publish.
Skenario
Format konten pesan
Anda dapat menggunakan properti pengguna untuk menggambarkan payload. Dengan cara ini, sebuah topik dapat mendukung berbagai jenis payload, sehingga memungkinkan pengelolaan perangkat dari batch yang berbeda.

Pembagian pesan
MQTT cocok untuk skenario di mana paket kecil digunakan. MQTT 5.0 memungkinkan perangkat untuk bernegosiasi panjang paket maksimum dengan IoT Platform. Jika panjang paket maksimum tidak dapat memenuhi kebutuhan bisnis Anda, Anda dapat menggunakan properti pengguna untuk membagi paket. Gambar berikut menunjukkan bahwa sebuah pesan dibagi menjadi Pesan A dan Pesan B ketika Perangkat A mengirim pesan tersebut. Server bisnis mengidentifikasi sub-pesan dengan membaca properti pengguna dari sub-pesan tersebut dan kemudian menggabungkan sub-pesan tersebut. Untuk informasi lebih lanjut, lihat Langganan Sisi Server.

Penerusan pesan
Anda dapat menggunakan properti pengguna untuk menentukan tipe dan tujuan pesan yang akan diteruskan. Dengan cara ini, mesin aturan dapat mengidentifikasi properti pengguna dan meneruskan pesan tersebut. Gambar berikut menunjukkan cara mengonfigurasi parameter UserProperty untuk menentukan tujuan penerusan data ketika Perangkat A mengirimkan berbagai jenis pesan. Untuk informasi lebih lanjut, lihat Ikhtisar.
