TsgcWSPClient_MQTT › イベント › OnMQTTPubAck

OnMQTTPubAck イベント

QoS 1 パブリッシュ（PUBLISH → PUBACK）に対して PUBACK が受信されたときに発生します。

構文

property OnMQTTPubAck: TsgcWSMQTTPubAckEvent;
// TsgcWSMQTTPubAckEvent = procedure(Connection: TsgcWSConnection; aPacketIdentifier: Word; ReasonCode: Integer; const ReasonName: String; PubAckProperties: TsgcWSMQTTPUBACKProperties) of object

デフォルト値

—

解説

QoS 1 配信は 2 パケットのハンドシェイクを使用します: クライアントが PUBLISH を送信し、ブローカーが PUBACK で返答します。この時点でメッセージは少なくとも一度は配信されたとみなされます。このイベントは PUBACK レグを確認します。パラメータ:

• aPacketIdentifier — 送信した PUBLISH に割り当てられた 16 ビットのパケット ID。送信したメッセージとの照合に使用します。
• ReasonCode（MQTT 5）— 0 = 成功。ゼロ以外の値はブローカーがメッセージを拒否または部分的に受け入れた理由を示します。
• ReasonName（MQTT 5）— 人が読める形式の ReasonCode。
• PubAckProperties（MQTT 5）— ブローカー診断を伝えるReasonStringとUserProperties。

QoS 0 では確認応答は送信されず、このイベントは発火しません。QoS 2 については OnMQTTPubRec / OnMQTTPubRel / OnMQTTPubComp を参照してください。

使用例

procedure TForm1.MQTTPubAck(Connection: TsgcWSConnection;
  aPacketIdentifier: Word; ReasonCode: Integer;
  const ReasonName: String;
  PubAckProperties: TsgcWSMQTTPUBACKProperties);
begin
  Memo1.Lines.Add(Format('PUBACK id=%d code=%d (%s)',
    [aPacketIdentifier, ReasonCode, ReasonName]));
end;

イベントに戻る