Chuyển tới nội dung chính

MQTT (Góc nhìn nhà phát triển)

Giao thức nhắn tin publish/subscribe. Mọi thứ xoay quanh chủ đề đã đăng ký (nhận) và chủ đề phát (gửi); tham số nằm trong cài đặt MQTT của yêu cầu.

Cách cấu hình trong UI​

Điền các cài đặt kết nối của yêu cầu MQTT:

Cài đặtÝ nghĩa
Client ID (clientId)Danh tính của kết nối này
Danh sách đăng kýTập chủ đề + QoS, tự đăng ký sau khi kết nối
Chủ đề phátChủ đề mặc định mà tin nhắn được gửi tới
QoS / retain khi phátMức dịch vụ và cờ retain khi gửi
  • Ký tự đại diện chủ đề: # khớp nhiều cấp, + khớp một cấp (ví dụ qr/manual/#).
  • QoS: 0 (nhiều nhất một lần) / 1 (ít nhất một lần) / 2 (đúng một lần).
  • Host nhận địa chỉ broker, port để riêng (ví dụ 127.0.0.1:18884); mqtts:// dùng TLS.

Luồng cốt lõi​

Cách sử dụng​

  1. Tạo yêu cầu MQTT và cấu hình clientId, đăng ký và chủ đề phát theo bảng trên.
  2. Kết nối: phiên tự đăng ký theo cấu hình của bạn và ghi nhớ chủ đề phát mặc định.
  3. Phát: gửi nội dung tới chủ đề phát (chủ đề/QoS/retain có thể đổi theo từng tin nhắn); payload rỗng là hợp lệ.
  4. Nhận: tin nhắn đến hiển thị theo thời gian thực — cả tin nhắn vòng lặp của chính bạn trúng đăng ký lẫn các tin khác broker đẩy tới các chủ đề đã đăng ký.
  5. Trong phiên bạn có thể đăng ký / hủy đăng ký; đóng phiên khi xong.

Hành vi đã xác minh​

Đăng ký trước qr/manual/# + phát {"evt":"auto-sub"} tới qr/manual/hello → trả về PUBACK (QoS1 acknowledged) và thân tin nhắn vòng lặp đến — vòng gửi/nhận khép kín.

Lưu ý quan trọng​

  • Không nhận được tin bạn phát: xác nhận chủ đề phát khớp một trong các đăng ký của bạn (ví dụ cả hai dưới qr/manual/#).
  • Đăng ký thêm/xóa lúc chạy chỉ tồn tại trong phiên hiện tại — đặt đăng ký dài hạn vào cấu hình của yêu cầu.
  • Kết nối dài chiếm hạn mức và bị thu hồi khi rảnh; đóng chúng sau khi gỡ lỗi.

Liên quan: ký tự đại diện đăng ký và QoS đã giải thích ở trên; kết nối đến từ Pre-URL mqtt của môi trường (xem concepts).