TsgcWebSocketServer › イベント › OnMessage

OnMessage イベント

クライアントがテキストメッセージを送信してサーバーで受信されるたびに発生します。

構文

property OnMessage: TsgcWSMessageEvent;
// TsgcWSMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string) of object

デフォルト値

—

解説

OnMessage は、クライアントから完全なテキストフレームを受信したときに発生します。Text パラメータはデコードされた UTF-8 文字列を持ち、Connection パラメータは送信者セッションを識別します。ハンドラーは同じ接続で返信したり、メッセージを他のクライアントに中継したりできます。デフォルトでは NotifyEvents は neAsynchronous であり、ハンドラーはメインスレッドと同期して実行されるため、UI コントロールを安全に更新できます。高スループットサーバーの場合は NotifyEvents を neNoSync に設定して接続スレッドでディスパッチし、独自の同期を実装してください。Options.FragmentedMessages が frgOnlyFragmented の場合、イベントは発生せず、ペイロードは代わりに OnFragmented を通じて配信されます。

使用例

procedure OnMessage(Connection: TsgcWSConnection; const Text: string);
begin
  ShowMessage('Message Received from Client: ' + Text);
end;

イベントに戻る