OnMQTTPubAck Zdarzenie

Wywoływane po otrzymaniu PUBACK dla publikacji z QoS 1 (PUBLISH → PUBACK).

Składnia

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

Wartość domyślna

—

Uwagi

Dostarczanie QoS 1 używa uzgadniania dwupaketowego: klient wysyła PUBLISH, a broker odpowiada komunikatem PUBACK, po czym wiadomość jest uważana za dostarczoną co najmniej raz. To zdarzenie potwierdza etap PUBACK. Parametry:

aPacketIdentifier — 16-bitowy identyfikator pakietu pierwotnie przypisany do wychodzącej wiadomości PUBLISH; służy do korelacji z wysłaną wiadomością.
ReasonCode (MQTT 5) — 0 = Sukces; wartości niezerowe opisują powód odrzucenia lub częściowego przyjęcia wiadomości przez brokera.
ReasonName (MQTT 5) — czytelna dla człowieka nazwa ReasonCode.
PubAckProperties (MQTT 5) — ReasonString i UserProperties zawierające diagnostykę brokera.

Dla QoS 0 nie jest wysyłane potwierdzenie i to zdarzenie nigdy nie jest wywoływane. Dla QoS 2 patrz OnMQTTPubRec / OnMQTTPubRel / OnMQTTPubComp.

Przykład

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;

Powrót do Zdarzeń