# MQTT Will Message

EMQXはMQTTのwill message機能を実装しています。クライアントにwill messageが設定されている場合、クライアントが予期せず切断されると、EMQXは関連するサブスクライバーにそのメッセージを送信し、サブスクライバーがクライアントの状態を把握・更新できるようにします。

EMQXでこのメッセージングサービスを試すには、クライアントツールを使用できます。本節では、[MQTTX Desktop](https://mqttx.app/)と[MQTTX CLI](https://mqttx.app/cli)を使ってクライアントをシミュレートし、will messageがどのようにパブリッシュされ受信されるかを紹介します。

:::tip 前提条件

- MQTTの[Will Message](./mqtt-concepts.md#will-message)に関する知識
- [MQTTX](./publish-and-subscribe.md)を使った基本的なパブリッシュおよびサブスクライブ操作

:::

## MQTTX DesktopでWill Messageをパブリッシュする

1. EMQXとMQTTX Desktopを起動します。**New Connection**をクリックして、パブリッシャーとしてクライアント接続を作成します。

   - **Name**欄に`Demo`と入力します。
   - **Host**にlocalhostの`127.0.0.1`を入力します（本デモの例として）。
   - 他の設定はデフォルトのままにして、**Connect**をクリックします。

   ::: tip

   MQTT接続の作成に関する詳細な手順は[MQTTX Desktop](./publish-and-subscribe.md#mqttx-desktop)で紹介しています。

   :::

   <img src="./assets/Configure-new-connection-general.png" alt="新しい接続の一般設定" style="zoom:35%;" />

   ページをスクロールダウンし、**Last Will and Testament**セクションでwill messageの設定を入力します。

   - **Last-Will Topic**：`offline`と入力します。
   - **Last-Will QoS**：デフォルトの`0`に設定します。
   - **Last-Will Retain**：デフォルトで無効のままにします。有効にするとwill messageもリテインドメッセージになります。
   - **Last-Will Payload**：`I'm offline`と入力します。
   - **Will Delay Intervals (s)**：`5`秒に設定します。

   他の設定はデフォルトのままにして、**Connect**ボタンをクリックします。

   <img src="./assets/Configure-new-connection-will.png" alt="will messageの設定" style="zoom:35%;" />

2. **Connections**ペインで**+** -> **New Connection**をクリックし、新しいクライアント接続を作成します。接続の**Name**を`Subscriber`、**Host**を`127.0.0.1`に設定します。他はデフォルトのままにして**Connect**をクリックします。

3. **Subscriber**ペインで**New Subscription**をクリックします。**Topic**テキストボックスに`offline`と入力し、他の設定はデフォルトのままにして**Confirm**をクリックします。

   <img src="./assets/Subscribe-will-message.png" alt="will messageのサブスクライブ" style="zoom:35%;" />

4. **Connections**ペインで`Demo`という名前のクライアント接続を選択し、右クリックして**New Window**を選びます。新しいウィンドウで**Connect**ボタンをクリックします。

   <img src="./assets/Open-new-window.png" alt="新しいウィンドウを開く" style="zoom:35%;" />

5. 新しいウィンドウを閉じて5秒待ちます。`Subscriber`クライアントがwill messageの`I'm offline`を受信します。

   <img src="./assets/Receive-will-message.png" alt="will messageの受信" style="zoom:35%;" />



## MQTTX CLIでWill Messageをパブリッシュする

1. 1つのクライアントで接続要求を開始します。トピックを`t/1`、ペイロードを`A will message from MQTTX CLI`に設定します：

   ```bash
   $ mqttx conn -h 'localhost' -p 1883 --will-topic 't/1' --will-message 'A will message from MQTTX CLI'
   Connected
   ```

2. 別のクライアントでトピック`t/1`をサブスクライブし、will messageを受信できるようにします：

   ```bash
   mqttx sub -t 't/1' -h 'localhost' -p 1883 -v
   ```

3. ステップ1で指定したクライアントを切断すると、ステップ2で指定したクライアントがwill messageを受信します：

   ```bash
   topic:  t/1
   payload:  A will message from MQTTX CLI
   ```