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) が返り、ループバックのメッセージボディが届きます — 送受信の閉ループ。
注意点
- 自分のパブリッシュが受信できない:パブリッシュトピックが自分の購読の1つと一致しているか確認します(例:両方とも
qr/manual/#配下)。 - セッション中に追加/解除した購読は現在のセッション限りです — 長期的な購読はリクエストの設定に置きます。
- 長時間接続はクォータを占有し、アイドル時は回収されます。デバッグ後は閉じてください。
関連:購読ワイルドカードとQoSは上で説明済み。接続は環境の mqtt Pre-URLから来ます(concepts 参照)。