Saltar al contenido principal

MQTT (vista de desarrollador)

Un protocolo de mensajería publicar/suscribir. Todo se organiza en torno a temas suscritos (recepción) y temas publicados (envío); los parámetros viven en los ajustes MQTT de la solicitud.

Cómo configurarlo en la UI​

Rellena los ajustes de conexión de la solicitud MQTT:

AjusteSignificado
Client ID (clientId)La identidad de esta conexión
Lista de suscripcionesUn conjunto de temas + QoS, suscrito automáticamente tras conectar
Tema de publicaciónEl tema predeterminado al que se envían los mensajes
QoS / retain de publicaciónCalidad de servicio y marca retain al enviar
  • Comodines de tema: # coincide con varios niveles, + coincide con un solo nivel (p. ej. qr/manual/#).
  • QoS: 0 (como mucho una vez) / 1 (como mínimo una vez) / 2 (exactamente una vez).
  • El host lleva la dirección del broker, el puerto va aparte (p. ej. 127.0.0.1:18884); mqtts:// usa TLS.

Flujo principal​

Cómo usarlo​

  1. Crea una solicitud MQTT y configura clientId, suscripciones y el tema de publicación según la tabla anterior.
  2. Conectar: la sesión se suscribe automáticamente según tu configuración y recuerda el tema de publicación predeterminado.
  3. Publicar: envía contenido al tema de publicación (tema/QoS/retain se pueden cambiar por mensaje); los payloads vacíos son válidos.
  4. Recibir: los mensajes entrantes se muestran en tiempo real — tanto tus propios mensajes de loopback que coinciden con las suscripciones como otros mensajes que el broker empuja a los temas suscritos.
  5. Puedes suscribirte / cancelar la suscripción durante la sesión; cierra la sesión al terminar.

Comportamiento verificado​

Suscripción previa de qr/manual/# + publicar {"evt":"auto-sub"} en qr/manual/hello → devuelve PUBACK (QoS1 acknowledged) y llega el cuerpo del mensaje de loopback — un ciclo cerrado de envío/recepción.

Advertencias​

  • No recibes tu propia publicación: confirma que el tema de publicación coincide con una de tus suscripciones (p. ej. ambos bajo qr/manual/#).
  • Las suscripciones añadidas o retiradas en tiempo de ejecución solo duran la sesión actual — pon las suscripciones de larga vida en la configuración de la solicitud.
  • Las conexiones largas ocupan cupo y se recuperan cuando están inactivas; ciérralas tras depurar.

Relacionado: los comodines de suscripción y el QoS se explican arriba; la conexión viene de la Pre-URL mqtt del entorno (ver conceptos clave).