TsgcWSPClient_MQTT › Ereignisse › OnMQTTDisconnect

OnMQTTDisconnect Ereignis

Wird ausgelöst, wenn der Broker ein DISCONNECT sendet oder die Sitzung geschlossen wird; meldet ReasonCode und MQTT-5-DisconnectProperties.

Syntax

property OnMQTTDisconnect: TsgcWSMQTTDisconnectEvent;
// TsgcWSMQTTDisconnectEvent = procedure(Connection: TsgcWSConnection; ReasonCode: Integer; const ReasonName: String; DisconnectProperties: TsgcWSMQTTDISCONNECTProperties) of object

Standardwert

—

Hinweise

Signalisiert, dass die MQTT-Sitzung beendet wird. MQTT 3.1.1 hat kein servergesteuertes DISCONNECT-Paket, sodass das Ereignis in diesem Fall eine lokal erkannte Schließung widerspiegelt. MQTT 5.0 führt ein DISCONNECT-Paket ein, das der Broker senden kann, um zu erklären, warum die Verbindung geschlossen wird. Parameter:

• ReasonCode (MQTT 5) — numerischer DISCONNECT-Grund (0 = Normale Trennung).
• ReasonName (MQTT 5) — menschenlesbare Beschreibung des ReasonCode.
• DisconnectProperties (MQTT 5) — SessionExpiryInterval, ReasonString, UserProperties und ServerReference (vom Broker verwendet, um den Client an einen alternativen Server umzuleiten).

Verwenden Sie dieses Ereignis, um die Ursache zu protokollieren, den UI-Zustand zu aktualisieren und, falls ServerReference gesetzt ist, eine Wiederverbindung zum vorgeschlagenen Broker in Betracht zu ziehen.

Beispiel

procedure TForm1.MQTTDisconnect(Connection: TsgcWSConnection;
  ReasonCode: Integer; const ReasonName: String;
  DisconnectProperties: TsgcWSMQTTDISCONNECTProperties);
begin
  Memo1.Lines.Add(Format('Disconnect %d (%s)',
    [ReasonCode, ReasonName]));

  if DisconnectProperties.ServerReference <> '' then
    Memo1.Lines.Add('Broker suggests: ' +
      DisconnectProperties.ServerReference);
end;

Zurück zu Ereignissen