Les propriétés utilisateur MQTT 5.0 permettent d'associer des métadonnées personnalisées sous forme de paires clé-valeur aux paquets de contrôle, enrichissant ainsi la communication entre les appareils et les applications sans modifier le corps du message.
Fonctionnement des propriétés utilisateur
Les propriétés utilisateur sont des paires clé-valeur personnalisées associées aux paquets de contrôle MQTT 5.0. Elles fonctionnent comme des en-têtes HTTP : vous définissez les clés et les valeurs sous forme de chaînes UTF-8, et le broker les transmet avec le paquet.
Les propriétés utilisateur constituent un élément fondamental de MQTT 5.0. Plusieurs fonctionnalités natives du protocole, telles que l'expiration de session, l'expiration des messages et le modèle requête-réponse, s'appuient sur ces propriétés. Les propriétés utilisateur personnalisées étendent ce mécanisme à vos propres cas d'utilisation.
Vous pouvez associer des propriétés utilisateur à tous les paquets de contrôle MQTT 5.0, à l'exception des paquets de maintien de connexion (heartbeat). Le paquet PUBLISH suivant inclut deux propriétés utilisateur :
Topic: "sys/${productkey}/${devicename}/update"
Payload: "hello world!"
UserProperty: "key1_timestamp:value1_12345"
UserProperty: "key2_msgid:value2_123"Limites
Spécifiez jusqu'à 20 propriétés utilisateur.
IoT Platform traite les propriétés utilisateur uniquement pour les paquets
Connect/Publish. Elle ignore les propriétés utilisateur présentes sur les autres types de paquets.
Cas d'utilisation
Format du contenu des messages
Utilisez les propriétés utilisateur pour décrire le contenu d'un payload. Un seul topic peut ainsi transporter des payloads de différents types ou provenant de différents lots d'appareils ; les abonnés peuvent alors router ou analyser les messages en fonction des valeurs des propriétés utilisateur plutôt que d'inspecter le payload lui-même.
Segmentation des messages
MQTT est conçu pour les petits paquets. MQTT 5.0 permet aux appareils de négocier la taille maximale des paquets avec IoT Platform. Lorsqu'un message dépasse cette limite, utilisez les propriétés utilisateur pour le diviser en sous-messages. Le serveur métier lit les propriétés utilisateur de chaque sous-message pour identifier et réassembler le message d'origine. Le schéma suivant illustre la division par l'appareil A d'un seul message en Message A et Message B. Pour plus d'informations, consultez Abonnement côté serveur.
Transfert de messages
Utilisez une propriété utilisateur pour baliser un message avec son type et sa destination prévue. Le moteur de règles lit ce tag et transfère le message en conséquence. Le schéma suivant montre comment définir le paramètre UserProperty afin que les messages de l'appareil A soient routés vers différentes destinations en fonction du type de message. Pour plus d'informations, consultez Vue d'ensemble.
