すべてのプロダクト
Search
ドキュメントセンター

IoT Platform:メッセージの解析

最終更新日:Mar 27, 2025

IoT Platform でデバイスメッセージ用に定義されている標準データ形式は、Alink JSON です。リソースが限られていて仕様が低いデバイスや、高いネットワークスループットを必要とするデバイスは、JSON データを使用して IoT Platform と通信することはできません。この問題を解決するために、デバイスから IoT Platform に生データを渡すことができます。IoT Platform は、送信されたスクリプトに基づいて、デバイス固有の形式と JSON 形式の間でデータを変換するメッセージ解析機能を提供します。

以下のタイプのメッセージを解析できます。

  • カスタム Topic からのアップストリームメッセージ。デバイスがカスタム Topic を使用してクラウドにメッセージを送信する場合、ペイロードは JSON データに解析されます。

  • アップストリームおよびダウンストリームの Thing Specification Language(TSL)メッセージ。IoT Platform は、デバイスから送信された TSL メッセージのカスタムデータを Alink JSON データに変換し、IoT Platform から送信された Alink JSON データをデバイス固有の形式のデータに変換します。

カスタム Topic に送信されるメッセージの解析

デバイスが ?_sn=default 解析タグを持つカスタム Topic を使用してメッセージを送信した後、IoT Platform は IoT Platform コンソールで送信したメッセージ解析スクリプトを実行して、受信したメッセージのペイロードをカスタム形式から後続の処理のための JSON 構造体に変換します。

次の図は、データ解析のプロセスを示しています。

Process of message parsing

次の図は、カスタム Topic を使用してデータを送信するプロセスを示しています。

custom topic data parse

カスタム Topic データを解析するためのスクリプトの記述方法については、以下のトピックを参照してください。

TSL メッセージの解析

[データ形式] パラメーターが [カスタム] に設定されているプロダクトのデバイスがクラウドと通信する場合、IoT Platform は送信されたデータ解析スクリプトを実行して、アップストリームデータを標準の Alink JSON データに、ダウンストリームデータをカスタム形式のデータに解析します。

IoT Platform がデバイスからカスタム形式のメッセージを受信した後、IoT Platform はメッセージ解析スクリプトを実行して、受信したメッセージのデータを Alink JSON 形式のデータに変換し、変換されたデータを処理します。IoT Platform がデバイスにメッセージを送信する前に、IoT Platform はメッセージ解析スクリプトを実行して、Alink JSON 形式のメッセージをデバイスで使用されるカスタム形式のデータに変換します。

次の図は、データ解析のプロセスを示しています。

Parse TSL messages

次の図は、パススルー プロパティまたはイベントデータ(アップストリームデータ)を送信するプロセスを示しています。

Pass through data

次の図は、デバイスサービスの呼び出しまたはデバイスプロパティの設定(ダウンストリームデータ)のプロセスを示しています。

Transmit Alink JSON data

TSL メッセージを解析するためのメッセージ解析スクリプトの記述例の詳細については、以下のトピックを参照してください。