OnMQTTPubRec Zdarzenie

Wywoływane podczas drugiej fazy uzgadniania QoS 2 (PUBLISH → PUBREC → PUBREL → PUBCOMP).

Składnia

property OnMQTTPubRec: TsgcWSMQTTPubRecEvent;
// TsgcWSMQTTPubRecEvent = procedure(Connection: TsgcWSConnection; aPacketIdentifier: Word; ReasonCode: Integer; const ReasonName: String; PubRecProperties: TsgcWSMQTTPUBRECProperties) of object

Wartość domyślna

—

Uwagi

QoS 2 gwarantuje dostarczenie dokładnie raz za pomocą czteropakietowego uzgadniania: PUBLISH → PUBREC → PUBREL → PUBCOMP. Zdarzenie OnMQTTPubRec jest wywoływane, gdy broker potwierdza pierwotny komunikat PUBLISH pakietem PUBREC, sygnalizując, że broker przyjął wiadomość do przepływu exactly-once. Komponent automatycznie odpowiada komunikatem PUBREL w celu kontynuowania uzgadniania; końcowy pakiet PUBCOMP zostanie odebrany przez zdarzenie OnMQTTPubComp. Parametry:

aPacketIdentifier — 16-bitowy identyfikator pakietu pasujący do wysłanego PUBLISH.
ReasonCode (MQTT 5) — 0 = Sukces; wartości niezerowe wskazują warunki błędu (np. przekroczony limit, identyfikator pakietu w użyciu).
ReasonName (MQTT 5) — czytelna dla człowieka nazwa ReasonCode.
PubRecProperties (MQTT 5) — ReasonString i UserProperties.

Przykład

procedure TForm1.MQTTPubRec(Connection: TsgcWSConnection;
  aPacketIdentifier: Word; ReasonCode: Integer;
  const ReasonName: String;
  PubRecProperties: TsgcWSMQTTPUBRECProperties);
begin
  // second leg of QoS 2: broker has the message, PUBREL is sent automatically
  Memo1.Lines.Add(Format('PUBREC id=%d (%s)',
    [aPacketIdentifier, ReasonName]));
end;

Powrót do Zdarzeń