En esta página

QMqttMessage Class

La clase QMqttMessage proporciona información sobre un mensaje recibido de un agente de mensajes basado en una suscripción. Más...

Cabecera: #include <QMqttMessage>
CMake: find_package(Qt6 REQUIRED COMPONENTS Mqtt)
target_link_libraries(mytarget PRIVATE Qt6::Mqtt)
qmake: QT += mqtt

Propiedades

Funciones públicas

QMqttMessage()
QMqttMessage(const QMqttMessage &other)
bool duplicate() const
quint16 id() const
const QByteArray &payload() const
QMqttPublishProperties publishProperties() const
quint8 qos() const
bool retain() const
QMqttTopicName topic() const
bool operator!=(const QMqttMessage &other) const
QMqttMessage &operator=(const QMqttMessage &other)
bool operator==(const QMqttMessage &other) const

Descripción detallada

Se crea un mensaje MQTT dentro del módulo y se devuelve a través de la señal QMqttSubscription::messageReceived().

Documentación de Propiedades

[read-only] duplicate : const bool

Esta propiedad indica si el mensaje es un duplicado.

Los mensajes duplicados indican que el mensaje ha sido enviado anteriormente, pero aún no ha sido confirmado. Por lo tanto, el broker asume que necesita reenviar para verificar el transporte del propio mensaje. Los mensajes duplicados sólo pueden producirse si el nivel de calidad de servicio es uno o dos.

Funciones de acceso:

bool duplicate() const

[read-only] id : const quint16

Esta propiedad contiene el ID del mensaje.

Los ID se utilizan para los mensajes con un nivel de calidad de servicio superior a cero.

Funciones de acceso:

quint16 id() const

[read-only] payload : const QByteArray

Esta propiedad contiene la carga útil de un mensaje.

Funciones de acceso:

const QByteArray &payload() const

[read-only] qos : const quint8

Esta propiedad contiene el nivel de calidad de servicio de un mensaje.

Funciones de acceso:

quint8 qos() const

[read-only] retain : const bool

Esta propiedad indica si el mensaje ha sido retenido.

Un mensaje retenido se mantiene en el broker para que futuros clientes se suscriban. Por lo tanto, un mensaje retenido ha sido creado previamente y no es una actualización en vivo. Un agente sólo puede almacenar un mensaje retenido por tema.

Funciones de acceso:

bool retain() const

[read-only] topic : const QMqttTopicName

Esta propiedad contiene el asunto de un mensaje.

En caso de que se haya utilizado un comodín para una suscripción, describe el asunto que coincide con esta suscripción. Esta propiedad nunca contiene comodines.

Funciones de acceso:

QMqttTopicName topic() const

Documentación de funciones miembro

QMqttMessage::QMqttMessage()

Crea un nuevo mensaje MQTT.

QMqttMessage::QMqttMessage(const QMqttMessage &other)

Construye un nuevo mensaje MQTT que es una copia de other.

QMqttPublishProperties QMqttMessage::publishProperties() const

Devuelve las propiedades de publicación recibidas como parte del mensaje.

Nota: Esta función sólo especifica las propiedades cuando se recibe un mensaje de publicación. Los mensajes con un valor de QoS de 1 o 2 pueden contener propiedades adicionales cuando se publica un mensaje. Éstas pueden obtenerse mediante la señal QMqttClient::messageStatusChanged.

Nota: Esta función sólo proporcionará datos válidos cuando el cliente especifique QMqttClient::MQTT_5_0 como QMqttClient::ProtocolVersion.

bool QMqttMessage::operator!=(const QMqttMessage &other) const

Devuelve true si el mensaje y other no son iguales, en caso contrario devuelve false.

QMqttMessage &QMqttMessage::operator=(const QMqttMessage &other)

Hace de este objeto una copia de other y devuelve el nuevo valor de este objeto.

bool QMqttMessage::operator==(const QMqttMessage &other) const

Devuelve true si el mensaje y other son iguales, en caso contrario devuelve false.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.