TsgcWebSocketHTTPServer › イベント › OnMessage

OnMessage イベント

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

構文

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

デフォルト値

—

解説

OnMessageは、WebSocketクライアントから完全なテキストフレームが受信されると発生します。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;

イベントに戻る