Unity WebGL의 한계를 넘는 Socket.IO v4 클라이언트 구현기

Context

Unity 환경 내 Socket.IO v4 지원 라이브러리의 부재. 기존 에셋의 소스 코드 비공개 및 버전 불일치 문제 발생. 특히 WebGL 플랫폼의 네트워크 API 접근 제한으로 인한 구현 난이도 상승.

Technical Solution

• ITransport 인터페이스 기반의 추상화 계층 설계로 WebSocket 및 WebGL 환경별 전송 방식 분리
• .jslib 파일을 활용한 JavaScript 브릿지 구축으로 C#에서 브라우저 Native WebSocket API 제어
• WebGL 메모리 오염 및 누수 방지를 위한 UTF-8 바이트 버퍼 기반의 수동 메모리 관리 전략 적용
• JS ArrayBuffer의 C# 직접 전달 불가 문제를 해결하기 위해 Base64 인코딩 및 디코딩 프로세스 도입
• Unity 도메인 리로드 시 발생하는 고스트 연결 방지를 위해 OnDisable 훅 기반의 명시적 소켓 종료 로직 구현
• UnityMainThreadDispatcher를 이용한 모든 이벤트 콜백의 메인 스레드 큐잉으로 Thread-safe한 API 접근 보장
• 서버 부하 분산을 위해 지터(Jitter) 값이 포함된 Exponential Backoff 재연결 알고리즘 적용

Impact

• 1K 이벤트 전송 및 10MB 바이너리 데이터 처리 스트레스 테스트 완료
• 100건의 동시 ACK 처리 검증

Key Takeaway

브라우저 환경의 런타임 제약은 상위 언어의 추상화만으로 해결 불가능함. 플랫폼 특화 브릿지 설계와 메모리 생명주기 관리를 초기 아키텍처 단계부터 반영하는 설계 원칙이 필수적임.