TsgcWebSocketHTTPServer › 事件 › OnMessage

OnMessage 事件

每次客户端发送文本消息且服务器接收到时触发。

语法

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

默认值

—

备注

一旦从 WebSocket 客户端收到完整的文本帧，就会引发 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;

返回事件