Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

Publish to a Channel Field Feed

1 つのチャネル フィールドを更新するメッセージのパブリッシュ

トピック

channels/<channelID>/publish/fields/field<fieldnumber>/<apikey>

説明

channels/<channelID>/publish/fields/field<fieldnumber>/<apikey> は、チャネル フィールドを更新するメッセージをトピックにパブリッシュします。<channelID> をチャネル ID に、<fieldnumber> を更新するフィールド番号に、<apikey> をチャネルの Write API キーに置き換えます。チャネルの構成の詳細については、チャネル構成を参照してください。このメソッドを使用して、チャネルの 1 つのフィールドを更新します。複数のパラメーターを同時に更新するには、ペイロード パラメーターを参照してください。

  • QoS 値が 0 となるように PUBLISH メッセージを設定します。

  • 接続の RETAIN フラグを 0 に設定します。

  • 接続の CleanSession フラグを 1 に設定します。

これらのフラグの詳細については、MQTT v3.1.1 の仕様を参照してください。

入力引数

すべて展開する

パブリッシュ対象のチャネル ID。数値として指定します。

データ型: uint16 | int16 | int8 | uint8

チャネルの Write API キー。この値は、[Channel Settings][API Keys] にあります。この値は、接続に使用する MQTT API キーとは異なり、チャネルの Read API キーとも異なります。

データ型: char

パブリッシュ対象のフィールド番号。正の整数として指定します。

データ型: uint16 | int16 | int8 | uint8

ペイロード パラメーター

チャネルの指定フィールドに入力するデータ。文字列として指定します。例: 100

MQTT.fx を構成して、チャネル フィールドを更新する PUBLISH メッセージを送信します。

<channelID> をチャネル ID に、<apikey> をチャネルの Write API キーに置き換えます。この PUBLISH メッセージは、指定されたチャネルの field145 の値をパブリッシュします。