Direct Play는 사용자의 개인 자료를 서버에 맡기지 않는 공유를 지향한다. 사진퍼즐의 P2P 전달 흐름을 따라가며 이 원칙을 구현한 정보 경계, 게임 개발을 돕는 공통 게임방, 현재 구현의 적용 범위와 남은 과제를 그림으로 살펴본다.

게임 하나를 추가할 때, 연결도 다시 만들어야 할까?

사진을 맞추는 퍼즐과 자동차를 조종하는 레이싱은 규칙이 다르다. 하지만 친구를 초대하고, 같은 방에 모이고, 필요한 자료를 받아 함께 시작하는 일은 반복된다. 게임이 늘어날수록 이 주변 기능도 함께 늘어난다.

Direct Play는 이 반복을 공통 게임방에 모았다. 여기서 게임방은 단순한 방 번호가 아니다. 참가자, 접근 권한, 공유 자원, 접속 상태와 결과를 연결하는 실행 기반이다.

그 기반을 만들 때 우선한 것은 개인정보나 민감한 자료가 서버를 경유하지 않도록 한다는 설계 원칙이다. 친구에게 사진을 보여 주기 위해 서비스 운영자에게도 사진을 맡길 필요는 없다고 보았다. 사진퍼즐은 게임에 사용할 이미지와 정답을 참가자 기기 사이에서 직접 전달하는 방식으로 이 원칙을 적용했다.

공통 게임방은 이 직접 공유를 게임마다 다시 구현하지 않도록 돕는다. 개인 자료의 처리 경계를 공통 계층이 맡으면, 개별 게임은 같은 기반 위에서 자신의 규칙과 화면에 집중할 수 있다. 다만 이 글에서는 지향하는 원칙과 현재 코드가 적용한 범위를 구분한다.

게임마다 달라지는 것 사진퍼즐 조각 맞추기 포켓 레이스 주행·충돌 스파이 게임 역할·추리 공통 계약 · ctx API 공통 게임방 플랫폼 방·초대·참가자·접근 권한 자원 전달·접속 상태·결과 공유
그림 1. 게임 규칙은 각 모듈에, 반복되는 연결과 공유 기능은 플랫폼에 둔다.

이 분리는 실제 모듈 계약에 드러난다. 게임은 설정 화면을 만드는 createSetup, 공유할 자원을 모으는 collectAsset, 플레이 화면을 만드는 createPlay를 제공한다. 셸은 게임 모듈을 불러오고 알맞은 화면 영역에 연결한다.

게임이 진행을 알릴 때는 ctx.publishProgress(), 기본 방식의 결과를 제출할 때는 ctx.finish()를 사용한다. HTTP·WebSocket·WebRTC의 세부 처리는 공통 계층에 둔다. 개발자가 연결 절차를 매번 작성하지 않아도 된다는 것이 이 구조의 직접적인 장점이다.

다만 모든 게임이 같은 API만 쓰는 것은 아니다. 실시간·진행자형·서버 판정 게임은 목적에 맞는 별도 컨텍스트를 받는다. 공통 기반 위에 게임별 요구를 표현할 여지를 남긴 구조다. 구현 근거는 frontend/app.js, frontend/games/registry.js, docs/Game-Developer-Guide.md다.

같은 플랫폼 위에, 방마다 독립된 공유 공간

공통 게임방이라는 말은 모든 사용자가 하나의 상태를 공유한다는 뜻이 아니다. 같은 방에 들어온 사람끼리만 같은 자원과 참가자 목록을 바라보도록, 방마다 별도의 맥락을 만든다는 뜻이다.

현재 운영 구성은 Cloudflare Worker가 요청을 받고, 방 ID를 이용해 해당 GameRoom Durable Object로 전달한다. 방마다 하나의 객체가 상태와 WebSocket 연결을 관리한다. Durable Object는 여러 클라이언트를 한 지점에서 조정하고 자체 저장소를 사용하는 데 적합하다. Cloudflare의 Durable Objects 개념 문서도 이 특성을 설명한다.

Cloudflare Worker 웹 앱 제공 · 방 ID로 요청 분배 A방 GameRoom 상태·접속·저장 B방 GameRoom 상태·접속·저장 A방의 HTTP · WebSocket 자원 보유자 브라우저 새 참가자 브라우저 사진 자원은 P2P로 직접 전달
그림 2. 사진퍼즐 초대방의 주요 경로. 각 방의 상태는 나뉘고, 자원 본문은 브라우저 사이를 이동한다. 전역 방 한도와 게임 전용 API는 생략했다.

이때 서버가 맡는 방·권한·연결 조정을 제어면, 참가자끼리 자원 본문을 옮기는 경로를 데이터면이라고 부를 수 있다. 이 분리는 전송 부담을 줄이는 동시에, 사용자가 공유하는 사진 본문을 방 서버의 처리 대상에서 분리한다. 구현은 worker/index.js의 방 라우팅과 worker/room.js에서 확인할 수 있다.

개인 자료는 직접 공유하고, 서버에는 방 운영을 맡긴다

사진퍼즐의 P2P는 사진 전송 비용을 줄이는 수단에 그치지 않는다. 사용자가 함께 보려는 사진 본문을 서비스 서버에 전달하거나 보관하지 않고 참가자끼리 공유한다는 정보 처리 방식이다. 서버는 사진 대신 방의 준비 여부, 참가자의 접속과 연결 요청을 조정한다.

사진퍼즐에서 선택한 사진은 브라우저에서 정방형으로 가공되고, 이미지·장소 정답·난이도가 payload라는 자원 본문으로 묶인다. 서버에는 이 본문 대신 준비 여부, 요약, 난이도와 해시 등 자원 메타데이터를 등록한다. 해시는 나중에 받은 자원이 등록된 것과 일치하는지 비교하는 기준이다.

① 개인 자료는 참가자끼리 게임용 이미지 · 장소 정답 · 난이도 브라우저 → 브라우저 ② 연결·진행을 위한 중계 연결 신호 · 진행 알림 앱 저장소에 이력을 남기지 않음 ③ 방 운영을 위한 저장 방 정보 · 자원 메타데이터 최근 결과 · 접근 권한 정보 결과 목록은 방당 최대 20건
그림 3. 사진퍼즐의 핵심 정보 경계. 사진·닉네임·위치는 참가자끼리 직접 공유하고, 서버는 방 운영과 연결 조정을 맡는다.

서버는 signal과 progress를 중계하고, 결과를 저장한 뒤 방에 알린다. 자원 메타데이터는 허용된 필드로 정리하며 썸네일은 저장하지 않는다. 서버의 역할을 방 운영으로 좁히고 사진 본문의 공유는 기기에 남겨 둔 것이다. 관련 코드는 publishAssetMeta, sanitizeAssetMeta, relaySignal, relayProgress, submitResult다.

개인 자료와 연결 정보의 경계

사진·닉네임·위치는 서버를 거치지 않고 참가자 기기 사이에서 공유한다. 시그널링 메시지에서도 닉네임과 위치를 제거하며, 이 경계를 테스트로 검증한다.

서버는 연결에 필요한 SDP·ICE 후보를 저장하지 않고 전달한다. 접속 IP처럼 서비스 연결에 필요한 네트워크 정보와, 참가자끼리 공유하는 개인 자료는 구분한다.

사진 한 장이 참가자에게 도착하기까지

방장은 자원을 로컬에 보관하고 메타데이터를 등록한 뒤 방을 준비 완료 상태로 전환한다. 초대받은 참가자는 서버에서 방 정보를 받고 자원을 요청한다. 서버는 사진을 보내는 대신 현재 자원을 가진 참가자에게 요청을 연결한다.

1 방장이 자원을 준비한다 사진·정답은 브라우저에 보관 방장 → 서버 : 메타 등록·준비 완료 2 참가자가 방에 들어온다 초대 링크로 입장·접속 상태 등록 참가자 → 서버 : 자원 요청 3 서버가 보유자를 찾는다 접속 중인 자원 보유자에게 중계 서버 → 보유자 : 보내 주세요 4 직접 연결할 정보를 나눈다 보유자 ↔ 서버 ↔ 참가자 offer · answer · ICE 후보 5 자원 본문을 직접 보낸다 보유자 → 참가자 : P2P 자원 JSON을 나누어 전달 6 복원하고, 보유 사실을 알린다 자원 복원 → 해시 비교 → 보유 등록
그림 4. 파란 단계는 서버를 통한 조정, 초록 단계는 브라우저의 자원 처리다. 5번의 사진 본문은 방 서버를 통과하지 않는다.

4번의 연결 정보 교환을 시그널링이라고 한다. 두 브라우저가 연결 제안과 응답, 통신 가능한 경로 후보를 주고받는 절차다. WebRTC는 이 정보를 교환할 시그널링 서비스를 별도로 구성하도록 한다. Direct Play는 HTTP로 신호를 올리고 방의 WebSocket으로 상대에게 전달한다. WebRTC 공식 연결 가이드의 연결 절차와 같은 역할 분담이다.

5번에서 공통 P2P 모듈은 순서가 보장되는 dpg-room DataChannel을 만든다. 자원 봉투를 JSON으로 직렬화해 시작·조각·끝 메시지로 보내고, 받는 쪽은 조각을 합친다. 현재 조각 크기 기준은 문자열 길이 16,000이며, UTF-8의 16KB와 같은 뜻은 아니다. 이 처리는 사진퍼즐 코드가 아닌 frontend/core/p2p.js에 있다.

6번에서는 정상적인 해시 계산이 가능한 경우 등록된 payloadHash와 SHA-256 값을 비교한다. 현재 코드는 기준 해시가 없거나 해시 계산이 불가능하면 검사를 통과시키므로, 모든 상황에서 강제로 검증하는 장치는 아니다. 이 비교는 자원 일치 확인을 위한 것이며 점수 조작 방지까지 보장하지 않는다.

자료를 받은 참가자도 다음 전달자가 된다

사진을 보내는 사람은 반드시 방장일 필요가 없다. 참가자는 자원을 받은 뒤 서버에 hasAsset: true로 보유 사실을 알린다. 이후 새 참가자가 요청하면 서버는 접속 중인 보유자 가운데 연결 시각이 빠른 사람을 선택한다.

자료를 받으면, 보유자가 된다 방장 A 자원 보유 참가자 B 자원 수신 B가 서버에 보유 사실을 알린 뒤 참가자 B 자원 보유 참가자 C 자원 수신 방장 외의 참가자도 P2P 전송 가능
그림 5. 전송자 역할은 자원 보유자가 이어받을 수 있다. 게임 진행 권한이나 방장 역할까지 자동으로 이전되는 것은 아니다.

수신한 자원은 활성 상태에 반영되고 로컬 방 저장 경로에도 전달된다. 그래서 서버에 사진 사본이 없어도, 접속 중인 보유자가 있으면 새 참가자에게 다시 보낼 수 있다. 다만 대역폭을 보고 자동 분산하는 알고리즘이나 여러 사람에게서 조각을 동시에 받는 방식은 구현되어 있지 않다. 선택된 보유자와 수신자 사이의 전송이다.

반대로 방에 아무 보유자도 없다면 서버는 사진을 대신 보내 줄 수 없다. 보유자의 재접속을 기다려야 하고, 브라우저 저장소 삭제나 용량 부족으로 자원이 사라질 수도 있다. 현재 로컬 저장 코드는 용량이 부족하면 오래된 방의 자원 본문부터 덜어 낸다. 구현 근거는 onlineAssetHolders, assetRequest, onAssetReceived, frontend/core/store.js다.

같은 게임방이어도, 통신과 심판은 다를 수 있다

자원을 함께 쓰는 것과 게임 상태를 함께 결정하는 것은 다른 문제다. 퍼즐은 같은 문제를 각자 풀 수 있다. 레이싱은 서로의 입력이 실시간으로 영향을 준다. 스파이 게임에는 특정 참가자에게만 보여 줄 역할이 있고, 가위바위보에는 동시에 공개할 선택이 있다.

사진퍼즐 · 같은 자원, 각자 플레이 자원 본문 : P2P 플레이·정답 판정 : 각 브라우저 포켓 레이스 · 방장 중심 실시간 입력·세계 상태 : P2P 세계 상태 계산 : 방장 브라우저 스파이 게임 · 방장이 진행 행동·역할 메시지 : 서버 WS 중계 진행과 비밀 정보 관리 : 방장 가위바위보 · 서버가 심판 선택 수집·라운드 판정 : 서버 공개 전 선택 숨김·경기 상태 저장
그림 6. 게임 중 주요 상태·메시지 경로를 비교했다. 공통 방 관리와 진행·결과 공유 경로는 별도로 유지된다.

포켓 레이스는 최대 4명으로, 참가자가 방장과 연결되는 형태다. 상태 채널은 순서 보장과 재전송을 끄고, 이벤트 채널은 순서를 보장한다. 최신 위치처럼 새 값이 곧 도착하는 정보와 시작·종료처럼 순서가 중요한 정보를 구분한 것이다. 이런 전송 모드의 차이는 WebRTC Data Channels 표준 RFC 8831에도 설명되어 있다.

스파이 게임의 sendPrivate는 역할처럼 게임 중 일부 참가자에게만 보여 줄 정보를 서버가 지정한 대상에게 전달하는 기능이다. 여기서의 비밀 정보는 게임 진행상 공개 시점을 제한하는 정보를 뜻한다. 개인 사진의 공유 경로와는 별개이며, 서버도 메시지 본문을 처리한다. 서버가 읽을 수 없는 별도의 종단 간 암호화는 구현되어 있지 않다.

가위바위보에서는 서버가 손 선택을 받고 경기 상태를 저장한다. 다른 참가자에게 선택을 숨겼다가 제출이 모이면 판정하고 공개한다. 방장 브라우저가 상대 선택을 먼저 모으지 않도록 게임 판정을 서버에 맡긴 것이다. 사용자 개인 자료의 공유와 게임 진행·판정 데이터의 처리를 서로 다른 책임으로 나눈 사례다.

핀홀 게임에는 서버의 R2 저장소에서 준비된 문제와 이미지를 읽는 전용 API도 있다. 서비스가 제공하는 게임 자료와 사용자가 공유하는 개인 사진은 출처와 목적이 다르다. P2P의 적용 여부는 이런 차이를 기준으로 설명할 수 있다. 다만 게임용 데이터라는 이름만으로 그 안에 개인정보가 없다고 보장되는 것은 아니므로, 새 게임을 추가할 때도 실제 필드와 본문을 살펴야 한다.

이 차이는 realtime-session, moderated-session, server-session이라는 실행 모드로 표현된다. 게임별 통신 요구를 같은 방식에 억지로 맞추지 않고 공통 셸 아래에 수용한다. 다만 서버 판정 게임처럼 새로운 요구는 서버 확장도 필요하다. 모든 새 게임이 프런트엔드 파일만 추가하면 완성되는 것은 아니다.

얻는 것과, 그 대가로 남는 조건

이 설계가 지키려는 가치는 사용자의 개인 자료를 서버에 맡기지 않는 공유와 게임 개발의 반복을 줄이는 공통 기반이다. 서버의 사진 저장·배포 부담이 줄어드는 것은 그 정보 경계가 만드는 운영상의 이점이다. 같은 선택은 연결과 자료 보유에 관한 조건도 함께 만든다.

공통 게임방 얻음 : 연결·공유 기능 재사용 조건 : 게임별 차이를 수용할 공통 API와 확장 경로 개인 사진의 P2P 공유 얻음 : 서버에 사진 사본을 남기지 않음 조건 : 접속 중인 보유자와 브라우저 간 연결 성공 방장 중심 계산·진행 얻음 : 서버의 게임 계산 부담 감소 조건 : 방장의 접속 유지와 신뢰 적용 대상 : 레이싱·진행자형 게임
그림 7. 서버에서 덜어 낸 책임은 브라우저와 공통 플랫폼이 맡는다. 이 역할 이동이 설계의 이점과 제약을 함께 만든다.

직접 연결이 항상 성공하는 것은 아니다

현재 공통 WebRTC 설정에는 Google STUN 서버가 있고 TURN 중계 서버는 없다. 네트워크·방화벽 조건 때문에 직접 연결이 실패하면 재시도와 안내로 대응한다. 자원 수신 경로는 12초 타임아웃과 자동 재시도 1회를 두며, 실패 후에는 수동 재시도를 제공한다. 서버에 사진을 업로드하는 대체 경로는 없다.

STUN은 연결 가능한 주소를 찾는 데 쓰이고, TURN은 직접 통신이 어려울 때 중계 경로를 제공한다. TURN을 도입하면 연결 가능성을 보완할 수 있지만, 자원 트래픽이 중계 서버를 경유하는 구조와 운영 비용을 함께 검토해야 한다. 이는 현재 구현이 아니라 이후 선택지다. WebRTC의 ICE·STUN·TURN 설명과 frontend/core/webrtc.js를 함께 보면 경계가 분명해진다.

개인 자료를 공유하는 상대는 여전히 중요하다

사진퍼즐은 서버에 사진을 맡기지 않고 같은 방의 참가자에게 직접 전달한다. 그 참가자는 자원 본문 전체를 받으므로 이미지와 장소 정답을 자신의 기기에서 확인할 수 있다. 서버를 공유 대상에서 제외하는 것과, 자료를 받은 상대의 복사·열람을 막는 것은 다른 문제다. 이 구조의 정보 처리 경계는 신뢰하는 참가자끼리 자료를 나누는 상황에 맞춰져 있다.

공유 공간은 영구 보관함이 아니다

서버는 WebSocket Hibernation API로 연결을 받고, Alarm으로 방 수명을 관리한다. 비활성 기간의 객체 실행 부담을 줄이는 방식은 Cloudflare의 WebSocket Hibernation 문서에 설명되어 있다. Direct Play는 여기에 방 수·결과 수 제한과 만료 처리를 더했다.

현재 코드에는 접속자가 없는 상태가 30분 이어지면 방을 삭제하는 정책이 있다. 별도로 설정 중인 방은 생성 후 1시간에 삭제하고, 준비된 방은 마지막 활동 후 3일에 보관 상태로 전환하며, 보관 후 7일에 삭제한다. 무접속 삭제 조건이 먼저 충족될 수 있으므로 ‘방이 3일 동안 항상 유지된다’고 해석하면 안 된다. 이 정책은 worker/utils.js와 GameRoom.alarm()에 있다.

자원을 나누는 모듈도 대용량 파일 배포기로 일반화하기에는 한계가 있다. 현재 전송은 JSON 전체를 메모리에 만들고 조각을 연속 전송하며, bufferedAmount에 따른 송신 속도 조절은 구현되어 있지 않다. 사진퍼즐의 가공된 이미지 공유를 넘어 큰 파일이나 다수 사용자로 확장하려면 별도의 검증과 보완이 필요하다.

재사용할 것은 게임방의 책임 경계다

Direct Play가 지향하는 중심 원칙은 개인정보와 민감한 자료의 공유를 참가자 기기 사이에 두고, 서버가 다루는 정보와 역할을 필요한 범위로 좁히는 것이다. 사진퍼즐의 사진·닉네임·위치는 서버를 거치지 않고 참가자끼리 직접 공유한다. 서버는 방 운영과 연결 조정에 필요한 정보만 처리한다.

공통 게임방은 이 원칙과 연결·자원 전달·결과 공유 기능을 개별 게임이 재사용할 수 있도록 만든다. 사진퍼즐에서는 브라우저가 사진을 전달하고, 레이싱에서는 방장이 세계 상태를 계산하며, 가위바위보에서는 서버가 심판이 된다. 각 게임은 공통 기반을 사용하면서 어떤 자료를 공유하고 누가 진행을 결정할지를 자신의 요구에 맞게 구현한다.

이 패턴은 초대받은 소수가 자료를 나누는 수업 도구나 임시 협업 공간에도 응용할 수 있다. 다만 이는 설계에서 도출한 활용 가능성이다. 영구 보관, 오프라인 전달, 강한 부정행위 방지가 필요한 제품이라면 저장과 판정의 책임을 다시 정해야 한다.

출처와 참고 자료

  1. Direct Play Games ↗