MQTT（Message Queuing Telemetry Transport）ゲートウェイデバイスは、カスタム Topic を使用して IoT Platform と通信できます。IoT Platform は、デバイスのアップストリームおよびダウンストリーム通信データを受け渡すことができます。このトピックでは、デバイスと IoT Platform 間のアップストリームおよびダウンストリーム通信を実装する方法について説明します。
Topic
IoT Platform は、MQTT 経由で Topic を使用してゲートウェイデバイスと通信できます。通信用のカスタム Topic を定義する必要があります。通信用の Topic は、標準 MQTT プロトコルで定義されている Topic の仕様に準拠している必要があります。Topic の詳細については、「Topic」をご参照ください。
デバイスがデータを送信するために使用する Topic をカスタム Topic として使用できます。デバイスがアップストリームデータを送信するために使用する Topic は、デバイスがダウンストリームデータを受信するために使用する Topic と同じです。
次の表は、IoT Platform でサポートされている Topic と標準 MQTT プロトコルでサポートされている Topic の違いを示しています。
項目 | IoT Platform | 標準 MQTT プロトコル |
長さ | Topic は 1 ～ 128 文字の長さでなければなりません。 | Topic は最大 65,535 文字の長さにすることができます。 |
文字セット | Topic には、文字、数字、およびアンダースコア（_）のみを含めることができます。 | Topic には UTF-8 文字を含めることができます。その他の制限はありません。 |
制限
MQTT ゲートウェイデバイスは、最大 100 個の Topic をサブスクライブできます。
Topic カテゴリのデバイス操作権限パラメーターを [サブスクライブ] に設定すると、Topic カテゴリにワイルドカード文字である
プラス記号（+）とシャープ記号（#）を指定して、デバイスが複数の Topic を同時にサブスクライブできるようにすることができます。ワイルドカード文字の使用方法の詳細については、「1 つ以上のワイルドカード文字を含むカスタム Topic」をご参照ください。
アップストリーム通信：デバイスから IoT Platform へ
デバイスは、カスタム Topic にメッセージをパブリッシュします。IoT Platform は、AMQP（Advanced Message Queuing Protocol）サーバー側サブスクリプションまたはデータ転送機能を使用して、デバイスからメッセージを受信できます。
データ転送ルールを構成する場合は、次の点に注意してください。
ゲートウェイデバイスのデータ転送ルールを構成するには、新しいバージョンのデータ転送機能のみを使用できます。詳細については、「データ転送パーサーを構成する」をご参照ください。
IoT Platform ゲートウェイプロダクトおよびデバイスから IoT Platform 共通プロダクトおよびデバイスにメッセージを転送することはできません。また、IoT Platform 共通プロダクトおよびデバイスから IoT Platform ゲートウェイプロダクトおよびデバイスにメッセージを転送することもできません。
ゲートウェイデバイスのデータを別の Topic に転送する場合、deviceName パラメーターを構成する必要があります。詳細については、「宛先にデータを転送する」をご参照ください。
データの転送元の Topic を指定する場合、Topic の名前を入力する必要があります。詳細については、「データソースを作成する」をご参照ください。
サーバー側サブスクリプションを使用して、[デバイスアップストリーム通知]、[デバイスステータス変更通知]、および [ライフサイクル全体のデバイス変更] タイプのデータのみをプッシュできます。詳細については、「AMQP サーバー側サブスクリプションを構成する」をご参照ください。
ダウンストリーム通信：IoT Platform からデバイスへ
IoT Platform は、Pub API 操作を呼び出して、指定されたカスタム Topic にメッセージをパブリッシュします。デバイスは、Topic をサブスクライブすることで IoT Platform からメッセージを受信します。