QMqttSubscription Class
La clase QMqttSubscription recibe notificaciones de un broker MQTT sobre un tema especificado. Más...
| Cabecera: | #include <QMqttSubscription> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Mqtt)target_link_libraries(mytarget PRIVATE Qt6::Mqtt) |
| qmake: | QT += mqtt |
| Hereda: | 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 de los tipos de miembros
enum QMqttSubscription::SubscriptionState
Este tipo enum describe los estados que puede tener 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 aún no ha sido confirmada por el agente. |
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 aún no ha sido confirmada por el agente. |
QMqttSubscription::Error | 4 | Se ha producido un error. |
Documentación de propiedades
[read-only] qos : quint8
Esta propiedad contiene el nivel de 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 del notificador:
| void | qosChanged(quint8) |
[read-only] reason : QString
Esta propiedad contiene la cadena de motivo de la suscripción.
El servidor utiliza la cadena de motivo para proporcionar información adicional sobre la suscripción. Es opcional que el servidor la envíe.
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 la suscripción ha fallado, o el nivel de calidad de servicio 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 del 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 miembro
[override virtual noexcept] QMqttSubscription::~QMqttSubscription()
Elimina una suscripción. Si aún no se había dado de baja de topic, se dará de baja 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 puntero compartido devueltas por QMqttClient::subscribe().
QMqttUserProperties QMqttSubscription::userProperties() const
Devuelve las propiedades de usuario recibidas del intermediario cuando se ha aceptado la suscripción.
Nota: Esta función sólo 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.
