全部产品
Search
文档中心

IoT Platform:Properti pengguna

更新时间:Jun 21, 2025

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.

image..png

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.

image..png

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.

image..png