Las propiedades de usuario de MQTT 5.0 permiten adjuntar metadatos personalizados en formato clave-valor a los paquetes de control. Esto facilita una comunicación más completa entre dispositivos y aplicaciones sin modificar la carga útil del mensaje.
Funcionamiento de las propiedades de usuario
Las propiedades de usuario son pares clave-valor personalizados que se adjuntan a los paquetes de control de MQTT 5.0. Funcionan de manera similar a los encabezados HTTP: usted define las claves y los valores como cadenas UTF-8, y el broker los transmite junto con el paquete.
Estas propiedades constituyen un elemento fundamental de MQTT 5.0. Varias funciones integradas del protocolo, como la expiración de sesión, la expiración de mensajes y el patrón solicitud-respuesta, se implementan mediante propiedades. Las propiedades de usuario personalizadas extienden este mecanismo para adaptarse a sus propios casos de uso.
Puede adjuntar propiedades de usuario a todos los paquetes de control de MQTT 5.0, excepto a los paquetes de latido. El siguiente paquete PUBLISH incluye dos propiedades de usuario:
Topic: "sys/${productkey}/${devicename}/update"
Payload: "hello world!"
UserProperty: "key1_timestamp:value1_12345"
UserProperty: "key2_msgid:value2_123"Límites
Especifique hasta 20 propiedades de usuario.
IoT Platform procesa las propiedades de usuario únicamente en los paquetes
Connect/Publish. Las propiedades de usuario en otros tipos de paquetes se ignoran.
Casos de uso
Formato del contenido del mensaje
Utilice las propiedades de usuario para describir el contenido de una carga útil. Así, un solo tema puede transportar cargas útiles de distintos tipos o provenientes de diferentes lotes de dispositivos. Los suscriptores pueden enrutar o analizar sintácticamente los mensajes según los valores de las propiedades de usuario, en lugar de inspeccionar la carga útil directamente.
Segmentación de mensajes
MQTT está diseñado para paquetes pequeños. MQTT 5.0 permite que los dispositivos negocien el tamaño máximo de paquete con IoT Platform. Cuando un mensaje supera dicho límite, utilice propiedades de usuario para dividirlo en submensajes. El servidor empresarial lee las propiedades de usuario de cada submensaje para identificar y reensamblar el mensaje original. El siguiente diagrama muestra cómo el Dispositivo A divide un único mensaje en el Mensaje A y el Mensaje B. Para obtener más información, consulte Server-side subscription.
Reenvío de mensajes
Utilice una propiedad de usuario para etiquetar un mensaje con su tipo y destino previsto. El motor de reglas lee dicha etiqueta y reenvía el mensaje en consecuencia. El siguiente diagrama ilustra cómo establecer el parámetro UserProperty para que los mensajes del Dispositivo A se enruten a diferentes destinos según el tipo de mensaje. Para obtener más información, consulte Descripción general.
