MQTT
MQTT は、WebSocket リクエストでプロトコル mqtt を選ぶと利用できます。
| フィールド | 役割 |
|---|---|
| URL | ブローカーのアドレス（mqtt://、mqtts://、または WebSocket） |
| トピック | トピック名。イベントフィールドで指定します |
| メッセージ | パブリッシュするペイロード |
| QoS | 0、1、2 — パブリッシュ時および購読時の両方で使われます |
| 保持（retain） | メッセージをブローカーに保持されるものとしてマークします |
| クライアント識別子 | Handlebars で解決されます。空のままにすると自動生成されます |
| ユーザー / パスワード | ブローカーの認証情報。パスワードには シークレット 型の値を指定できます |
| キープアライブ | 秒単位 |
| トピックを購読 | 既定で有効です。接続時に Restorm がリクエストのトピックを購読します |
トピックでは {{variables}} を使えます。capteurs/{{site}}/{{capteurId}} はまったく問題のないトピックです。
Will メッセージ（Last Will and Testament）
Section titled “Will メッセージ（Last Will and Testament）”4 つのフィールドで、クライアントが突然消えた場合にブローカーがパブリッシュするメッセージを宣言します。 Will メッセージのトピック、ペイロード、QoS、保持です。
不正な切断に対するシステムの挙動をテストするには、これがまさに必要な機能です。 Will メッセージを設定し、接続を切って、購読側が反応することを確認してください。
MQTT クライアントは自動的に再接続を試み、上限は10 回です。
シナリオでの利用
Section titled “シナリオでの利用”MQTT 接続（リクエストのトピックを購読し、受信したメッセージごとにイベントを発行します）、 MQTT パブリッシュ（リクエストの QoS と保持設定でパブリッシュします）、 MQTT 接続を閉じるがあります。 接続とストリーミングを参照してください。
サーバーモード
Section titled “サーバーモード”Restorm はローカルの MQTT ブローカーをホストできます。 ポートごとに 1 つのブローカーが、生の TCP と MQTT-over-WebSocket のゲートウェイ経由の両方でアクセスできます。 WebSocket、Socket.IO、MQTT をシミュレートするを参照してください。
AsyncAPI からインポートする
Section titled “AsyncAPI からインポートする”チャンネルがプロトコル mqtt を使う AsyncAPI ドキュメントからは、
MQTT リクエストが直接生成されます（チャンネルごとに、パブリッシュ用と購読用が 1 つずつ）。
ペイロードのサンプルはメッセージのスキーマから組み立てられます。
AsyncAPI をインポートするを参照してください。