En esta página

QMqttSubscription Class

La clase QMqttSubscription recibe notificaciones de un broker MQTT sobre un tema específico. Más información...

Encabezado: #include <QMqttSubscription>
CMake: find_package(Qt6 REQUIRED COMPONENTS Mqtt)
target_link_libraries(mytarget PRIVATE Qt6::Mqtt)
qmake: QT += mqtt
Heredado de: QObject

Tipos públicos

enum SubscriptionState { Unsubscribed, SubscriptionPending, Subscribed, UnsubscriptionPending, Error }

Propiedades

Funciones públicas

virtual ~QMqttSubscription() override
bool isSharedSubscription() const
quint8 qos() const
QString reason() const
QMqtt::ReasonCode reasonCode() const
QString sharedSubscriptionName() const
QMqttSubscription::SubscriptionState state() const
QMqttTopicFilter topic() const
QMqttUserProperties userProperties() const

Ranuras públicas

void unsubscribe()

Señales

void messageReceived(QMqttMessage msg)
void qosChanged(quint8)
void stateChanged(QMqttSubscription::SubscriptionState state)

Descripción detallada

Documentación sobre los tipos de miembros

enum QMqttSubscription::SubscriptionState

Este tipo de enumeración describe los estados que puede adoptar una suscripción.

ConstanteValorDescripción
QMqttSubscription::Unsubscribed0Se ha cancelado la suscripción al tema.
QMqttSubscription::SubscriptionPending1Se ha enviado una solicitud de suscripción, pero el broker aún no la ha confirmado.
QMqttSubscription::Subscribed2La suscripción se ha realizado correctamente y se recibirán mensajes.
QMqttSubscription::UnsubscriptionPending3Se ha enviado una solicitud para darse de baja de un tema, pero el broker aún no la ha confirmado.
QMqttSubscription::Error4Se ha producido un error.

Documentación de propiedades

[read-only] qos : quint8

Esta propiedad indica el nivel de calidad de servicio (QoS) al que se ha realizado la suscripción.

El nivel de QoS de la suscripción especifica el nivel máximo de QoS al que el cliente recibirá mensajes. El editor puede seguir enviando mensajes a un nivel inferior.

Funciones de acceso:

quint8 qos() const

Señal de notificación:

void qosChanged(quint8)

[read-only] reason : QString

Esta propiedad contiene la cadena de motivo de la suscripción.

El servidor utiliza una cadena de motivo para proporcionar información adicional sobre la suscripción. Su envío por parte del servidor es opcional.

Funciones de acceso:

QString reason() const

[read-only] reasonCode : QMqtt::ReasonCode

Esta propiedad contiene el código de motivo de la suscripción.

El código de motivo especifica el tipo de error si una suscripción ha fallado, o el nivel de calidad de servicio (QoS) en caso de éxito.

Funciones de acceso:

QMqtt::ReasonCode reasonCode() const

[read-only] sharedSubscription : bool

Esta propiedad indica si la suscripción es compartida.

Funciones de acceso:

bool isSharedSubscription() const

[read-only] sharedSubscriptionName : QString

Esta propiedad contiene el nombre de la suscripción compartida.

Funciones de acceso:

QString sharedSubscriptionName() const

[read-only] state : SubscriptionState

Esta propiedad contiene el estado de la suscripción.

Funciones de acceso:

QMqttSubscription::SubscriptionState state() const

Señal de notificador:

void stateChanged(QMqttSubscription::SubscriptionState state)

[read-only] topic : QMqttTopicFilter

Esta propiedad contiene el tema de la suscripción.

Funciones de acceso:

QMqttTopicFilter topic() const

Documentación de funciones de miembro

[override virtual noexcept] QMqttSubscription::~QMqttSubscription()

Elimina una suscripción. Si aún no se había cancelado la suscripción a topic, esta se cancelará automáticamente.

[signal] void QMqttSubscription::messageReceived(QMqttMessage msg)

Esta señal se emite cuando se ha recibido el nuevo mensaje « msg ».

[slot] void QMqttSubscription::unsubscribe()

Se da de baja de topic.

Nota: Esto podría afectar a todas las instancias de punteros compartidos devueltas por QMqttClient::subscribe().

QMqttUserProperties QMqttSubscription::userProperties() const

Devuelve las propiedades del usuario recibidas del bróker una vez aceptada la suscripción.

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

© 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.