Passa al contenuto principale

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:

ImpostazioneSignificato
Client ID (clientId)Identità di questa connessione
Lista sottoscrizioniUn insieme di topic + QoS, auto-sottoscritti dopo la connessione
Topic di pubblicazioneIl topic predefinito a cui vengono inviati i messaggi
QoS di pubblicazione / retainQualità 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​

  1. Crea una richiesta MQTT e configura clientId, sottoscrizioni e topic di pubblicazione secondo la tabella sopra.
  2. Connetti: la sessione si auto-sottoscrive secondo la configurazione e ricorda il topic di pubblicazione predefinito.
  3. Pubblica: invia il contenuto al topic di pubblicazione (topic/QoS/retain si possono cambiare per messaggio); i payload vuoti sono validi.
  4. 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.
  5. 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).