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) |
Documentación sobre los tipos de miembros
enum QMqttSubscription::SubscriptionState
Este tipo de enumeración describe los estados que puede adoptar una suscripción.
| Constante | Valor | Descripción |
|---|---|---|
QMqttSubscription::Unsubscribed | 0 | Se ha cancelado la suscripción al tema. |
QMqttSubscription::SubscriptionPending | 1 | Se ha enviado una solicitud de suscripción, pero el broker aún no la ha confirmado. |
QMqttSubscription::Subscribed | 2 | La suscripción se ha realizado correctamente y se recibirán mensajes. |
QMqttSubscription::UnsubscriptionPending | 3 | Se ha enviado una solicitud para darse de baja de un tema, pero el broker aún no la ha confirmado. |
QMqttSubscription::Error | 4 | Se 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.