co1lin/landlords

The classic Chinese card game Landlords. An assignment for Qt network programming, in summer term 2020.

Landlords

The classic Chinese card game Landlords. An assignment for Qt network programming, in summer term 2020.

工作流程

操作流程

1. 用户选择工作模式：“开设房间等待他人进入”或“连接他人开设的房间”。
   （1）开设房间者可以更改默认的监听端口，可以从列表复制合适的本机IP给其它玩家方便连接。
   （2）连接他人者可以设置他人开设的房间的IP和端口号。

2. 开设房间者点击开始监听，根据配置正式创建房间，随后其它玩家配置相关信息后点击连接。三人连接成功后共同跳转到游戏界面，开始游戏。

实现逻辑与细节

1. 通信协议：TCP （全部）
2. 采用C/S模式。建立连接的流程如下：
   （1）开设房间者点击开设房间之后，会建立一个TCP Server，监听指定端口的连接。同时也会建立一个TCP Socket，作为本地玩家与本地服务器的通信接口。
   （2）连接他人所创房间者点击开设房间之后，会建立一个TCP Socket，连接开设房间者建立的TCP Server。
   于是三名玩家共同连接到了一个TCP Server上，完成了连接。通过TCP Server，他们之间可以交换数据进行通信。
3. 为了解决TCP通信的“粘包”问题，实现了接收和发送数据的函数，分别为MyTools::send和MyTools::read。
   发送函数中，为了适应不同运行环境，先将数据转换为大端字节序；然后在写入的QByteArray中预留一个固定长度的变量的位置用于保存之后写入的数据的长度。
   接收函数中，首先读取接收到的的数据包前面的长度信息。如果此信息没有读到，则等待下次有新数据到达时再读入。如果读到了数据的大小信息，就往下读取固定长度的数据，通过一些判断保证正确读取每一次发送的信息，而不会”漏读“或”读串“。
   此外，为了各阶段通信处理的方便性与统一性，实现了一个自定义类DataPackage作为数据通信的“载体”。
4. 显示界面主要采用Graphics View Framework，实现手牌、桌上的牌、底牌、其它玩家的信息的显示以及相关动态效果。其中使用了HTML、QSS等技术美化视觉效果。
5. 游戏规则实现： 服务器通过TCP通信告知玩家是否出牌，以及场上的必要信息，比如上次其它玩家出的牌。收到数据后，客户端允许玩家出牌，在确认出牌时通过自己实现的检测函数检测出牌是否合法（包括出牌本身是否合法、出牌是否能大过上家的牌）。如果合法则成功出牌，将出牌信息发送给服务器。服务器收到后更新状态，并将场上最新状态告知所有玩家，同时通知下一位玩家出牌，以此循环。
   当一位玩家在场上其它玩家之前出完所有牌后，其客户端向服务器发送相应信息。服务器确认后告知所有玩家本场游戏结局。三位玩家的客户端收到结局后显示是否重新开始的选择。若选择重新开始，则重新开始游戏，重新发牌，等等。若选择No，则退出游戏程序。
   至于出牌是否合法的判断方法，在此做简要介绍：主体部分为判断牌型的函数；在判断牌型之后，若牌型合法，且需要与上家牌比较大小，只需要比较“关键牌”即可。判断牌型的算法主要是统计每张牌出现了多少次；根据有几张牌都出现了同样的次数，即可确定“关键牌”，进行初步筛选，然后对剩余牌进行与“关键牌”的匹配，看是否能匹配成功，经过一系列条件判断，最后得出相应的牌型。