TsgcWebSocketServer › 이벤트 › OnMessage

OnMessage Event

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

구문

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;

이벤트로 돌아가기