QMqttSubscription Class
Die Klasse „QMqttSubscription“ empfängt Benachrichtigungen von einem MQTT-Broker zu einem bestimmten Thema. Mehr...
| Header: | #include <QMqttSubscription> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Mqtt) target_link_libraries(mytarget PRIVATE Qt6::Mqtt) |
| qmake: | QT += mqtt |
| Erbt von: | QObject |
Öffentliche Typen
| enum | SubscriptionState { Unsubscribed, SubscriptionPending, Subscribed, UnsubscriptionPending, Error } |
Eigenschaften
|
|
Öffentliche Funktionen
| 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 |
Öffentliche Slots
| void | unsubscribe() |
Signale
| void | messageReceived(QMqttMessage msg) |
| void | qosChanged(quint8) |
| void | stateChanged(QMqttSubscription::SubscriptionState state) |
Dokumentation zu Mitgliedstypen
enum QMqttSubscription::SubscriptionState
Dieser Enum-Typ beschreibt die Zustände, die ein Abonnement annehmen kann.
| Konstante | Wert | Beschreibung |
|---|---|---|
QMqttSubscription::Unsubscribed | 0 | Das Abonnement für das Thema wurde gekündigt. |
QMqttSubscription::SubscriptionPending | 1 | Eine Abonnementanfrage wurde gesendet, aber noch nicht vom Broker bestätigt. |
QMqttSubscription::Subscribed | 2 | Das Abonnement wurde erfolgreich eingerichtet und Nachrichten werden empfangen. |
QMqttSubscription::UnsubscriptionPending | 3 | Eine Anfrage zum Abmelden von einem Thema wurde gesendet, wurde jedoch noch nicht vom Broker bestätigt. |
QMqttSubscription::Error | 4 | Es ist ein Fehler aufgetreten. |
Dokumentation zu Eigenschaften
[read-only] qos : quint8
Diese Eigenschaft gibt die QoS-Stufe an, auf der das Abonnement abgeschlossen wurde.
Die QoS-Stufe des Abonnements legt die maximale QoS-Stufe fest, auf der der Client Nachrichten empfängt. Der Publisher kann weiterhin Nachrichten auf einer niedrigeren Stufe senden.
Zugriffsfunktionen:
| quint8 | qos() const |
Benachrichtigungssignal:
| void | qosChanged(quint8) |
[read-only] reason : QString
Diese Eigenschaft enthält die Begründungszeichenfolge für das Abonnement.
Eine Begründungszeichenfolge wird vom Server verwendet, um zusätzliche Informationen zum Abonnement bereitzustellen. Das Senden dieser Zeichenfolge ist für den Server optional.
Zugriffsfunktionen:
| QString | reason() const |
[read-only] reasonCode : QMqtt::ReasonCode
Diese Eigenschaft enthält den Grundcode für das Abonnement.
Der Grundcode gibt die Fehlerart an, wenn ein Abonnement fehlgeschlagen ist, oder die QoS-Stufe bei erfolgreichem Abschluss.
Zugriffsfunktionen:
| QMqtt::ReasonCode | reasonCode() const |
[read-only] sharedSubscription : bool
Diese Eigenschaft gibt an, ob das Abonnement gemeinsam genutzt wird.
Zugriffsfunktionen:
| bool | isSharedSubscription() const |
[read-only] sharedSubscriptionName : QString
Diese Eigenschaft enthält den Namen des gemeinsamen Abonnements.
Zugriffsfunktionen:
| QString | sharedSubscriptionName() const |
[read-only] state : SubscriptionState
Diese Eigenschaft enthält den Status des Abonnements.
Zugriffsfunktionen:
| QMqttSubscription::SubscriptionState | state() const |
Benachrichtigungssignal:
| void | stateChanged(QMqttSubscription::SubscriptionState state) |
[read-only] topic : QMqttTopicFilter
Diese Eigenschaft enthält das Thema des Abonnements.
Zugriffsfunktionen:
| QMqttTopicFilter | topic() const |
Dokumentation zu den Member-Funktionen
[override virtual noexcept] QMqttSubscription::~QMqttSubscription()
Löscht ein Abonnement. Falls das Abonnement „ topic “ noch nicht gekündigt wurde, wird es automatisch gekündigt.
[signal] void QMqttSubscription::messageReceived(QMqttMessage msg)
Dieses Signal wird ausgegeben, wenn die neue Nachricht „ msg “ empfangen wurde.
[slot] void QMqttSubscription::unsubscribe()
Hebt das Abonnement von topic auf.
Hinweis: Dies kann sich auf alle von QMqttClient::subscribe() zurückgegebenen Shared-Pointer-Instanzen auswirken.
QMqttUserProperties QMqttSubscription::userProperties() const
Gibt die vom Broker empfangenen Benutzereigenschaften zurück, sobald das Abonnement akzeptiert wurde.
Hinweis: Diese Funktion liefert nur dann gültige Daten, wenn der Client „ QMqttClient::MQTT_5_0 “ als „ QMqttClient::ProtocolVersion “ angibt.
© 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.
