TsgcWSPClient_MQTT › イベント › OnMQTTBeforeConnect

OnMQTTBeforeConnect イベント

CONNECT パケットが送信される前に発生し、アプリが CleanSession と ClientIdentifier を上書きできます。

構文

property OnMQTTBeforeConnect: TsgcWSMQTTBeforeConnectEvent;
// TsgcWSMQTTBeforeConnectEvent = procedure(Connection: TsgcWSConnection; var aCleanSession: Boolean; var aClientIdentifier: String) of object

デフォルト値

—

解説

CONNECT パケットがネットワークに書き込まれる直前に調整する最後の機会。コンポーネントは WebSocket / TCP トランスポートが起動した後、CONNECT をシリアライズする前にこのイベントを発生させます。ハンドラーはオーバーライドできます:

• aCleanSession（var、Boolean）— True（デフォルト）の場合、ブローカーは以前のセッションを破棄して新しく開始します。保存されたセッションを再開するには False に設定します（MQTT 5 では ConnectProperties の SessionExpiryInterval でより細かく制御できます）。
• aClientIdentifier（var、String）— 一意のクライアントID。コンポーネントはGUIDベースの値を自動生成します。ブローカーが特定のIDを要求する場合（例えばアクセス制御ルールに一致させるため、または永続セッションを再接続・再開するため）はここで置き換えてください。

その他の接続状態（認証情報、LastWillTestament、ConnectProperties）は、このハンドラー内ではなく、Activateの前にコンポーネント自体で設定する必要があります。

使用例

procedure TForm1.MQTTBeforeConnect(Connection: TsgcWSConnection;
  var aCleanSession: Boolean; var aClientIdentifier: String);
begin
  // resume the stored session if the broker still has it
  aCleanSession     := False;
  aClientIdentifier := 'sensor-gateway-01';
end;

イベントに戻る