ET5 MailBoxComponent 简单介绍
根据ET5文档介绍，MailBoxComponent组件一般与Actor搭配使用，挂载该组件后，就可以通过Actor发送消息。
官方demo主要有两种使用方式：
session.AddComponent<MailBoxComponent, string>(MailboxType.GateSession);
await unit.AddComponent<MailBoxComponent>().AddLocation();
await unit.AddComponent<MailBoxComponent>()
1、这里拆分一下服务端的实体(客户端)：
玩家在客户端有Player和Unit：Player有id,只有一个自己。Unit会有多个，自己和其他人。
玩家在服务端：
Realm：只负责注册,查询和验证等功能，不会有长链接的相关处理
Gate：在网关上有Player实体:有IId,Account和UnitId--关联Map服的Unit实体。Player绑定了Session。
Map：玩家在Map服务器上有Unit实体有唯一ID，挂载UnitGateComponent组件关联GateSessionId。
2、客户端，各服务器都是不同的端，都不在一台设备上。只是用相同的UnitID，分别在这些端创建Player和Unit实例，实例上存着需要的id号来识别谁是谁和找到连接session。
session就是在不同端建立的持续通信的连接。
Client与Gate通信，网关上存着Player绑定了session，有UnitID就能找到连接session进行通信。
服务端之间，你可以在每个服务端定义一个构建和获取与其它服务端的连接session的方法。
非网关服务器＝》客户端，可以用ActorId，构建ActorMessageSender通信。
3、举例看看
在InnerMessageDispatcher中添加注释，方便查看内网中的Actor消息传递 HandleIActorMessage函数中：Log.Info("InnerMessageDispatcher内网消息转发：" + message.ActorId + "---" + entity);
3.1：Gate服务器不处理消息，直接转发消息：
注意：C2G_LoginGateHandler中 session.AddComponent<MailBoxComponent, string>(MailboxType.GateSession);当其他服务器消息发送到Gate的Session上时，消息会自动转发给前端，Gate服务器不会有相应的Handler处理该信息。
1、先注释寻路消息：G2M_CreateUnitHandler 中注释掉 await unit.AddComponent<MailBoxComponent>().AddLocation();
编译运行，
参考前端，有小人出现。说明创建小人消息发送到了前端，
3.2：Gate服务器处理消息--不直接转发。
1、调整代码 C2G_LoginGateHandler ,给Player添加个MailBox组件。
Player player = ComponentFactory.Create<Player, string>(account); player.AddComponent<MailBoxComponent>(); //新加入的代码 Game.Scene.GetComponent<PlayerComponent>().Add(player); session.AddComponent<SessionPlayerComponent>().Player = player; session.AddComponent<MailBoxComponent, string>(MailboxType.GateSession);
2、在Gate服务器中添加一个消息处理Handler
using System.Threading.Tasks; using ETModel; namespace ETHotfix { [ActorMessageHandler(AppType.Gate)] public class Actor_MatchSucess_NttHandler: AMActorHandler<Player, Actor_MatchSucess_Ntt> { protected override async ETTask Run(Player entity, Actor_MatchSucess_Ntt message) { Log.Info($"-------收到Map服务器发送的Actor消息---玩家{entity.Id}收到消息---:" + message.GamerID); await Task.CompletedTask; } } }
3、在内网中添加信息 InnerMessage.proto
在InnerMessage.proto中添加 message Actor_MatchSucess_Ntt // IActorMessage { int32 RpcId = 90; int64 ActorId = 94; int64 GamerID = 1; }
4、在Map中向Gate的Player中发送消息。G2M_CreateUnitHandler 中添加代码。
注意：这个添加的代码，ActorMessageSender 发送消息时往Player中发送，不是Session中。
await unit.AddComponent<MailBoxComponent>().AddLocation(); unit.AddComponent<UnitGateComponent, long>(request.GateSessionId); Game.Scene.GetComponent<UnitComponent>().Add(unit); response.UnitId = unit.Id; /**********添加测试代码 ********/ //测试给Gate服务器发送Actor消息 // 注意,Gate中Player必须 await player.AddComponent<MailBoxComponent>().AddLocation(); ActorMessageSenderComponent actorLocationSenderComponent = Game.Scene.GetComponent<ActorMessageSenderComponent>(); //这里是发送到Session实体,会直接转发到前端--需要调整Actor_MatchSucess_Ntt,OuterMessage.proto中添加消息体 // ActorMessageSender actorMessageSender = actorLocationSenderComponent.Get(request.GateSessionId); //这里是发送到Player,Gate有相关Handler处理,不会直接转发 ActorMessageSender actorMessageSender = actorLocationSenderComponent.Get(request.PlayerId); actorMessageSender.Send(new Actor_MatchSucess_Ntt(){GamerID = 32435}); /**********添加测试代码 ********/
5、编辑运行
4、总结
同样是Actor消息，有的是发送给Gate，有的是发送给前端。其实都是发送给了Gate，当信息发送给Session时，Gate会直接转发给前端，因为Session挂载MailBox时添加了MailBoxType.GateSession类型，使用会直接转发。Player挂载MailBox时，没有加类型，使用会转发到相关Handler里进行处理。
至于Player挂载MailBox两种方式 player.AddComponent<MailBoxComponent>(); 和 await player.AddComponent<MailBoxComponent>().AddLocation(); 个人理解：后面加AddLocation，会将实体加入到Location服务器中，方便发送 IActorLocationMessage 这种带 Location的消息--这种消息可能会在Location服务器中查询用户。
所以不论多少个端，Client，Gate，Map，Realm，只是在每个端都创建了同样UnitId的Player实例，和用同样UnitD创建的Unit实例，每一个玩家就像在每个端都有分身或影子，玩家的分身之间把消息传来传去，改变着玩家的状态。
另外，各类服务器（主要指map）也可以通过网关上客户端与网关的session连接，给一群玩家的本尊客户端广播消息。
注：Realm只需要认证账号，不需要分身
Demo中的这几大实例id，就是几种实体（Entity）的InstanceId
Player，Session，Unit
- actorsender在构建时，传入一个实体的实例id，就可以给这个实体的实例发消息，不论他在哪个服务器。--例子中player加MailBox
- 只要有session，player，unit 的实例id就能给他们发actor消息。
- 而通过session的实例id给用户的网关session发actor消息，session会给你转发给客户端（用户的网关sesion正是网关与客户端的连接session）。
参考内容：https://www.taikr.com/course/1053/task/30966/show
https://github.com/egametang/ET/blob/master/Book/5.4Actor%E6%A8%A1%E5%9E%8B.md
https://www.lfzxb.top/etbook/#54-actor%E6%A8%A1%E5%9E%8B
