TsgcWSPClient_MQTT › Eventos › OnMQTTPubRec

OnMQTTPubRec Evento

Se activa en la segunda fase del protocolo de enlace QoS 2 (PUBLISH → PUBREC → PUBREL → PUBCOMP).

Sintaxis

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

Valor Predeterminado

—

Observaciones

QoS 2 garantiza la entrega exactamente una vez mediante un handshake de cuatro paquetes: PUBLISH → PUBREC → PUBREL → PUBCOMP. OnMQTTPubRec se activa cuando el broker reconoce el PUBLISH original con un paquete PUBREC, indicando que el broker ha aceptado el mensaje para el flujo exactamente una vez. El componente responde automáticamente con PUBREL para continuar el handshake; el PUBCOMP final llegará en OnMQTTPubComp. Parámetros:

• aPacketIdentifier — ID de paquete de 16 bits que coincide con el PUBLISH enviado.
• ReasonCode (MQTT 5) — 0 = Success; los valores distintos de cero indican condiciones de error (p. ej. cuota superada, identificador de paquete en uso).
• ReasonName (MQTT 5) — ReasonCode legible por humanos.
• PubRecProperties (MQTT 5) — ReasonString y UserProperties.

Ejemplo

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;

Volver a Eventos