QMqttSubscription Class
La classe QMqttSubscription reçoit des notifications d'un courtier MQTT concernant un sujet spécifié. En savoir plus...
| En-tête : | #include <QMqttSubscription> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Mqtt) target_link_libraries(mytarget PRIVATE Qt6::Mqtt) |
| qmake : | QT += mqtt |
| Hérite de : | QObject |
Types publics
| enum | SubscriptionState { Unsubscribed, SubscriptionPending, Subscribed, UnsubscriptionPending, Error } |
Propriétés
|
|
Fonctions publiques
| 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 |
Emplacements publics
| void | unsubscribe() |
Signaux
| void | messageReceived(QMqttMessage msg) |
| void | qosChanged(quint8) |
| void | stateChanged(QMqttSubscription::SubscriptionState state) |
Documentation sur les types de membres
enum QMqttSubscription::SubscriptionState
Ce type d'énumération décrit les états possibles d'un abonnement.
| Constante | Valeur | Description |
|---|---|---|
QMqttSubscription::Unsubscribed | 0 | Le désabonnement du sujet a été effectué. |
QMqttSubscription::SubscriptionPending | 1 | Une demande d'abonnement a été envoyée, mais n'a pas encore été confirmée par le courtier. |
QMqttSubscription::Subscribed | 2 | L'abonnement a été effectué avec succès et les messages seront reçus. |
QMqttSubscription::UnsubscriptionPending | 3 | Une demande de désabonnement d’un sujet a été envoyée, mais elle n’a pas encore été confirmée par le courtier. |
QMqttSubscription::Error | 4 | Une erreur s'est produite. |
Documentation sur les propriétés
[read-only] qos : quint8
Cette propriété indique le niveau de qualité de service (QoS) auquel l'abonnement a été souscrit.
Le niveau de qualité de service (QoS) de l'abonnement spécifie le niveau maximal de qualité de service auquel le client recevra les messages. L'éditeur peut toutefois envoyer des messages à un niveau inférieur.
Fonctions d'accès :
| quint8 | qos() const |
Signal de notification :
| void | qosChanged(quint8) |
[read-only] reason : QString
Cette propriété contient la chaîne de motif relative à l'abonnement.
Une chaîne de motif est utilisée par le serveur pour fournir des informations supplémentaires sur l'abonnement. Son envoi par le serveur est facultatif.
Fonctions d'accès :
| QString | reason() const |
[read-only] reasonCode : QMqtt::ReasonCode
Cette propriété contient le code de motif correspondant à l'abonnement.
Le code de motif précise le type d'erreur en cas d'échec d'un abonnement, ou le niveau de qualité de service (QoS) en cas de réussite.
Fonctions d'accès :
| QMqtt::ReasonCode | reasonCode() const |
[read-only] sharedSubscription : bool
Cette propriété indique si l'abonnement est partagé.
Fonctions d'accès :
| bool | isSharedSubscription() const |
[read-only] sharedSubscriptionName : QString
Cette propriété contient le nom de l'abonnement partagé.
Fonctions d'accès :
| QString | sharedSubscriptionName() const |
[read-only] state : SubscriptionState
Cette propriété contient l'état de l'abonnement.
Fonctions d'accès :
| QMqttSubscription::SubscriptionState | state() const |
Signal de notification :
| void | stateChanged(QMqttSubscription::SubscriptionState state) |
[read-only] topic : QMqttTopicFilter
Cette propriété contient le sujet de l'abonnement.
Fonctions d'accès :
| QMqttTopicFilter | topic() const |
Documentation sur les fonctions membres
[override virtual noexcept] QMqttSubscription::~QMqttSubscription()
Supprime un abonnement. Si l'topic n n'était pas déjà désabonné, il le sera automatiquement.
[signal] void QMqttSubscription::messageReceived(QMqttMessage msg)
Ce signal est émis lorsque le nouveau message « msg » a été reçu.
[slot] void QMqttSubscription::unsubscribe()
Se désabonne de topic.
Remarque : cela peut affecter toutes les instances de pointeurs partagés renvoyées par QMqttClient::subscribe().
QMqttUserProperties QMqttSubscription::userProperties() const
Renvoie les propriétés de l'utilisateur reçues du courtier une fois l'abonnement accepté.
Remarque : cette fonction ne fournira des données valides que si le client spécifie QMqttClient::MQTT_5_0 comme 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.
