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를 사용합니다.
핵심 흐름
사용법
- MQTT 요청을 만들고 위 표대로 clientId, 구독, 퍼블리시 토픽을 설정합니다.
- 연결: 세션이 설정대로 자동 구독하고, 기본 퍼블리시 토픽을 기억합니다.
- 퍼블리시: 퍼블리시 토픽으로 내용을 보냅니다(topic/QoS/retain은 메시지마다 변경 가능); 빈 페이로드도 유효합니다.
- 수신: 들어오는 메시지는 실시간 표시 — 자신의 루프백 메시지가 구독에 히트한 것도, 브로커가 구독 토픽에 푸시하는 다른 메시지도.
- 세션 중에도 구독 / 구독 해제할 수 있습니다. 끝나면 세션을 닫습니다.
검증된 동작
사전 구독 qr/manual/# + qr/manual/hello에 {"evt":"auto-sub"} 퍼블리시 → PUBACK (QoS1 acknowledged)이 돌아오고, 루프백 메시지 본문이 도착합니다 — 송수신 클로즈드 루프.
주의 사항
- 자신의 퍼블리시가 수신되지 않음: 퍼블 리시 토픽이 자신의 구독 중 하나와 일치하는지 확인합니다(예: 둘 다
qr/manual/#아래). - 세션 중 추가/해제한 구독은 현재 세션에 한합니다 — 장기 구독은 요청 설정에 둡니다.
- 장기 접속은 쿼터를 점유하고, 아이들 시 회수됩니다. 디버깅 후에는 닫아 주세요.
관련: 구독 와일드카드와 QoS는 위에서 설명했습니다. 연결은 환경의 mqtt Pre-URL에서 옵니다(concepts 참조).