본문으로 건너뛰기

MQTT (개발자 관점)

publish/subscribe 방식의 메시징 프로토콜입니다. 모든 것이 구독 토픽(수신)과 퍼블리시 토픽(전송)을 축으로 정리되고, 파라미터는 요청의 MQTT 설정에 둡니다.

UI 설정 방법​

MQTT 요청의 연결 설정을 입력합니다:

설정의미
Client ID (clientId)이 연결의 식별자
구독 목록토픽 + QoS 세트. 연결 후 자동 구독됨
퍼블리시 토픽메시지 전송의 기본 토픽
퍼블리시 QoS / retain전송 시의 QoS와 retain 플래그
  • 토픽 와일드카드: #은 여러 레벨, +는 1레벨에 매칭됩니다(예: qr/manual/#).
  • QoS: 0(최대 1회) / 1(최소 1회) / 2(정확히 1회).
  • host에 브로커 주소를 넣고, port는 별도 필드입니다(예: 127.0.0.1:18884); mqtts://는 TLS를 사용합니다.

핵심 흐름​

사용법​

  1. MQTT 요청을 만들고 위 표대로 clientId, 구독, 퍼블리시 토픽을 설정합니다.
  2. 연결: 세션이 설정대로 자동 구독하고, 기본 퍼블리시 토픽을 기억합니다.
  3. 퍼블리시: 퍼블리시 토픽으로 내용을 보냅니다(topic/QoS/retain은 메시지마다 변경 가능); 빈 페이로드도 유효합니다.
  4. 수신: 들어오는 메시지는 실시간 표시 — 자신의 루프백 메시지가 구독에 히트한 것도, 브로커가 구독 토픽에 푸시하는 다른 메시지도.
  5. 세션 중에도 구독 / 구독 해제할 수 있습니다. 끝나면 세션을 닫습니다.

검증된 동작​

사전 구독 qr/manual/# + qr/manual/hello에 {"evt":"auto-sub"} 퍼블리시 → PUBACK (QoS1 acknowledged)이 돌아오고, 루프백 메시지 본문이 도착합니다 — 송수신 클로즈드 루프.

주의 사항​

  • 자신의 퍼블리시가 수신되지 않음: 퍼블리시 토픽이 자신의 구독 중 하나와 일치하는지 확인합니다(예: 둘 다 qr/manual/# 아래).
  • 세션 중 추가/해제한 구독은 현재 세션에 한합니다 — 장기 구독은 요청 설정에 둡니다.
  • 장기 접속은 쿼터를 점유하고, 아이들 시 회수됩니다. 디버깅 후에는 닫아 주세요.

관련: 구독 와일드카드와 QoS는 위에서 설명했습니다. 연결은 환경의 mqtt Pre-URL에서 옵니다(concepts 참조).