QMqttMessage Class
La clase `QMqttMessage` proporciona información sobre un mensaje recibido de un intermediario de mensajes en base a una suscripción. Más información...
| Encabezado: | #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 ya se ha enviado anteriormente, pero aún no se ha confirmado. Por lo tanto, el bróker asume que debe reenviarlo para verificar el transporte del propio mensaje. Los mensajes duplicados solo pueden producirse si el nivel de QoS 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 mensajes con un nivel de QoS 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 (QoS) de un mensaje.
Funciones de acceso:
| quint8 | qos() const |
[read-only] retain : const bool
Esta propiedad indica si el mensaje se ha conservado.
Un mensaje retenido se conserva en el broker para que los futuros clientes puedan suscribirse a él. Por lo tanto, un mensaje retenido se ha creado previamente y no es una actualización en tiempo real. Un broker solo puede almacenar un mensaje retenido por tema.
Funciones de acceso:
| bool | retain() const |
[read-only] topic : const QMqttTopicName
Esta propiedad contiene el tema de un mensaje.
En caso de que se haya utilizado un comodín para una suscripción, describe el tema que coincide con dicha suscripción. Esta propiedad nunca contiene comodines.
Funciones de acceso:
| QMqttTopicName | topic() const |
Documentación de funciones de miembro
QMqttMessage::QMqttMessage()
Crea un nuevo mensaje MQTT.
QMqttMessage::QMqttMessage(const QMqttMessage &other)
Crea 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 solo 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 libera un mensaje. Estas se pueden obtener mediante la señal « QMqttClient::messageStatusChanged ».
Nota: Esta función solo 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 coinciden; en caso contrario, devuelve « false ».
QMqttMessage &QMqttMessage::operator=(const QMqttMessage &other)
Convierte este objeto en 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.