QMqtt Namespace
Contient divers identifiants utilisés dans le module Qt MQTT. Plus...
| En-tête : | #include <QMqtt> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Mqtt)target_link_libraries(mytarget PRIVATE Qt6::Mqtt) |
| qmake : | QT += mqtt |
Types
| enum class | MessageStatus { Unknown, Published, Acknowledged, Received, Released, Completed } |
| enum class | PayloadFormatIndicator { Unspecified, UTF8Encoded } |
| enum class | ReasonCode { Success, SubscriptionQoSLevel0, SubscriptionQoSLevel1, SubscriptionQoSLevel2, NoMatchingSubscriber, …, WildCardSubscriptionsNotSupported } |
Documentation des types
enum class QMqtt::MessageStatus
Ce type d'énumération spécifie les états disponibles d'un message. En fonction de la qualité de service et du rôle du client, différents états de message sont attendus.
| Constante | Valeur | Description de l'état |
|---|---|---|
QMqtt::MessageStatus::Unknown | 0 | L'état du message est inconnu. |
QMqtt::MessageStatus::Published | 1 | Le client a reçu un message pour l'un de ses abonnements. Ceci s'applique aux niveaux de qualité de service 1 et 2. |
QMqtt::MessageStatus::Acknowledged | 2 | Un message a fait l'objet d'un accusé de réception. Ceci s'applique au niveau de qualité de service 1 et indique que le traitement du message est terminé du côté du client. |
QMqtt::MessageStatus::Received | 3 | Un message a été reçu. Ceci s'applique au niveau de qualité de service 2. |
QMqtt::MessageStatus::Released | 4 | Un message a été libéré. Ceci s'applique à la qualité de service 2. Pour un éditeur, le traitement du message est terminé. |
QMqtt::MessageStatus::Completed | 5 | Un message a été achevé. Ceci s'applique à la qualité de service 2 et indique que le traitement des messages est terminé du côté du client. |
enum class QMqtt::PayloadFormatIndicator
Le format de la charge utile fournit des informations sur le contenu d'un message. Cela peut aider d'autres clients à traiter le message plus rapidement.
| Constante | Valeur | Description du format |
|---|---|---|
QMqtt::PayloadFormatIndicator::Unspecified | 0 | Le format n'est pas spécifié. |
QMqtt::PayloadFormatIndicator::UTF8Encoded | 1 | La charge utile du message est formatée en tant que données de caractères codées en UTF-8. |
enum class QMqtt::ReasonCode
Ce type d'énumération spécifie les codes d'erreur disponibles.
| Constante | Valeur | Description de l'action |
|---|---|---|
QMqtt::ReasonCode::Success | 0 | L'action spécifiée a réussi. |
QMqtt::ReasonCode::SubscriptionQoSLevel0 | 0 | Un abonnement de niveau de qualité de service 0 a été créé. |
QMqtt::ReasonCode::SubscriptionQoSLevel1 | 0x01 | Un abonnement de niveau de qualité de service 1 a été créé. |
QMqtt::ReasonCode::SubscriptionQoSLevel2 | 0x02 | Un abonnement de niveau de qualité de service 2 a été créé. |
QMqtt::ReasonCode::NoMatchingSubscriber | 0x10 | Le message a été accepté par le serveur, mais aucun abonné ne peut recevoir ce message. Un courtier peut envoyer ce code de raison au lieu de Success. |
QMqtt::ReasonCode::NoSubscriptionExisted (since Qt 5.15) | 0x11 | Le client n'utilise pas de filtre thématique correspondant. |
QMqtt::ReasonCode::ContinueAuthentication (since Qt 5.15) | 0x18 | Poursuivre l'authentification avec une autre étape. |
QMqtt::ReasonCode::ReAuthenticate (since Qt 5.15) | 0x19 | Initier une ré-authentification. |
QMqtt::ReasonCode::UnspecifiedError | 0x80 | Une erreur non spécifiée s'est produite. |
QMqtt::ReasonCode::MalformedPacket | 0x81 | Le paquet envoyé au serveur n'est pas valide. |
QMqtt::ReasonCode::ProtocolError | 0x82 | Une erreur de protocole s'est produite. Dans la plupart des cas, le serveur déconnecte le client. |
QMqtt::ReasonCode::ImplementationSpecificError | 0x83 | Le paquet est valide, mais le destinataire le rejette. |
QMqtt::ReasonCode::UnsupportedProtocolVersion | 0x84 | La version du protocole demandée n'est pas prise en charge par le serveur. |
QMqtt::ReasonCode::InvalidClientId | 0x85 | L'identifiant du client n'est pas valide. |
QMqtt::ReasonCode::InvalidUserNameOrPassword | 0x86 | Le nom d'utilisateur ou le mot de passe spécifié n'est pas valide. |
QMqtt::ReasonCode::NotAuthorized | 0x87 | Le client n'est pas autorisé à effectuer l'action spécifiée. |
QMqtt::ReasonCode::ServerNotAvailable | 0x88 | Le serveur auquel se connecter n'est pas disponible. |
QMqtt::ReasonCode::ServerBusy | 0x89 | Le serveur auquel se connecter n'est pas disponible. Le client est invité à réessayer ultérieurement. |
QMqtt::ReasonCode::ClientBanned | 0x8A | Le client a été banni du serveur. |
QMqtt::ReasonCode::InvalidAuthenticationMethod | 0x8C | La méthode d'authentification spécifiée n'est pas valide. |
QMqtt::ReasonCode::InvalidTopicFilter | 0x8F | Le filtre de sujet spécifié n'est pas valide. |
QMqtt::ReasonCode::InvalidTopicName | 0x90 | Le nom du sujet spécifié n'est pas valide. |
QMqtt::ReasonCode::MessageIdInUse | 0x91 | L'ID du message utilisé dans le paquet précédent est déjà utilisé. |
QMqtt::ReasonCode::MessageIdNotFound | 0x92 | L'ID du message utilisé dans le paquet précédent n'a pas été trouvé. |
QMqtt::ReasonCode::PacketTooLarge | 0x95 | Le paquet reçu est trop volumineux. Voir aussi QMqttServerConnectionProperties::maximumPacketSize(). |
QMqtt::ReasonCode::QuotaExceeded | 0x97 | Une limite imposée par l'administration a été dépassée. |
QMqtt::ReasonCode::InvalidPayloadFormat | 0x99 | Le format de la charge utile n'est pas valide. Voir aussi QMqttPublishProperties::payloadFormatIndicator(). |
QMqtt::ReasonCode::RetainNotSupported | 0x9A | Le serveur ne prend pas en charge les messages conservés. Voir aussi QMqttServerConnectionProperties::retainAvailable(). |
QMqtt::ReasonCode::QoSNotSupported | 0x9B | Le niveau de qualité de service demandé n'est pas pris en charge. Voir aussi QMqttServerConnectionProperties::maximumQoS(). |
QMqtt::ReasonCode::UseAnotherServer | 0x9C | Le serveur auquel le client tente de se connecter n'est pas disponible. Voir aussi QMqttServerConnectionProperties::serverReference(). |
QMqtt::ReasonCode::ServerMoved | 0x9D | Le serveur auquel le client tente de se connecter a changé d'adresse. Voir aussi QMqttServerConnectionProperties::serverReference(). |
QMqtt::ReasonCode::SharedSubscriptionsNotSupported | 0x9E | Les abonnements partagés ne sont pas pris en charge. Voir aussi QMqttServerConnectionProperties::sharedSubscriptionSupported(). |
QMqtt::ReasonCode::ExceededConnectionRate | 0x9F | La limite du taux de connexion a été dépassée. |
QMqtt::ReasonCode::SubscriptionIdsNotSupported | 0xA1 | Les identifiants d'abonnement ne sont pas pris en charge. Voir aussi QMqttServerConnectionProperties::subscriptionIdentifierSupported(). |
QMqtt::ReasonCode::WildCardSubscriptionsNotSupported | 0xA2 | Les abonnements utilisant des caractères génériques ne sont pas pris en charge par le serveur. Voir aussi QMqttServerConnectionProperties::wildcardSupported(). |
Toutes les valeurs ne sont pas disponibles dans tous les cas d'utilisation. En particulier, certains serveurs rejetteront un code de raison qui n'est pas adapté à une commande spécifique. Le tableau ci-dessous met en évidence les codes de raison attendus pour des actions spécifiques.
| Code de raison | Propriétés de la connexion | Propriétés de l'abonnement | Propriétés du message |
|---|---|---|---|
| Réussite | X | X | X |
| AbonnementQoSLevel0 | X | ||
| AbonnementQoSLevel1 | X | ||
| AbonnementQoSLevel2 | X | ||
| NoMatchingSubscriber | X | ||
| Erreur non spécifiée | X | X | X |
| Paquet malformé | X | ||
| Erreur de protocole | X | ||
| Erreur spécifique à la mise en œuvre | X | X | X |
| Version du protocole non prise en charge | X | ||
| InvalidClientId | X | ||
| Nom d'utilisateur ou mot de passe non valide | X | ||
| NotAuthorized | X | X | X |
| Serveur non disponible | X | ||
| Serveur occupé | X | ||
| ClientBanned | X | ||
| Méthode d'authentification non valide | X | ||
| InvalidTopicFilter | X | ||
| InvalidTopicName | X | X | |
| MessageIdInUse | X | X | |
| MessageIdNotFound | X | ||
| PacketTooLarge | X | ||
| QuotaExceeded | X | X | X |
| InvalidPayloadFormat | X | X | |
| RetainNotSupported | X | ||
| QoSNotSupported | X | ||
| Utiliser un autre serveur | X | ||
| Serveur déplacé | X | ||
| Abonnements partagés non pris en charge | X | ||
| Taux de connexion dépassé | X | ||
| SubscriptionIdsNotSupported | X | ||
| WildCardSubscriptionsNotSupported (Abonnements WildCard non pris en charge) | X |
© 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.
