Netcode for GameObjects Boss Room 多人RPG战斗(19)

ActionPlayers

ActionPlayers是Boss Room项目中负责管理和执行动作(Action)的核心组件，分为客户端和服务器端两个版本，分别处理动作的视觉表现和逻辑执行。

1. 系统架构

1.1 核心组件

1.2 关键依赖

• ActionFactory：负责Action对象的创建和回收，实现对象池机制
• Action：所有具体动作的基类，定义了动作的基本接口和行为
• ClientCharacter/ServerCharacter：动作的执行主体，提供角色状态和能力

2. ClientActionPlayer

2.1 核心功能

2.1.1 动作生命周期管理

• OnUpdate()：每帧更新所有正在播放的动作，处理动作的结束、超时和取消
• PlayAction()：播放服务器确认的动作，处理与预期动作的衔接
• CancelAllActions()：取消所有正在播放的动作

2.1.2 动作预期机制

• AnticipateAction()：在客户端预期执行动作，减少网络延迟的感知
• 预期超时保护：预期动作如果超过1秒未得到服务器确认，将被取消
• 动作衔接：当服务器确认的动作到达时，与预期动作无缝衔接

publicvoidAnticipateAction(refActionRequestDatadata){if(!ClientCharacter.IsAnimating()&&Action.ShouldClientAnticipate(ClientCharacter,refdata)){varactionFX=ActionFactory.CreateActionFromData(refdata);actionFX.AnticipateActionClient(ClientCharacter);m_PlayingActions.Add(actionFX);}}

2.2 工作流程

1. 客户端检测到输入，立即调用AnticipateAction()创建预期动作
2. 同时将动作请求发送到服务器
3. 每帧更新预期动作，直到超时或收到服务器确认
4. 收到服务器确认后，调用PlayAction()处理实际动作
5. 如果预期动作与实际动作匹配，直接转换；否则创建新动作

3. ServerActionPlayer

3.1 核心功能

3.1.1 动作队列管理

• PlayAction()：将新动作添加到队列或中断现有动作
• 队列深度控制：限制队列最大执行时间，防止动作堆积
• 动作优先级：支持高优先级动作中断低优先级动作

3.1.2 自动辅助动作合成

• SynthesizeChaseIfNecessary()：自动生成追逐动作，确保角色移动到攻击范围内
• SynthesizeTargetIfNecessary()：自动生成目标选择动作，更新角色的当前目标

privateintSynthesizeChaseIfNecessary(intbaseIndex){ActionbaseAction=m_Queue[baseIndex];if(baseAction.Data.ShouldClose&&baseAction.Data.TargetIds!=null){ActionRequestDatadata=newActionRequestData{ActionID=GameDataSource.Instance.GeneralChaseActionPrototype.ActionID,TargetIds=baseAction.Data.TargetIds,Amount=baseAction.Config.Range};baseAction.Data.ShouldClose=false;ActionchaseAction=ActionFactory.CreateActionFromData(refdata);m_Queue.Insert(baseIndex,chaseAction);returnbaseIndex+1;}returnbaseIndex;}

3.1.3 动作执行与状态管理

• StartAction()：开始执行队列中的第一个动作
• OnUpdate()：更新所有动作的状态，处理动作的转换和结束
• UpdateAction()：检查动作是否应该继续执行或结束
• AdvanceQueue()：推进动作队列，处理动作的结束和下一动作的开始

3.1.4 冷却时间与重用逻辑

• IsReuseTimeElapsed()：检查动作是否已经过冷却时间
• m_LastUsedTimestamps：记录每个动作的最后使用时间

3.2 工作流程

1. 服务器接收客户端的动作请求
2. 检查动作是否可以执行（冷却时间、资源等）
3. 将动作添加到队列或中断现有动作
4. 自动合成必要的辅助动作（如追逐、目标选择）
5. 开始执行队列中的第一个动作
6. 每帧更新动作状态，处理动作的结束和转换
7. 当动作完成或超时，推进队列执行下一个动作

4. 关键设计模式与优化

4.1 对象池模式

• ActionFactory：使用对象池管理Action对象的创建和回收
• 性能优化：减少频繁创建和销毁对象带来的性能开销

4.2 状态机模式

• Action状态管理：每个Action都有自己的状态转换逻辑
• 动作队列：ServerActionPlayer使用队列实现动作的顺序执行和状态转换

4.3 网络延迟优化

• 客户端预期：在客户端提前执行动作，减少网络延迟的感知
• 无缝衔接：预期动作与服务器确认动作的无缝转换
• 超时保护：防止预期动作无限期存在

5. 协同工作流程

客户端输入 → ClientInputSender.RequestAction() → ClientActionPlayer.AnticipateAction() → 发送动作请求到服务器 → ServerActionPlayer.PlayAction() → 动作执行 → 服务器广播动作结果 → ClientActionPlayer.PlayAction() → 替换预期动作

6. 代码优化建议

6.1 ClientActionPlayer优化

1. 预期动作管理增强

   // 优化前booltimedOut=action.AnticipatedClient&&action.TimeRunning>=k_AnticipationTimeoutSeconds;// 优化后booltimedOut=action.AnticipatedClient&&action.TimeRunning>=k_AnticipationTimeoutSeconds;if(timedOut){// 记录预期超时，用于网络质量分析Debug.LogWarning($"Action{action.ActionID}anticipation timed out");}

2. 动作优先级支持

   // 新增方法：按优先级播放动作publicvoidPlayActionWithPriority(refActionRequestDatadata,intpriority){// 根据优先级决定是否中断现有动作// ...}

6.2 ServerActionPlayer优化

1. 队列深度动态调整

   // 优化前privateconstfloatk_MaxQueueTimeDepth=1.6f;// 优化后privatefloatm_MaxQueueTimeDepth=1.6f;// 根据网络延迟动态调整队列深度publicvoidAdjustQueueDepthBasedOnLatency(floatlatency){m_MaxQueueTimeDepth=Mathf.Clamp(1.0f+latency*0.5f,1.0f,3.0f);}

2. 动作执行统计

   // 新增字段：动作执行统计privateDictionary<ActionID,int>m_ActionExecutionCount=newDictionary<ActionID,int>();// 在StartAction()中记录m_ActionExecutionCount.TryGetValue(m_Queue[0].ActionID,outintcount);m_ActionExecutionCount[m_Queue[0].ActionID]=count+1;

7. 总结

ActionPlayers系统是Boss Room项目中动作管理的核心组件，通过客户端预期和服务器权威执行的结合，实现了低延迟的动作响应和一致的游戏状态。ClientActionPlayer专注于提供流畅的视觉反馈，而ServerActionPlayer负责确保游戏逻辑的正确性和一致性。

该系统的关键设计亮点包括：

• 客户端预期机制减少网络延迟感知
• 自动辅助动作合成简化玩家操作
• 对象池模式提高性能
• 灵活的动作队列管理支持复杂的游戏机制

通过这些设计，ActionPlayers系统为Boss Room项目提供了一个强大、灵活且高效的动作执行框架。

ClientActionPlayer.cs

1. 类概述

ClientActionPlayer是Boss Room项目中负责客户端动作可视化与生命周期管理的核心组件，与ServerActionPlayer对应，专注于提供流畅的视觉反馈和减少网络延迟感知。

publicsealedclassClientActionPlayer{privateList<Action>m_PlayingActions=newList<Action>();privateconstfloatk_AnticipationTimeoutSeconds=1;publicClientCharacterClientCharacter{get;privateset;}// ...}

2. 核心功能与设计

2.1 动作生命周期管理

OnUpdate()- 核心更新方法，每帧处理所有正在播放的动作：

publicvoidOnUpdate(){// 逆向遍历以便安全地在循环中移除元素for(inti=m_PlayingActions.Count-1;i>=0;--i)