房卡麻将分析系列 "牌局回放" 之 数据设计
最近几个月，”房卡“棋牌游戏成为了资本追逐的热点，基于微信的广大用户和社交属性，”房卡”棋牌发展迅速。红孩儿团队因为之前几年有过相关项目的经验积累，鉴于未来广阔的地方棋牌市场和”开发间“机制的发展前景，也开始转向基于”开房间“棋牌游戏的项目开发中。为了更好的与开发者进行交流学习，特开设”房卡麻将游戏分析系列“。
红孩儿团队研发的"大赢家"红中麻将
本套麻将分析基于网络上流传的“网狐”房卡麻将源码做为基础，按照功能模块分为"架设指南",”服务器框架","后台系统","胡牌算法","客户端界面"，“防作弊功能”等等细节做一些分析和指导，帮助广大的棋牌游戏开发者迅速掌握“房卡”麻将的研发原理和技巧设计。也希望有兴趣的朋友多多关注。
第一次开公众号，挑个简单的下手，先来讲一讲房卡麻将中一个重要功能：“牌局回放”，我们都知道，棋牌类游戏注重公平真实不作弊，如果玩家感觉到游戏的过程有作弊，我相信他一定会对这款游戏失去兴趣。但作弊与否，玩家并不容易进行判断。这时候提供一个“牌局回放”功能给玩家进行分析就尤为重要。
“网狐”等一些长期耕耘在棋牌领域的企业，在这方面都有完整的经验和框架，通过参考，我发现它是通过下面一套流程来完成”牌局回放“功能的。
首先，在游戏服务器的房间类CTableFrameSink里需要有一个GameRecord结构，这个结构对 玩家信息，手牌以及每一步的动作都可以进行相应的记录：
struct GameRecordPlayer { DWORD dwUserID; std::string kHead; std::string kNickName; std::vector<BYTE> cbCardData; void StreamValue(datastream& kData, bool bSend) { Stream_VALUE(dwUserID); Stream_VALUE(kHead); Stream_VALUE(kNickName); Stream_VECTOR(cbCardData); } }; struct GameRecordOperateResult { enum Type { TYPE_NULL, TYPE_OperateResult, TYPE_SendCard, TYPE_OutCard, TYPE_ChiHu, }; GameRecordOperateResult() { cbActionType = 0; wOperateUser = 0; wProvideUser = 0; cbOperateCode = 0; cbOperateCard = 0; } BYTE cbActionType; WORD wOperateUser; //操作用户 WORD wProvideUser; //供应用户 BYTE cbOperateCode; //操作代码 BYTE cbOperateCard; //操作扑克 void StreamValue(datastream& kData, bool bSend) { Stream_VALUE(cbActionType); Stream_VALUE(wOperateUser); Stream_VALUE(wProvideUser); Stream_VALUE(cbOperateCode); Stream_VALUE(cbOperateCard); } }; struct GameRecord { std::vector<GameRecordPlayer> kPlayers; std::vector<GameRecordOperateResult> kAction; void StreamValue(datastream& kData, bool bSend) { StructVecotrMember(GameRecordPlayer, kPlayers); StructVecotrMember(GameRecordOperateResult, kAction); } void CleanUp() { kPlayers.clear(); kAction.clear(); } };
在datastream.h中，有一套set,get数据流的宏，能够将数据放入到数据流中或从中拿出。
#define Stream_VALUE(Name) \ if(bSend) \ { \ kData.pushValue(Name);\ }\ else\ {\ kData.popValue(Name);\ }\
好了，有了这样一个结构，在游戏开始的时候，我们就可以开始记录本局了。
//游戏开始 void CTableFrameSink::GameStart() { ... //填充四个玩家的基础信息 for (int i = 0; i < 4; i++) { GameRecordPlayer tNewRecordPlayer; tagUserInfo * tpUserInfo = m_pITableFrame->GetTableUserItem(i)->GetUserInfo(); tNewRecordPlayer.dwUserID = tpUserInfo->dwUserID; tNewRecordPlayer.kNickName = tpUserInfo->szNickName; //取得手牌信息 BYTE cbCardData[MAX_COUNT]; m_GameLogic.SwitchAllToCardData(m_cbCardIndex[i], cbCardData); for (int j = 0; j < MAX_COUNT ; j++) { tNewRecordPlayer.cbCardData.push_back(cbCardData[j]); } //存储到当前记录结构中的玩家信息容器。 m_sGameRecord.kPlayers.push_back(tNewRecordPlayer); } }
然后我们开始记录操作，分别在玩家出牌，以及玩家应答吃，碰，杠，胡等操作时加入记录。
//用户出牌 bool CTableFrameSink::OnUserOutCard(WORD wChairID, BYTE cbCardData) { ... //记录动作数据 GameRecordOperateResult tNewRecordOperateResult; tNewRecordOperateResult.cbActionType = GameRecordOperateResult::TYPE_OutCard; tNewRecordOperateResult.cbOperateCard = cbCardData; tNewRecordOperateResult.cbOperateCode = WIK_NULL; tNewRecordOperateResult.wOperateUser = wChairID; tNewRecordOperateResult.wProvideUser = wChairID; m_sGameRecord.kAction.push_back(tNewRecordOperateResult); ... }
//用户操作 bool CTableFrameSink::OnUserOperateCard(WORD wChairID, BYTE cbOperateCode, BYTE cbOperateCard) { ... //记录动作数据 GameRecordOperateResult tNewRecordOperateResult; tNewRecordOperateResult.cbActionType = XZDDGameRecordOperateResult::TYPE_OperateResult; tNewRecordOperateResult.cbOperateCard = cbOperateCard; tNewRecordOperateResult.cbOperateCode = cbOperateCode; tNewRecordOperateResult.wOperateUser = wChairID; tNewRecordOperateResult.wProvideUser = m_wProvideUser; m_sGameRecord.kAction.push_back(tNewRecordOperateResult); ... }
就这样，基本的操作记录也完成了。最后当牌局结束时，我们需要将记录提交到数据库中。
//游戏结束 bool CTableFrameSink::OnEventGameConclude(WORD wChairID, IServerUserItem * pIServerUserItem, BYTE cbReason) { switch (cbReason) { case GER_NORMAL: //常规结束 { ... //将记录转化为数据流。 datastream kDataStream; m_sGameRecord.StreamValue(kDataStream, true); //除去写分等处理，这里最后一个参数即是数据流。 m_pITableFrame->WriteTableScore(ScoreInfoArray, CountArray(ScoreInfoArray), kDataStream); ... } } }
在私人场服务器中，会通过WriteTableScore这个函数调用PrivateTableInfo的writeSocre，它将将数的流记录下来。
并最终在牌局结束时DismissRoom(pTableInfo);发给了数据库。
数据库最终会通过一个存储过程的执行完成将数据流入库的工作。具体的代码就不再展示了，大家可以参考
CDataBaseEngineSink::OnRequestPrivateGameRecord(）。
这样一套完整的回放数据流程就结束了。
好，今天的分析就到这里，红孩儿欢迎大家下次继续听课哦~
感谢阅读，希望能帮助到大家，谢谢大家对本站的支持！