MQTT (Entwicklersicht)
Ein Publish/Subscribe-Messaging-Protokoll. Alles dreht sich um abonnierte Topics (Empfangen) und veröffentlichte Topics (Senden); die Parameter liegen in den MQTT-Einstellungen des Requests.
Konfiguration in der UI
Verbindungseinstellungen des MQTT-Requests ausfüllen:
| Einstellung | Bedeutung |
|---|---|
| Client ID (clientId) | Identität dieser Verbindung |
| Abonnementliste | Ein Satz aus Topics + QoS, wird nach dem Verbinden automatisch abonniert |
| Publish-Topic | Das Standard-Topic, an das Nachrichten gesendet werden |
| Publish QoS / retain | Quality of Service und Retain-Flag beim Senden |
- Topic-Wildcards:
#matcht mehrere Ebenen,+matcht eine einzelne Ebene (z. B.qr/manual/#). - QoS: 0 (höchstens einmal) / 1 (mindestens einmal) / 2 (genau einmal).
- Host trägt die Broker-Adresse, der Port ist separat (z. B.
127.0.0.1:18884);mqtts://nutzt TLS.
Kernablauf
Nutzung
- MQTT-Request anlegen und clientId, Abonnements sowie Publish-Topic gemäß der Tabelle oben konfigurieren.
- Verbinden: Die Sitzung abonniert gemäß Ihrer Konfiguration automatisch und merkt sich das Standard-Publish-Topic.
- Veröffentlichen: Inhalt an das Publish-Topic senden (Topic/QoS/retain lassen sich pro Nachricht ändern); leere Payloads sind gültig.
- Empfangen: Eingehende Nachrichten erscheinen in Echtzeit — sowohl eigene Loopback-Nachrichten, die auf Abonnements treffen, als auch andere Nachrichten, die der Broker an abonnierte Topics pusht.
- Während der Sitzung können Sie abonnieren / Abonnement beenden; schließen Sie die Sitzung, wenn Sie fertig sind.
Verifiziertes Verhalten
Vorab abonniertes qr/manual/# + Veröffentlichen von {"evt":"auto-sub"} an qr/manual/hello → liefert PUBACK (QoS1 acknowledged) und der Loopback-Nachrichtenbody kommt an — ein geschlossener Sende-/Empfangskreislauf.
Stolperfallen
- Eigene Veröffentlichung kommt nicht an: Prüfen, dass das Publish-Topic zu einem Ihrer Abonnements passt (z. B. beide unter
qr/manual/#). - Zur Laufzeit hinzugefügte oder entfernte Abonnements gelten nur für die aktuelle Sitzung — langlebige Abonnements gehören in die Request-Konfiguration.
- Langfristige Verbindungen belegen Kontingent und werden bei Inaktivität zurückgeholt; nach dem Debuggen schließen.
Verwandt: Abonnement-Wildcards und QoS sind oben erklärt; die Verbindung kommt aus der mqtt-Pre-URL der Umgebung (siehe Kernkonzepte).