メインコンテンツまでスキップ

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) が返り、ループバックのメッセージボディが届きます — 送受信の閉ループ。

注意点​

  • 自分のパブリッシュが受信できない:パブリッシュトピックが自分の購読の1つと一致しているか確認します(例:両方とも qr/manual/# 配下)。
  • セッション中に追加/解除した購読は現在のセッション限りです — 長期的な購読はリクエストの設定に置きます。
  • 長時間接続はクォータを占有し、アイドル時は回収されます。デバッグ後は閉じてください。

関連:購読ワイルドカードとQoSは上で説明済み。接続は環境の mqtt Pre-URLから来ます(concepts 参照)。