这是我对基于 LeanCloud 实现 卡牌对战游戏 的一个实践，卡牌对战游戏具有回合制（没有并发动作）和非对称博弈（看不到其他玩家手牌）的特点。在完成这个项目之前我对游戏（服务器端）开发几乎完全没有概念，很多实践是我「独立发现」的，所以可能并不能代表游戏开发者的习惯和最佳实践。
目前实现了「斗地主」规则的一个子集，每局游戏有三个玩家参与，支持：单子、对子、三不带、三带一、三带二、炸弹、单顺、双顺；不支持：大小王、叫地主、抢地主、四带一、四带二、飞机。
目前有两种实现：
realtime分支：基于 LeanCloud 实时通信服务 实现play分支：基于 LeanCloud 游戏解决方案 实现，线上版本在 play-cards.leanapp.cn
每种实现都同时支持「动作同步（帧同步）」和「状态同步（C/S 同步）」，服务器端会创建一个 masterClient 参与每局游戏。
演示视频：https://streamable.com/belpq
common -- 公共模块（客户端、服务器共用）
├── game.ts -- 游戏业务逻辑
└── types.ts
browser-client -- 客户端项目
├── app.tsx -- 客户端入口、界面
└── client-sync.ts -- 客户端同步逻辑
master-client -- 服务器项目
├── server-sync.ts -- 服务器同步逻辑
└── server.ts -- 服务器入口、房间匹配
除 UI 外主要代码都在 game.ts 中，包括游戏规则、游戏状态、游戏动作的管理；同步逻辑（{client,server}-sync.ts）中同时实现了动作同步和状态同步，只要在服务器和客户端各改一行代码即可切换，其中的代码也并不多。
启动项目：
npm install
npm run build
lean up然后可以在浏览器中开三个窗口来分别模拟三个客户端。
- 客户端（Browser Client）和服务器（Play Server Contianer）都通过 WebSocket 连接到实时通讯或 Play（RTM Server）
- 服务器负责创建房间，并在每个房间设置一个 masterClient 参与游戏
- 客户端通过 HTTP 调用服务器来匹配并加入房间
common/game.ts 中导出了一个 Game 类，是对游戏核心逻辑的封装，包括游戏业务逻辑（扑克的规则）和游戏状态（State）、游戏动作（Action）的管理，这个类会同时运行于客户端和服务器。
// 事件：action（当前玩家的动作）、stateChanged（游戏状态变化）、error
class Game extends EventEmitter {
constructor(seed: string, players: Player[]);
// 获取游戏状态（供 UI 调用）
public getState(player: Player): GameState;
// 设置游戏状态（状态同步时设置服务器发来的状态）
public setState(player: Player, state: GameState);
// 当前玩家执行动作
public performAction(action: GameAction);
// 应用其他玩家的动作（动作同步时）
public applyAction(action: GameAction);
}
至于游戏业务逻辑，其实主要就是「一组牌能否管上另一组牌」：
function ableToUseCards(playerCards: Card[], playingCards: Card[]): boolean {}
function ableToBeatCards(previousCards: Card[], playingCards: Card[]): boolean {}
function isSoloOrPairCards(playingCards: Card[]): boolean {}
function isTrioCards(playingCards: Card[]): boolean {}
function isChainCards(playingCards: Card[]): boolean {}
function isBomb(playingCards: Card[]): boolean {}
function ableToPlaySoloOrPairCards(previousCards: Card[], playingCards: Card[]): boolean {}
function ableToPlayTrioCards(previousCards: Card[], playingCards: Card[]): boolean {}
function ableToPlayChainCards(previousCards: Card[], playingCards: Card[]): boolean {}
function ableToPlayBomb(previousCards: Card[], playingCards: Card[]): boolean {}
GameState 是对游戏状态的描述，包括自己的手牌、每个玩家的手牌数量、前一次出牌的玩家和牌、当前轮到哪个玩家等：
export interface GameState {
players: Player[]
playersCardsCount: PlayersCardsCount
myCards: Card[]
previousCards: Card[]
previousCardsPlayer?: Player
currentPlayer?: Player
winer?: Player
}
GameAction 是对游戏动作的描述，这个游戏中只有两种动作：出牌和放弃出牌：
type GameAction = PlayCardsAction | PassAction
interface PlayCardsAction {
action: 'playCards'
player: Player
cards: Card[]
}
interface PassAction {
action: 'pass'
player: Player
}
其实这个项目的重点就是游戏的数据同步，client-sync.ts 和 server-sync.ts 中分别是客户端和服务器的数据同步逻辑，其中的函数名是一一对应的：
- actionSyncController 实现的是「动作同步（帧同步）」，这种模式下客户端发送动作（Action），服务器只转发动作，游戏逻辑主要在客户端运行，客户端掌握所有的数据（包括其他玩家的手牌）。
- statusSyncContorller 实现的是「状态同步（C/S 同步）」，这种模式下客户端发送动作（Action），服务器运行游戏逻辑后，转发计算后的游戏状态（State），游戏逻辑主要在服务器运行，客户端只做展现，只掌握自己的手牌。
客户端的工作：
game.on('action')时，转发用户动作到服务器play.sendEvent(action)play.on('customEvent')时，应用其他玩家的动作game.applyAction(action)
服务器的工作：
- 创建一个 Room，生成 randomSeed，有新玩家加入时发送玩家列表和 randomSeed
客户端的工作：
game.on('action')时，转发用户动作到服务器play.sendEvent(action)play.on('customEvent')时，应用服务器发来的游戏状态game.setState(state)
服务器的工作：
- 创建一个 Room，生成 randomSeed，有新玩家加入时发送玩家列表
play.on('customEvent')时，在游戏对象上执行动作game.performAction(action)game.on('stateChanged')时，给每一个玩家发送最新的状态play.sendEvent(state)
master-client/server.ts 中的 POST /join 实现了一个非常 简易 的自定义房间匹配，会在内存中记录请求匹配的玩家（并将请求挂起），待凑齐 3 个玩家后再给玩家响应创建好的房间名字，让客户端加入房间。
云引擎的 HTTP 连接有 60 秒的超时，所以客户端会在收到 504 的超时错误后用同一个 playerName 重试 POST /join。
- 动作同步（未实现）：需要服务器记录每个房间的全部动作，在客户端重连后发给客户端断线期间的动作或全部动作。
- 状态同步（已实现）：客户端重连后，服务器发送一次游戏状态数据。
这里的断线重连不仅是网络断开，也包括客户端重启（这意味着所有状态都丢失了）。