TsgcWSPClient_MQTT › Eventos › OnMQTTPubAck

OnMQTTPubAck Evento

Se dispara cuando se recibe un PUBACK para una publicación QoS 1 (PUBLISH → PUBACK).

Sintaxis

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

Valor Predeterminado

—

Observaciones

La entrega QoS 1 usa un protocolo de enlace de dos paquetes: el cliente envía PUBLISH y el broker responde con PUBACK, momento en el cual el mensaje se considera entregado al menos una vez. Este evento confirma el tramo PUBACK. Parámetros:

• aPacketIdentifier — el identificador de paquete de 16 bits asignado originalmente al PUBLISH saliente; úselo para correlacionarlo con el mensaje que envió.
• ReasonCode (MQTT 5) — 0 = Éxito; los valores distintos de cero describen por qué el broker rechazó o aceptó parcialmente el mensaje.
• ReasonName (MQTT 5) — ReasonCode legible por humanos.
• PubAckProperties (MQTT 5) — ReasonString y UserProperties que llevan diagnósticos del broker.

Para QoS 0 no se envía ningún acuse de recibo y este evento nunca se activa. Para QoS 2, consulte OnMQTTPubRec / OnMQTTPubRel / OnMQTTPubComp.

Ejemplo

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;

Volver a Eventos