TsgcWSPClient_MQTT › Événements › OnMQTTPubRec

OnMQTTPubRec Événement

Se déclenche lors du deuxième échange du handshake QoS 2 (PUBLISH → PUBREC → PUBREL → PUBCOMP).

Syntaxe

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

Valeur par défaut

—

Remarques

QoS 2 garantit une livraison exactement-une-fois via une négociation à quatre paquets : PUBLISH → PUBREC → PUBREL → PUBCOMP. OnMQTTPubRec se déclenche lorsque le broker acquitte le PUBLISH original avec un paquet PUBREC, signalant que le broker a accepté le message pour le flux exactement-une-fois. Le composant répond automatiquement avec PUBREL pour continuer la négociation ; le PUBCOMP final arrivera via OnMQTTPubComp. Paramètres :

• aPacketIdentifier — identifiant de paquet 16 bits correspondant au PUBLISH que vous avez envoyé.
• ReasonCode (MQTT 5) — 0 = Succès ; les valeurs non nulles indiquent des conditions d'échec (par ex. quota dépassé, identifiant de paquet déjà utilisé).
• ReasonName (MQTT 5) — ReasonCode lisible par l'utilisateur.
• PubRecProperties (MQTT 5) — ReasonString et UserProperties.

Exemple

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;

Retour aux événements