QMqtt Namespace
Contient divers identifiants utilisés dans l'ensemble du module « Qt MQTT ». En savoir plus...
| En-tête : | #include <qmqttglobal.h> |
| 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 sur les 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 (QoS) et du rôle du client, différents états de message sont attendus.
| Constante | Valeur | Description |
|---|---|---|
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. Cela s'applique aux niveaux de qualité de service (QoS) 1 et 2. |
QMqtt::MessageStatus::Acknowledged | 2 | Un message a été acquitté. Cela 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. Cela s'applique au niveau de qualité de service (QoS) 2. |
QMqtt::MessageStatus::Released | 4 | Un message a été libéré. Cela s'applique au niveau de qualité de service (QoS) 2. Pour un éditeur, le traitement du message est terminé. |
QMqtt::MessageStatus::Completed | 5 | Un message a été finalisé. Cela s'applique au niveau de qualité de service (QoS) 2 et indique que le traitement du message 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 les autres clients à traiter le message plus rapidement.
| Constante | Valeur | Description |
|---|---|---|
QMqtt::PayloadFormatIndicator::Unspecified | 0 | Le format n’est pas spécifié. |
QMqtt::PayloadFormatIndicator::UTF8Encoded | 1 | La charge utile du message est au format « Données de caractères encodées en UTF-8 ». |
enum class QMqtt::ReasonCode
Ce type d'énumération spécifie les codes d'erreur disponibles.
| Constante | Valeur | Description |
|---|---|---|
QMqtt::ReasonCode::Success | 0 | L'action spécifiée a abouti. |
QMqtt::ReasonCode::SubscriptionQoSLevel0 | 0 | Un abonnement avec un niveau de qualité de service (QoS) 0 a été créé. |
QMqtt::ReasonCode::SubscriptionQoSLevel1 | 0x01 | Un abonnement avec un niveau de qualité de service (QoS) 1 a été créé. |
QMqtt::ReasonCode::SubscriptionQoSLevel2 | 0x02 | Un abonnement avec un niveau de qualité de service (QoS) 2 a été créé. |
QMqtt::ReasonCode::NoMatchingSubscriber | 0x10 | Le message a été accepté par le serveur, mais aucun abonné n'est disponible pour le recevoir. Un courtier peut renvoyer ce code de raison à la place du code « Success ». |
QMqtt::ReasonCode::NoSubscriptionExisted (since Qt 5.15) | 0x11 | Aucun filtre de sujet correspondant n’est utilisé par le client. |
QMqtt::ReasonCode::ContinueAuthentication (since Qt 5.15) | 0x18 | Poursuivez l’authentification avec une autre étape. |
QMqtt::ReasonCode::ReAuthenticate (since Qt 5.15) | 0x19 | Lancez une nouvelle 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, cela entraîne la déconnexion du client par le serveur. |
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 indiqué 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 plus tard. |
QMqtt::ReasonCode::ClientBanned | 0x8A | Le client a été banni du serveur. |
QMqtt::ReasonCode::InvalidAuthenticationMethod | 0x8C | La méthode d'authentification indiqué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 de sujet spécifié n'est pas valide. |
QMqtt::ReasonCode::MessageIdInUse | 0x91 | L'ID de message utilisé dans le paquet précédent est déjà utilisé. |
QMqtt::ReasonCode::MessageIdNotFound | 0x92 | L'ID de message utilisé dans le paquet précédent est introuvable. |
QMqtt::ReasonCode::PacketTooLarge | 0x95 | Le paquet reçu est trop volumineux. Voir également QMqttServerConnectionProperties::maximumPacketSize(). |
QMqtt::ReasonCode::QuotaExceeded | 0x97 | Une limite imposée par l'administrateur a été dépassée. |
QMqtt::ReasonCode::InvalidPayloadFormat | 0x99 | Le format de la charge utile n'est pas valide. Voir également QMqttPublishProperties::payloadFormatIndicator(). |
QMqtt::ReasonCode::RetainNotSupported | 0x9A | Le serveur ne prend pas en charge les messages conservés. Voir également QMqttServerConnectionProperties::retainAvailable(). |
QMqtt::ReasonCode::QoSNotSupported | 0x9B | Le niveau de qualité de service (QoS) demandé n’est pas pris en charge. Voir également QMqttServerConnectionProperties::maximumQoS(). |
QMqtt::ReasonCode::UseAnotherServer | 0x9C | Le serveur auquel le client tente de se connecter n'est pas disponible. Voir également QMqttServerConnectionProperties::serverReference(). |
QMqtt::ReasonCode::ServerMoved | 0x9D | Le serveur auquel le client tente de se connecter a changé d'adresse. Voir également QMqttServerConnectionProperties::serverReference(). |
QMqtt::ReasonCode::SharedSubscriptionsNotSupported | 0x9E | Les abonnements partagés ne sont pas pris en charge. Voir également QMqttServerConnectionProperties::sharedSubscriptionSupported(). |
QMqtt::ReasonCode::ExceededConnectionRate | 0x9F | La limite de débit de connexion a été dépassée. |
QMqtt::ReasonCode::SubscriptionIdsNotSupported | 0xA1 | Les identifiants d’abonnement ne sont pas pris en charge. Voir également 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 également QMqttServerConnectionProperties::wildcardSupported(). |
Toutes les valeurs ne sont pas disponibles dans tous les cas d'utilisation. En particulier, certains serveurs rejetteront un code de raison inadapté à une commande spécifique. Consultez le tableau ci-dessous pour connaître les codes de raison attendus pour des actions spécifiques.
| Code de motif | Propriétés de connexion | Propriétés de l'abonnement | Propriétés du message |
|---|---|---|---|
| Succès | X | X | X |
| SubscriptionQoSLevel0 | X | ||
| Niveau de qualité de service de l'abonnement 1 | X | ||
| Niveau de qualité de service de l'abonnement 2 | X | ||
| Aucun abonné correspondant | X | ||
| Erreur non spécifiée | X | X | X |
| Paquet mal formé | X | ||
| Erreur de protocole | X | ||
| Erreur spécifique à l'implémentation | X | X | X |
| Version de protocole non prise en charge | X | ||
| Identifiant client non valide | X | ||
| Nom d'utilisateur ou mot de passe non valide | X | ||
| Non autorisé | X | X | X |
| Serveur indisponible | X | ||
| Serveur occupé | X | ||
| ClientBanné | X | ||
| Méthode d'authentification non valide | X | ||
| Filtre de sujet invalide | X | ||
| Nom de sujet non valide | X | X | |
| Identifiant de message déjà utilisé | X | X | |
| MessageIdNotFound | X | ||
| Paquet trop volumineux | X | ||
| Quota dépassé | X | X | X |
| Format de charge utile non valide | X | X | |
| Conservation non prise en charge | X | ||
| QoS non prise en charge | X | ||
| Utiliser un autre serveur | X | ||
| ServeurDéplacé | X | ||
| Abonnements partagés non pris en charge | X | ||
| Taux de connexion dépassé | X | ||
| Identifiants d'abonnement non pris en charge | X | ||
| Abonnements avec caractères génériques 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.
