WhileAI에
내 게임 연결하기

게임은 최초 한 번만 전역 message에서 연결을 받고, 이후에는 넘겨받은 전용 MessagePort로만 통신합니다.

window.addEventListener("message", (event) => {
  const message = event.data;
  if (
    port || event.source !== window.parent ||
    event.ports.length !== 1 ||
    message?.source !== "whileai.host" ||
    message?.protocol !== "whileai.game" ||
    message?.version !== 1 || message?.type !== "connect"
  ) return;

  channel = message.channel;
  port = event.ports[0];
  port.onmessage = ({ data }) => handleCommand(data);
  port.start();
  send("ready", {
    sdkVersion: "1.0.0",
    capabilities: ["pause", "resume"],
  });
});

호스트 명령 처리

function handleCommand(message) {
  if (!validHostMessage(message)) return;
  receivedSeq = message.seq;

  if (message.type === "start") {
    runId = message.payload.runId;
    game.start();
    acknowledge(message, "running");
  } else if (message.payload?.runId !== runId) {
    return;
  } else if (message.type === "pause" && state === "running") {
    game.pause();
    acknowledge(message, "paused");
  } else if (message.type === "resume" && state === "paused") {
    game.resume();
    acknowledge(message, "running");
  }
}

send("score", {
  runId,
  score: 1200,
});

send("gameOver", {
  runId,
  score: finalScore,
});

• ✓ 진행 중 score는 0–100,000,000 사이의 안전한 정수
• ✓ 최종 gameOver 점수는 랭킹 저장을 위해 1 이상
• ✓ 일시정지 중에는 score를 전송하지 않음
• ✓ 새 게임 시작 시 이전 오브젝트와 점수를 완전히 초기화

1. 01
   로그인 후 + 게임 추가

   이름, slug, 소개, 실행 URL과 랭킹 정렬을 입력합니다.

2. 02
   연결 검사 실행

   미리보기 안에서 직접 플레이해 첫 점수와 게임 종료를 발생시킵니다.

3. 03
   여섯 단계 확인

   ready → start → score → pause → resume → 새 score → gameOver 순서와 1점 이상의 최종 점수를 검사합니다. 플레이 입력을 기다리는 각 단계는 60초 안에 완료하세요.

4. 04
   HTTPS URL 공개

   모든 항목을 통과하면 공개 버튼이 활성화되고 게임 목록과 랭킹에 추가됩니다.

복사 가능한 전체 구현은 프로젝트의 examples/game-sdk-starter/game.js, 저장용 상세 문서는 docs/ADDING_A_GAME.md에 있습니다.