Socket.IO 클라이언트

한눈에 보기

TsgcWSAPI_SocketIO

Socket.IO v3/v4 프로토콜용 클라이언트 — Engine.IO 전송, 네임스페이스, 이벤트 emit/receive, ACK 콜백, 바이너리 첨부.

컴포넌트 클래스

TsgcWSAPI_SocketIO

프로토콜

Socket.IO 문서

플랫폼

Windows, macOS, Linux, iOS, Android

에디션

Standard / Professional / Enterprise

빠른 시작

배치, 연결, 발생, 수신

EIO=4&transport=websocket로 /socket.io/를 가리키는 TsgcWebSocketClient와 짝지으세요 — 컴포넌트가 Engine.IO 핸드셰이크를 처리하고 Emit / Subscribe 이벤트를 사용할 수 있게 해줘요.

uses
  sgcWebSocket, sgcWebSocket_API_SocketIO;

var
  WSClient: TsgcWebSocketClient;
  SIO: TsgcWSAPI_SocketIO;
begin
  WSClient := TsgcWebSocketClient.Create(nil);
  WSClient.URL := 'wss://server.example.com/socket.io/?EIO=4&transport=websocket';

  SIO := TsgcWSAPI_SocketIO.Create(nil);
  SIO.Client := WSClient;

  WSClient.Active := True;

  SIO.Emit('/', 'chat:message',
    '{"user":"alice","text":"hello"}');
end;

// uses: sgcWebSocket, sgcWebSocket_API_SocketIO
TsgcWebSocketClient *WSClient = new TsgcWebSocketClient(this);
WSClient->URL = "wss://server.example.com/socket.io/?EIO=4&transport=websocket";

TsgcWSAPI_SocketIO *SIO = new TsgcWSAPI_SocketIO(this);
SIO->Client = WSClient;

WSClient->Active = true;
SIO->Emit("/", "chat:message",
  "{\"user\":\"alice\",\"text\":\"hello\"}");

기술적 기능

내부 구성

단일 TsgcWebSocketClient 위에서 Engine.IO 전송 계층(ping/pong, 업그레이드)과 Socket.IO 메시지 계층(CONNECT, EVENT, ACK, DISCONNECT)을 모두 구현해요.

Engine.IO 전송

EIO=4 핸드셰이크, 25초 ping/pong 주기, 프로토콜 업그레이드 경로를 처리해요. 컴포넌트는 페이로드 인코딩(텍스트 또는 바이너리)을 자동으로 협상해요.

네임스페이스

Connect(namespace)는 동일한 전송 위에서 추가 네임스페이스를 열어요. Emit(namespace, event, args)는 선택한 네임스페이스를 대상으로 하며, OnSocketIOEvent는 이벤트별 발신 네임스페이스를 보고해요.

이벤트 ACK

ACK 식별자와 함께 Emit에 콜백을 전달하면 — 서버가 응답할 때 컴포넌트가 일치하는 ID와 JSON 인수로 OnSocketIOAck를 발생시켜요.

바이너리 첨부

Socket.IO v4는 끼워진 바이너리 페이로드를 지원해요. 컴포넌트는 자리 표시자를 보존하고 각 첨부 파일을 JSON 봉투와 함께 스트림으로 제공해요.

재연결

자동 재연결을 위해 기본 TsgcWebSocketClient WatchDog를 바인딩하세요 — 재연결 시 컴포넌트는 모든 활성 네임스페이스에 대해 CONNECT 패킷을 다시 전송해요.

룸 (서버 측)

Socket.IO 룸은 서버 개념이에요. 컴포넌트는 서버가 정의한 룸 계약에 따라 join / leave 이벤트를 발생시켜 참여해요.

표준

사양 및 참고 자료

이 컴포넌트가 구현하는 프로토콜의 공식 출처.

리소스

문서 및 데모

컴포넌트 레퍼런스로 바로 이동하고, 실행 가능한 데모 프로젝트를 받고, 체험판을 다운로드하세요.

	온라인 도움말 — API_SocketIO 이 컴포넌트의 전체 속성, 메서드, 이벤트 레퍼런스.	열기
	무료 체험판 — sgcWebSockets Delphi에서 Socket.IO 서버에 연결하기 위한 체험판 패키지를 다운로드하세요.	열기
	기술 문서 (PDF) 이 컴포넌트의 기능, 빠른 시작, Delphi 및 C++ Builder 코드 샘플, 1차 출처 참고 자료.	열기
	사용자 설명서 (PDF) 라이브러리의 모든 컴포넌트를 다루는 종합 설명서.	열기