TsgcWebSocketServer_HTTPAPI › 이벤트 › OnMessage

OnMessage Event

클라이언트가 텍스트 메시지를 보내고 서버가 이를 수신할 때마다 발생합니다.

구문

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

기본값

—

설명

OnMessage는 HTTP.SYS WebSocket 파이프라인을 통해 클라이언트로부터 완전한 텍스트 프레임이 수신되면 발생합니다. Text 매개변수는 디코딩된 UTF-8 문자열을 전달하고 Connection 매개변수는 발신 세션을 식별하므로, 핸들러는 동일한 연결에서 응답하거나 메시지를 다른 클라이언트에 중계할 수 있습니다. 이벤트는 IOCP 워커 스레드의 컨텍스트에서 실행됩니다. UI 컨트롤을 업데이트해야 하는 경우 호출을 메인 스레드로 마샬링하십시오. Options.FragmentedMessages가 frgOnlyFragmented이면 이벤트가 발생하지 않고 페이로드가 대신 OnFragmented를 통해 전달됩니다.

예제

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

이벤트로 돌아가기