TsgcWebSocketServer › Events › 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;

返回事件