Aller au contenu principal

MQTT (vue développeur)

Un protocole de messagerie publication/abonnement. Tout s'organise autour des topics abonnés (réception) et des topics publiés (envoi) ; les paramètres vivent dans les réglages MQTT de la requête.

Comment configurer dans l'interface​

Renseignez les réglages de connexion de la requête MQTT :

RéglageSignification
Client ID (clientId)Identité de cette connexion
Liste d'abonnementsUn ensemble de topics + QoS, auto-abonnés après connexion
Topic de publicationLe topic par défaut d'envoi des messages
QoS / retain de publicationQualité de service et drapeau retain à l'envoi
  • Jokers de topic : # correspond à plusieurs niveaux, + à un seul niveau (ex. qr/manual/#).
  • QoS : 0 (au plus une fois) / 1 (au moins une fois) / 2 (exactement une fois).
  • Le host porte l'adresse du broker, le port est séparé (ex. 127.0.0.1:18884) ; mqtts:// utilise TLS.

Flux principal​

Comment utiliser​

  1. Créez une requête MQTT et configurez clientId, abonnements et topic de publication selon le tableau ci-dessus.
  2. Connectez : la session s'auto-abonne selon votre configuration et retient le topic de publication par défaut.
  3. Publiez : envoyez du contenu vers le topic de publication (topic/QoS/retain modifiables par message) ; les payloads vides sont valides.
  4. Recevez : les messages entrants s'affichent en temps réel — aussi bien vos propres messages en boucle touchant vos abonnements que les autres messages que le broker pousse vers les topics abonnés.
  5. Vous pouvez vous abonner / vous désabonner pendant la session ; fermez la session une fois terminé.

Comportement vérifié​

Pré-abonné à qr/manual/# + publication de {"evt":"auto-sub"} vers qr/manual/hello → renvoie PUBACK (QoS1 acknowledged) et le corps du message en boucle arrive — une boucle envoi/réception complète.

Pièges​

  • Vous ne recevez pas votre publication : vérifiez que le topic publié correspond à l'un de vos abonnements (ex. tous deux sous qr/manual/#).
  • Les abonnements ajoutés ou retirés en cours de session ne durent que pour la session en cours — mettez les abonnements durables dans la configuration de la requête.
  • Les connexions longues occupent du quota et sont récupérées à l'inactivité ; fermez-les après le débogage.

À lire aussi : les jokers d'abonnement et le QoS sont expliqués ci-dessus ; la connexion vient de la Pre-URL mqtt de l'environnement (voir concepts).