All Products
Search
Document Center

IoT Platform:Retained messages

Last Updated:Jun 19, 2026

Retained messages memastikan bahwa subscriber baru ke suatu topik menerima pesan status terbaru, meskipun pesan tersebut dipublikasikan sebelum mereka berlangganan. Saat server mempublikasikan pesan dengan flag retain ke suatu topik, Platform IoT menyimpan pesan tersebut dan mengirimkannya kepada subscriber saat ini. Perangkat yang kemudian berlangganan ke topik tersebut juga akan menerima retained message. Fitur retained messages didefinisikan dalam standar MQTT 3.1.1, dan Alibaba Cloud IoT Platform mendukungnya untuk koneksi MQTT 5.0.

Retained messagesimage..png

  • Perbarui retained message:

    • Menerbitkan pesan baru ke topik yang sama akan menimpa muatan (payload) retained message yang ada.

    • Flag retain dapat digunakan untuk mengirimkan pesan ke beberapa perangkat, terlepas dari status online-nya.

  • Hapus retained message:

    • Menerbitkan pesan dengan payload kosong ke topik yang sama akan menghapus retained message tersebut.

    • Retained message dihapus setelah interval message expiration berlalu. Fitur ini berguna untuk pesan yang menjadi tidak valid setelah periode tertentu, seperti data pengatur suhu. Untuk menggunakan fitur ini, atur atribut message expiration.

    • Retained message tidak terpengaruh oleh session expiration dan tetap tersimpan meskipun sesi telah kedaluwarsa.

Scenarios

Retained messages sangat ideal untuk mengonfigurasi perangkat offline. Sebagai contoh, layar iklan masuk mode hibernasi pada malam hari untuk menghemat energi dan menyala kembali pada siang hari. Kontennya diperbarui setiap hari. Mendorong pembaruan dari server lebih efisien dibandingkan meminta perangkat melakukan polling secara berkala. Namun, jika server mendorong pembaruan saat perangkat sedang offline, pesan tersebut tidak dapat dikirimkan. Retained messages mengatasi masalah ini dengan memastikan bahwa perangkat menerima pesan terbaru saat kembali online.image..png