QMqttSubscription Class
La classe QMqttSubscription reçoit des notifications d'un courtier MQTT à propos d'un sujet spécifié. Plus d'informations...
| En-tête : | #include <QMqttSubscription> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Mqtt)target_link_libraries(mytarget PRIVATE Qt6::Mqtt) |
| qmake : | QT += mqtt |
| Héritages : | 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 des types de membres
enum QMqttSubscription::SubscriptionState
Ce type d'énumération décrit les états que peut avoir un abonnement.
| Constante | Valeur | Description |
|---|---|---|
QMqttSubscription::Unsubscribed | 0 | Le sujet a été désabonné. |
QMqttSubscription::SubscriptionPending | 1 | Une demande d'abonnement a été envoyée, mais elle n'a pas encore été confirmée par le courtier. |
QMqttSubscription::Subscribed | 2 | L'abonnement a réussi 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é contient le niveau de qualité de service auquel l'abonnement a été effectué.
Le niveau de qualité de service de l'abonnement spécifie le niveau de qualité de service maximal auquel le client recevra des messages. L'éditeur peut toujours envoyer des messages à un niveau inférieur.
Fonctions d'accès :
| quint8 | qos() const |
Signal du notificateur :
| void | qosChanged(quint8) |
[read-only] reason : QString
Cette propriété contient la chaîne de motif de l'abonnement.
La 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 de l'abonnement.
Le code de motif spécifie le type d'erreur en cas d'échec de l'abonnement ou le niveau de qualité de service en cas de succès.
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 du notificateur :
| 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 des fonctions membres
[override virtual noexcept] QMqttSubscription::~QMqttSubscription()
Supprime un abonnement. Si le site topic n'a pas déjà été 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 lorsque l'abonnement a été accepté.
Note : Cette fonction ne fournira des données valides que si le client spécifie QMqttClient::MQTT_5_0 comme étant 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.
