TsgcWSPClient_MQTT › Eventos › OnMQTTPubAck

OnMQTTPubAck Event

Disparado quando um PUBACK é recebido para um publish QoS 1 (PUBLISH → PUBACK).

Sintaxe

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

Valor Padrão

—

Observações

A entrega QoS 1 usa um handshake de dois pacotes: o cliente envia PUBLISH e o broker responde com PUBACK, momento em que a mensagem é considerada entregue ao menos uma vez. Este evento confirma a etapa PUBACK. Parâmetros:

• aPacketIdentifier — o id de pacote de 16 bits originalmente atribuído ao PUBLISH de saída; utilize-o para correlacionar com a mensagem que você enviou.
• ReasonCode (MQTT 5) — 0 = Success; valores diferentes de zero descrevem por que o broker recusou ou aceitou parcialmente a mensagem.
• ReasonName (MQTT 5) — ReasonCode legível por humanos.
• PubAckProperties (MQTT 5) — ReasonString e UserProperties carregando diagnósticos do broker.

Para QoS 0, nenhuma confirmação é enviada e este evento nunca dispara. Para QoS 2, veja OnMQTTPubRec / OnMQTTPubRel / OnMQTTPubComp.

Exemplo

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;

Voltar para Eventos