【邮件系统】

空伊伊 · 发表于 2024-11-22 01:09:49

本帖最后由空伊伊于 2024-12-1 20:30 编辑

邮件系统

在一个游戏中，邮件往往能给玩家带来惊喜。因为有邮件，就代表着有新的更新内容，或者有新发放的奖励。但是对于服务器来说，邮件带来的负担可不小，需要小心设计。为此我编写了一个邮件系统，方便大家快速实现邮件功能。

PC上派发邮件演示

线上游戏派发邮件演示

预制体文件

邮件系统.zip (50.44 KB, 下载次数: 59)

2024-11-22 16:58 上传

点击文件名下载附件

接入步骤
1. 导入预制体
2. 将预制体拖入到主场景
3. 到 MailSystem\UI\MailUI.ts 脚本中，找到 freshAnnexByItemsData 函数，根据 itemsData 定制附件的显示内容。
4. 到 MailSystem\Module\MailModuleS.ts 脚本中，找到 net_receiveMailAnnex 函数，根据 itemsData 定制领取附件时的数据逻辑。

原理介绍
1. 系统邮件数据(SystemMailData) 与个人邮件数据(PersonalMailData)
在该邮件系统中，我定义了系统邮件与个人邮件两个不同的概念。

系统邮件数据是公共数据，所属对象是游戏，它包含了邮件本身的内容，数据量较大，所以我选择了不同的系统邮件数据，单独使用一条自定义数据来进行存储，这样不仅方便在后台管理，还可以避免单条数据超过64KB传输上限的问题。

个人邮件数据是私人数据，所属对象是玩家，它包含了一位玩家拥有多少条邮件，以及每条邮件的具体信息，数据量比较小，所以作为模块数据存储在了MailModuleData中。

2. 系统邮件数据(SystemMailData)

每条系统邮件数据有9个属性，分别是：
🔷mailID（邮件ID）：唯一值，游戏内的每条邮件ID都是不同的。（且新增邮件时，ID必须以自增的形式进行增加。这样设计可以保证玩家不会重复领取邮件）
🔶senderID（发送者ID）：这个值我在系统里没有用到，因为我演示的都是以官方身份发送邮件，所以默认不填。（如果你想实现玩家之间互发邮件，那么就可以利用这个属性）
🔷receiverID（接收者ID）：新建邮件时必填的一个属性。代码里的默认规则是，填入“233”则代表给全服玩家发送邮件；填入指定玩家的userID，则代表给指定玩家发送邮件
🔶title（邮件标题）：邮件的标题内容
🔷senderName（发送者名称）：邮件的发送者名称
🔶content（邮件内容）：邮件的主体内容（支持富文本）
🔷itemsData（附件数据）：附件数据的读取与写入规则，需要使用者自行制定。
🔶createTime（创建时间）：邮件的创建时间，是一个时间戳
🔷expiryDays（有效天数）：邮件的有效天数，当邮件达到有效天数后，邮件会自动删除，并且后续的玩家无法再收到该条邮件

3. 个人邮件数据(PersonalMailData)

个人邮件数据只有3个属性，分别是：
🔷mailID（邮件ID）：与系统邮件数据中的mailID相互对应，个人邮件也正是通过该ID来获取到真正的邮件内容。
🔶isRead（是否已读）：用来判断邮件是否处于已读状态
🔷isAnnex（附件是否已领取）：用来判断附件是否已领取

4. 邮件模块数据(MailModuleData)

邮件模块数据主要有两个数据字段，分别是：
🔷max_Received_SysMailID（个人目前接收到的最大邮件ID）：为什么使用自增的邮件ID，关键点就在于这里。当玩家上线时，这个值默认是0，于是便会向服务器请求游戏内最大的邮件ID，也就代表着游戏内最新的邮件。然后如果个人最大邮件ID小于游戏内最新的邮件ID，就需要向个人邮件列表中添加新邮件。（所以使用自增才能实现依次读取邮件，不遗漏）
🔶personalMailDataArray（个人接收到的所有邮件）：这是一个列表，存放了一位玩家所有的个人邮件数据，主要用来存储各条邮件的读取、领取信息。

5. 邮件附件数据的使用方式
在本案例中，我将邮件附件数据的填写规则制定为：物品ID_物品数量||物品ID_物品数量.... 这样的形式
显示附件时的处理方式：
在 MailUI.ts 脚本中，我们可以修改 freshAnnexByItemsData 这个函数，来处理接收到itemsData时，应该如何进行附件显示。

领取附件时的处理方式：
在 MailModuleS.ts 脚本中，可以修改 net_receiveMailAnnex 这个函数，来处理接收到itemsData时，应该如何给玩家发放指定奖励。

6.如何区分全服邮件与向指定玩家发送邮件与向指定群体发送邮件
在 MailModuleS.ts 脚本中，更新个人邮件的时候，如果receiverID的值是“233”那么所有人都可以接收到该邮件，否则就只有userID与receiverID一致的玩家才可以接收到邮件
当需要给指定玩家群体发送邮件时，只需要用 "|" 将 receiverID 进行分隔即可。例如 12345|23456

7. 设置邮件更新频率
当 MailModuleS 启动的时候，就会在服务端开启一个循环，案例中写的是每间隔10000毫秒，也就是10秒，主动更新一次邮件信息。通过设置这个间隔，可以控制邮件的更新频率