게임 시작하기
여러 사람이 브라우저나 휴대폰으로 함께 하는 실시간 게임, 퀴즈, 투표를 만듭니다. 클라이언트는 입력만 보내고, 점수와 승패는 서버 안의 호스트(server.host)가 정합니다. 처음이라면 핵심 개념 5분 요약을 먼저 읽으세요.
1. 설치
게임은 자기 IOSignal 서버에서 돌립니다. 호스트는 서버 프로세스 안에서 실행되므로 공개 서버(io.iosignal.net)에는 올릴 수 없습니다. Node.js 22.16.0 이상에서 패키지 하나로 서버와 브라우저 클라이언트를 함께 씁니다.
npm install iosignal
서버 코드는 import { Server } from 'iosignal', 브라우저 화면은 import IO from 'iosignal/io'를 씁니다.
2. 첫 연결: Host Quiz
Host Quiz 예제는 문제 진행과 채점을 서버 안의 호스트가 맡는 실시간 퀴즈입니다.
git clone https://github.com/remocons/iosignal-examples.git
cd iosignal-examples/iosignal_host-quiz
npm ci
npm start
http://localhost:5181을 두 창 이상에서 열고 퀴즈를 풉니다. 두 창의 점수판이 같이 바뀌면 성공입니다. 화면의 위조해 보기로 점수판을 위조해 보고 서버가 버리는 것도 확인하세요.
3. 게임에서 다른 점
- 판정은 서버에서: 일반 채널에서는 누구나 어떤 채널에든 보낼 수 있고 보낸 사람도 붙지 않습니다. 호스트는 입력마다 서버가 확인한 보낸 사람(
from.cid)을 받고, 점수판 같은 태그는 호스트만 보내게 막습니다. 서버 안의 게임 로직 - 입력 속도는 쿼터 안에서: 연결마다 초당 메시지·바이트 한도가 있고, 넘는 입력은 알림 없이 버려집니다. 프레임마다 보내지 말고 바뀔 때나 정해진 주기로 보냅니다. 쿼터와 제한
- 상태 방송: 모두가 보는 상태는
host.publish('game#$state', …)로 보냅니다.$가 있으면 서버가 마지막 값을 보관해 늦게 들어온 화면도 바로 받습니다. 한 사람에게만 가는 결과는host.to(cid, …)로 보냅니다. - 재접속과 이탈: 익명 연결은 다시 접속하면 CID가 바뀌어 새 참가자가 됩니다. 같은 사람으로 이어 가려면 인증을 씁니다. 입력을 보낸 연결이 끊기면 호스트에
leave가 옵니다. - 메시지 크기: 한 메시지의 최대 크기는 서버가 정하고, 클라이언트는
ready뒤io.quota.maxMessageBytes로 읽습니다. 상태는 짧게 유지합니다. - 서버 여러 대: 호스트는 자기 서버에 붙은 연결만 봅니다. 한 방의 참가자는 같은 서버에 접속해야 합니다.
- 보드도 참가 가능: Arduino도 같은 태그로 입력을 보내고
onMessage로 결과를 받을 수 있습니다.
4. 만들기 가이드
| 하고 싶은 것 | 문서 |
|---|---|
| 호스트 등록, 입력 받기, 상태 방송 | 서버 안의 게임 로직 |
| 틱 간격, 입력 수, 위조 차단을 실시간으로 보기 | 서버 대시보드 |
| 브라우저 화면의 연결·구독 | 브라우저 시작하기, JS 구독과 수명주기 |
| 서버 옵션, 쿼터, 호스트 메서드 | 서버 API |
| 서버를 다른 기기·인터넷에 열기 | 서버 시작하기 |
5. 예제
- Host Quiz: 서버가 채점하는 퀴즈, 위조 차단, 대시보드
6. 막혔을 때
- 화면이 서버에 붙지 않으면 연결 진단
- 입력이 호스트에 오지 않으면 그 태그가 호스트의
inbound에 있는지, 쿼터를 넘지 않았는지 확인합니다. 서버의server.stats()와 대시보드에서 버려진 입력 수를 볼 수 있습니다.