TsgcWSPClient_MQTT › Eventi › OnMQTTPubAck

OnMQTTPubAck Event

Si attiva quando viene ricevuto un PUBACK per una pubblicazione QoS 1 (PUBLISH → PUBACK).

Sintassi

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

Valore predefinito

—

Note

La consegna QoS 1 utilizza un handshake a due pacchetti: il client invia PUBLISH e il broker risponde con PUBACK, momento in cui il messaggio è considerato consegnato almeno una volta. Questo evento conferma la fase PUBACK. Parametri:

• aPacketIdentifier — l'id del pacchetto a 16 bit originariamente assegnato al PUBLISH in uscita; lo utilizzi per la correlazione con il messaggio inviato.
• ReasonCode (MQTT 5) — 0 = Successo; valori diversi da zero descrivono perché il broker ha rifiutato o accettato parzialmente il messaggio.
• ReasonName (MQTT 5) — ReasonCode leggibile dall'uomo.
• PubAckProperties (MQTT 5) — ReasonString e UserProperties con diagnostica del broker.

Per QoS 0 non viene inviata alcuna conferma e questo evento non si attiva mai. Per QoS 2 vedere OnMQTTPubRec / OnMQTTPubRel / OnMQTTPubComp.

Esempio

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;

Torna agli Eventi