本地联调

平台在仓库 examples/ 目录提供完整示例游戏,每个示例都包含 backend、frontend 与 devserver 三个子目录。devserver 是本地联调环境,模拟真实平台的宿主协议、匹配与会话行为。SDK 源码包见SDK 下载。

构建与启动

# 1. 构建双 SDK,首次执行
cd sdks/game-backend-sdk && npm install && npm run build
cd sdks/game-frontend-sdk && npm install && npm run build

# 2. 构建示例游戏,GAME_DIR 换成任一示例的目录名
cd examples/$GAME_DIR/backend && npm install && npm run build && npm test
cd examples/$GAME_DIR/frontend && npm install && npm run build

# 3. 启动本地联调环境,mock 宿主、mock 匹配与 WebSocket
cd examples/$GAME_DIR/devserver && npm install && npm start
# 多开标签页即多玩家,可完整验证匹配、开局、离席托管、观战与结算

自测要点

提审前请至少覆盖以下场景:

• 单人开局、满员自动开局、人数不足补位。
• 断线重连后状态恢复,即 onSync 路径。
• 离席托管与归队夺回。
• 余额不足时 endRound 失败分支与玩家提示。
• 公平随机承诺与揭示时序。
• 定时器在会话结束时无残留。