MQTT (vista sviluppatore)
Un protocollo di messaggistica publish/subscribe. Tutto è organizzato attorno ai topic sottoscritti (ricezione) e ai topic pubblicati (invio); i parametri vivono nelle impostazioni MQTT della richiesta.
Come configurare nella UI
Riempi le impostazioni di connessione della richiesta MQTT:
| Impostazione | Significato |
|---|---|
| Client ID (clientId) | Identità di questa connessione |
| Lista sottoscrizioni | Un insieme di topic + QoS, auto-sottoscritti dopo la connessione |
| Topic di pubblicazione | Il topic predefinito a cui vengono inviati i messaggi |
| QoS di pubblicazione / retain | Qualità del servizio e flag retain quando si invia |
- Wildcard dei topic:
#corrisponde a più livelli,+a un solo livello (es.qr/manual/#). - QoS: 0 (al massimo una volta) / 1 (almeno una volta) / 2 (esattamente una volta).
- Host prende l'indirizzo del broker, la porta è separata (es.
127.0.0.1:18884);mqtts://usa TLS.
Flusso principale
Come usare
- Crea una richiesta MQTT e configura clientId, sottoscrizioni e topic di pubblicazione secondo la tabella sopra.
- Connetti: la sessione si auto-sottoscrive secondo la configurazione e ricorda il topic di pubblicazione predefinito.
- Pubblica: invia il contenuto al topic di pubblicazione (topic/QoS/retain si possono cambiare per messaggio); i payload vuoti sono validi.
- Ricevi: i messaggi in arrivo vengono mostrati in tempo reale — sia i tuoi messaggi di loopback che toccano le sottoscrizioni, sia gli altri messaggi che il broker pusha ai topic sottoscritti.
- Puoi sottoscrivere / annullare la sottoscrizione durante la sessione; chiudi la sessione quando hai finito.
Comportamento verificato
Pre-sottoscrizione di qr/manual/# + pubblicazione di {"evt":"auto-sub"} su qr/manual/hello → restituisce PUBACK (QoS1 acknowledged) e il corpo del messaggio di loopback arriva — un ciclo chiuso invio/ricezione.
Punti di attenzione
- Non ricevi la tua pubblicazione: conferma che il topic di pubblicazione corrisponda a una delle tue sottoscrizioni (es. entrambi sotto
qr/manual/#). - Le sottoscrizioni aggiunte o rimosse a runtime valgono solo per la sessione corrente — metti le sottoscrizioni di lunga durata nella configurazione della richiesta.
- Le connessioni lunghe occupano quota e vengono ritratte quando inattive; chiudile dopo il debugging.
Correlato: wildcard delle sottoscrizioni e QoS spiegati sopra; la connessione arriva dal Pre-URL mqtt dell'ambiente (vedi concepts).