遺言メッセージ機能は MQTT 3.1.1 で定義されています。IoT Platform は、デバイスを MQTT 5.0 経由で IoT Platform に接続する場合に、この機能をサポートしています。このトピックでは、遺言メッセージについて説明します。
背景情報
遺言メッセージ
遺言メッセージは、デバイスが IoT Platform に接続されたときに送信されます。デバイスが IoT Platform から切断され、遺言遅延間隔パラメーターで指定された期間内に IoT Platform に再接続できなかった場合、IoT Platform はデバイスに代わって遺言メッセージをサブスクライバーに公開します。遺言遅延間隔パラメーターのデフォルト値は 0 です。
遺言メッセージの内容は、デバイスから送信される一般的なメッセージの内容と似ています。内容は、トピック名、ペイロード、QoS レベル、保持タグ、ユーザー プロパティ、およびメッセージの有効期限間隔を含みます。
デバイスは、次の原因によりサーバーから切断される可能性があります。
ネットワーク障害または変動。デバイスが指定された接続永続期間内にサーバーと通信しない場合、サーバーは接続を閉じます。
デバイスで停電が発生します。サーバーは、接続が閉じていることを識別します。
デバイスが不正な操作を実行しようとすると、サーバーによって接続が閉じられます。たとえば、デバイスが権限のないトピックをサブスクライブしようとします。
デバイスの遺言メッセージは、次のシナリオで削除されます。
デバイスが想定どおりに切断された後、遺言メッセージは削除されます。
デバイスが予期せず切断され、IoT Platform がデバイスに代わって遺言メッセージを公開した後、遺言メッセージは削除されます。
遺言メッセージのメッセージ有効期限間隔パラメーターを設定しない場合、遺言メッセージは有効期限が切れた後に削除されます。
遺言メッセージを更新することはできません。
期限切れのセッションは、遺言メッセージに影響しません。遺言メッセージは、セッションのステータスに関係なく公開できます。
遺言メッセージは、メッセージの有効期限機能をサポートしています。温度制御関連のメッセージなど、メッセージの内容が一定期間で期限切れになる場合は、遺言メッセージ機能とメッセージの有効期限機能を一緒に使用します。詳細については、「メッセージの有効期限」をご参照ください。
ネットワーク信号が弱い場合、またはネットワーク接続が不安定な場合は、
WillDelayIntervalパラメーターを設定することをお勧めします。これにより、デバイスが頻繁に接続および切断されるために遺言メッセージが頻繁にプッシュされるのを防ぎます。
シナリオ
デバイス例外分析
IoT Platform に接続されているデバイスのステータスが、オンラインまたはオフラインになるなど、変化した場合、IoT Platform は次の topic: /as/mqtt/status/${productKey}/${deviceName} を使用して、デバイス ステータス関連のメッセージをビジネス サーバーまたはルールエンジンにプッシュします。メッセージには、デバイスの接続ステータスに関する情報のみが含まれています。デバイス例外分析のためにより多くのデータを取得する場合は、遺言メッセージを使用できます。遺言メッセージには、環境情報など、デバイスに関する情報を含めることができます。