1. 项目概述与核心价值在Unity游戏开发中NPC非玩家角色的行为逻辑是构建沉浸式世界的关键。一个常见的需求是让NPC能够按顺序执行一系列任务比如巡逻、对话、拾取物品、返回原位。新手开发者可能会用一堆if-else或者Invoke来硬编码结果就是代码臃肿、难以维护一旦任务需要动态调整或取消就会陷入混乱。这正是任务队列Task Queue大显身手的地方。这个项目就是教你如何利用C#中的QueueT数据结构为NPC构建一个清晰、灵活、可扩展的任务队列系统。它不仅仅是把任务排个队那么简单而是关乎游戏逻辑的“解耦”与“可控性”。想象一下你的NPC可以接收来自事件系统、玩家交互或脚本触发的任务然后有条不紊地执行中途还能被打断、插入新任务或者清空队列。这种能力对于制作复杂的RPG任务链、RTS单位的指令序列或是模拟经营类游戏中的工人AI都至关重要。我将带你从零开始理解为什么用Queue如何设计一个通用的任务基类再到实现一个健壮的NPC任务调度器最后附上可以直接粘贴进你项目的完整代码。无论你是刚接触Unity的初学者还是想优化现有AI系统的开发者这套方案都能让你对游戏逻辑的架构有新的认识。2. 核心思路与架构设计2.1 为什么选择Queue在数据结构中队列Queue遵循“先进先出”FIFO原则。这完美契合了“任务队列”的直观需求先来的任务先执行。C#的System.Collections.Generic.QueueT提供了Enqueue入队、Dequeue出队、Peek查看队首等高效操作时间复杂度都是O(1)性能上完全满足游戏每帧更新的需求。对比其他方案List/数组虽然也能模拟但需要手动管理索引在移除已完成任务时可能涉及元素移动O(n)复杂度不如Queue纯粹和高效。LinkedList虽然插入删除快但用于简单的顺序执行任务显得有点“杀鸡用牛刀”且Queue的API更简洁直观。协程Coroutine链用yield return串联协程可以实现顺序执行但难以实现动态的任务管理如中途插入、跳过一个任务。将协程作为任务封装进Queue则可以兼顾顺序执行和灵活管理。因此我们的核心思路是用一个QueueITask来存储等待执行的任务一个ITask类型的当前任务变量来跟踪正在执行的任务然后在NPC的Update或协程中驱动这个状态机。2.2 系统架构设计一个健壮的任务队列系统需要以下几个核心部分任务接口ITask定义所有任务必须实现的方法如Start(),Update(),IsFinished属性等。这是实现多态的关键允许队列里存放巡逻、移动、动画等各种不同类型的任务。具体任务类实现ITask接口。例如MoveToTask移动到某点、WaitTask等待一段时间、PlayAnimationTask播放动画、CustomActionTask执行一个委托方法。每个任务类只关心自己的逻辑。任务队列管理器TaskQueueManager这是系统的大脑。它内部维护着任务队列QueueITask和当前任务ITask currentTask。提供EnqueueTask添加任务、ClearQueue清空队列、Pause/Resume暂停/恢复等公共方法并在Update中驱动任务的执行与切换。NPC控制器持有TaskQueueManager实例并根据游戏逻辑如触发区域、事件向管理器中添加任务。这种架构的优势在于解耦NPC的行为逻辑控制器与具体任务执行管理器分离与任务的具体实现具体任务类分离。灵活可以随时动态地添加、取消、清空任务。可扩展要新增一种任务类型只需创建一个实现ITask的新类即可无需修改队列管理器或NPC控制器。可调试可以方便地打印当前队列内容或任务执行状态。3. 核心代码实现与解析下面我们一步步实现这个系统。我会先给出关键代码片段并加以解释最后提供完整的、可运行的代码。3.1 定义任务接口ITask.cs这是所有任务的契约。我们设计一个简单的状态机任务开始、持续更新、结束。// ITask.cs public interface ITask { /// summary /// 任务是否已经完成 /// /summary bool IsFinished { get; } /// summary /// 当任务被设置为当前任务时调用用于初始化 /// /summary void OnStart(); /// summary /// 每帧更新任务逻辑 /// /summary void OnUpdate(); /// summary /// 当任务完成或被迫中断时调用用于清理资源 /// /summary void OnFinish(); }设计要点IsFinished属性让管理器知道何时切换到下一个任务。OnStart、OnUpdate、OnFinish构成了任务的生命周期钩子清晰明了。3.2 实现具体任务类示例我们实现两个最常用的任务移动任务和等待任务。// MoveToTask.cs using UnityEngine; using UnityEngine.AI; // 假设我们使用NavMeshAgent进行移动 public class MoveToTask : ITask { private NavMeshAgent agent; private Vector3 targetPosition; private float stoppingDistance; public bool IsFinished { get; private set; } public MoveToTask(NavMeshAgent agent, Vector3 target, float stoppingDist 0.5f) { this.agent agent; this.targetPosition target; this.stoppingDistance stoppingDist; this.IsFinished false; } public void OnStart() { if (agent ! null agent.isActiveAndEnabled) { agent.isStopped false; agent.SetDestination(targetPosition); } else { // 如果Agent无效直接标记完成避免卡住队列 Debug.LogWarning(MoveToTask: NavMeshAgent is not available. Task aborted.); IsFinished true; } } public void OnUpdate() { if (IsFinished) return; // 检查是否到达目的地 if (agent ! null !agent.pathPending) { float distanceToTarget Vector3.Distance(agent.transform.position, targetPosition); if (distanceToTarget stoppingDistance) { FinishTask(); } // 可选增加超时判断防止因导航失败导致任务永远无法完成 } } public void OnFinish() { // 到达目的地或任务被中断时停止Agent if (agent ! null) { agent.isStopped true; } } private void FinishTask() { IsFinished true; OnFinish(); // 调用清理 } }// WaitTask.cs using UnityEngine; public class WaitTask : ITask { private float duration; private float timer; public bool IsFinished { get; private set; } public WaitTask(float seconds) { this.duration seconds; this.IsFinished false; this.timer 0f; } public void OnStart() { timer 0f; } public void OnUpdate() { if (IsFinished) return; timer Time.deltaTime; if (timer duration) { IsFinished true; } } public void OnFinish() { // 等待任务通常没有需要清理的资源 } }实操心得健壮性在MoveToTask.OnStart()中检查NavMeshAgent的有效性至关重要。如果NPC刚被销毁或禁用不进行检查会导致空引用异常进而使整个任务队列卡死。资源管理OnFinish方法用于清理。对于移动任务需要停止NavMeshAgent防止它继续尝试寻路。对于动画任务可能需要重置动画状态。参数化通过构造函数传入所需参数如目标点、等待时间使得任务对象是自包含的、可复用的。3.3 实现任务队列管理器TaskQueueManager.cs这是系统的核心负责管理队列和驱动任务执行。// TaskQueueManager.cs using System.Collections.Generic; using UnityEngine; public class TaskQueueManager : MonoBehaviour { private QueueITask taskQueue new QueueITask(); private ITask currentTask null; /// summary /// 当前是否有任务正在执行 /// /summary public bool IsBusy currentTask ! null; /// summary /// 队列中等待的任务数量 /// /summary public int QueuedTaskCount taskQueue.Count; void Update() { UpdateCurrentTask(); } /// summary /// 向队列末尾添加一个新任务 /// /summary public void EnqueueTask(ITask task) { if (task null) { Debug.LogWarning(Attempted to enqueue a null task.); return; } taskQueue.Enqueue(task); //Debug.Log($Task enqueued. Queue length: {taskQueue.Count}); } /// summary /// 立即清空所有等待中的任务并可选择是否中断当前正在执行的任务 /// /summary /// param nameinterruptCurrent是否中断当前任务/param public void ClearQueue(bool interruptCurrent false) { taskQueue.Clear(); if (interruptCurrent currentTask ! null) { currentTask.OnFinish(); currentTask null; } } /// summary /// 每帧更新当前任务逻辑 /// /summary private void UpdateCurrentTask() { // 如果当前没有任务尝试从队列中取出下一个 if (currentTask null) { if (taskQueue.Count 0) { currentTask taskQueue.Dequeue(); currentTask.OnStart(); //Debug.Log(Started a new task.); } return; // 没有任务直接返回 } // 更新当前任务 currentTask.OnUpdate(); // 检查当前任务是否完成 if (currentTask.IsFinished) { currentTask.OnFinish(); currentTask null; //Debug.Log(Current task finished.); } } /// summary /// 在下一帧立即执行一个新任务当前任务会被中断原队列任务保留 /// /summary public void ExecuteTaskImmediately(ITask task) { if (task null) return; // 中断当前任务 if (currentTask ! null) { currentTask.OnFinish(); } // 将当前任务如果存在放回队列头部或者丢弃 // 这里选择将新任务设为当前原当前任务丢弃。另一种常见策略是将原当前任务重新入队。 // 我们选择简单处理中断并替换。 currentTask task; currentTask.OnStart(); } /// summary /// 获取当前队列的拷贝用于调试显示注意这是快照 /// /summary public Liststring GetQueueSnapshot() { var snapshot new Liststring(); foreach (var task in taskQueue) { snapshot.Add(task.GetType().Name); } return snapshot; } }核心逻辑解析状态驱动UpdateCurrentTask方法是一个简单的状态机。currentTask null是“空闲”状态会从队列取任务currentTask ! null是“执行”状态会持续调用OnUpdate并检查完成状态。生命周期管理严格遵循OnStart- (OnUpdate循环) -OnFinish的调用顺序确保每个任务都能正确初始化和清理。灵活性ExecuteTaskImmediately方法实现了任务“插队”。这在响应高优先级事件时非常有用比如NPC被攻击时中断巡逻去战斗。这里的设计是直接替换当前任务你也可以根据需求修改为将原任务重新加入队列首部。调试支持GetQueueSnapshot方法在开发时非常有用可以在UI上显示NPC即将执行的任务列表。3.4 NPC控制器示例SimpleNPCController.cs最后我们创建一个使用任务队列管理器的NPC控制器。// SimpleNPCController.cs using UnityEngine; using UnityEngine.AI; public class SimpleNPCController : MonoBehaviour { private NavMeshAgent navMeshAgent; private TaskQueueManager taskQueue; public Transform[] patrolPoints; // 巡逻点 private int currentPatrolIndex 0; void Start() { navMeshAgent GetComponentNavMeshAgent(); taskQueue gameObject.AddComponentTaskQueueManager(); // 动态添加管理器组件 // 示例开始一个简单的巡逻循环 StartPatrol(); } void Update() { // 任务队列的更新由TaskQueueManager自身的Update处理这里可以添加其他NPC逻辑 // 例如检查玩家是否进入视野如果进入则清空巡逻队列并执行追击任务 // if (PlayerInSight()) { taskQueue.ClearQueue(true); EnqueueChaseTask(); } } void StartPatrol() { if (patrolPoints null || patrolPoints.Length 0) { Debug.LogError(No patrol points assigned!); return; } // 清空可能存在的旧任务 taskQueue.ClearQueue(true); // 添加巡逻任务序列移动到点A - 等待2秒 - 移动到点B - 等待2秒 - 循环 EnqueuePatrolCycle(); } void EnqueuePatrolCycle() { // 移动到下一个巡逻点 Vector3 targetPos patrolPoints[currentPatrolIndex].position; taskQueue.EnqueueTask(new MoveToTask(navMeshAgent, targetPos)); // 在巡逻点等待 taskQueue.EnqueueTask(new WaitTask(2.0f)); // 更新下一个巡逻点索引循环 currentPatrolIndex (currentPatrolIndex 1) % patrolPoints.Length; // 关键技巧在队列末尾添加一个“回调任务”用于重新添加巡逻周期实现无限循环 taskQueue.EnqueueTask(new ActionTask(() EnqueuePatrolCycle())); } // 示例一个执行自定义委托的简单任务类 public class ActionTask : ITask { private System.Action action; public bool IsFinished { get; private set; } public ActionTask(System.Action act) { action act; IsFinished false; } public void OnStart() { action?.Invoke(); IsFinished true; // 动作立即执行并完成 } public void OnUpdate() { } public void OnFinish() { } } // 在Inspector中提供一个按钮用于测试立即执行一个“跳跃”任务插队 [ContextMenu(Test Interrupt with Jump)] void TestInterrupt() { // 创建一个简单的“跳跃”动画任务这里用等待模拟 ITask jumpTask new WaitTask(1.5f); // 假设跳跃需要1.5秒 taskQueue.ExecuteTaskImmediately(jumpTask); Debug.Log(Interrupted with a jump task!); } }高级技巧与注意事项循环任务的实现EnqueuePatrolCycle方法末尾它通过ActionTask将一个“添加新巡逻周期”的委托作为任务加入队列。当执行到这个任务时它会调用EnqueuePatrolCycle从而将下一轮巡逻任务加入队列巧妙地实现了无限循环而无需在Update里写判断逻辑。组件化将TaskQueueManager作为组件挂载使得多个NPC可以独立管理自己的队列也方便在Inspector中查看虽然现在没有编辑器扩展但可以添加调试信息绘制。上下文菜单[ContextMenu]属性让你在Unity编辑器的组件上下文菜单中快速测试“插队”功能非常方便调试。4. 完整代码整合与使用指南将上述所有脚本ITask.cs,MoveToTask.cs,WaitTask.cs,TaskQueueManager.cs,SimpleNPCController.cs放入你的Unity项目的Scripts文件夹中。使用步骤在场景中创建一个NPC例如一个胶囊体Capsule。为其添加NavMeshAgent组件并烘焙好导航网格NavMesh。将SimpleNPCController脚本挂载到该NPC上。在Inspector中将SimpleNPCController组件的Patrol Points数组设置好拖入几个空物体作为巡逻点。运行游戏NPC就会开始按照你设定的点进行循环巡逻。在运行模式下选中该NPC在Inspector中右键点击SimpleNPCController组件选择“Test Interrupt with Jump”你会看到NPC立即中断巡逻等待1.5秒模拟跳跃后继续从被打断的巡逻点开始巡逻。5. 常见问题、扩展与优化5.1 常见问题排查NPC不动了检查导航网格确保NavMesh已烘焙且目标点在可行走区域Walkable。检查NavMeshAgent确认NPC上的NavMeshAgent组件未被禁用且Base Offset等参数合理。调试队列在TaskQueueManager的Update方法中添加日志打印当前任务类型和队列长度看任务是否正常添加和执行。检查任务完成条件MoveToTask的完成条件是距离小于stoppingDistance。如果这个值太小或路径被阻挡无法到达任务可能永远无法完成。可以增加一个超时机制。任务执行顺序乱了确保你使用的是Queue先进先出而不是Stack后进先出。检查是否有其他地方如事件监听同时调用了EnqueueTask导致任务顺序不符合预期。性能问题每帧对队列中每个NPC的当前任务调用OnUpdate是轻量级的。但如果同时存在成百上千个活跃的NPC仍需关注。可以考虑按帧分片更新或者对远离玩家的NPC降低其任务更新频率。5.2 系统扩展方向任务优先级当前的Queue是严格FIFO。可以升级为PriorityQueue需要自己实现或使用第三方库为每个任务设置优先级高优先级任务优先执行。并行任务修改ITask接口和TaskQueueManager使其能同时管理多个“当前任务”。例如NPC可以一边播放走路动画一个任务一边向目标移动另一个任务。条件任务与任务链实现ConditionalTask它包含一个条件委托和一个子任务只有条件满足时才执行子任务。还可以实现TaskSequence它本身是一个ITask但内部管理一个子任务列表按顺序执行它们这样可以将一系列任务打包成一个复合任务来入队。可视化调试为TaskQueueManager编写一个自定义编辑器Editor脚本在Scene视图或Game视图中绘制NPC的当前任务、队列内容等信息。与状态机FSM或行为树BT结合任务队列可以作为底层执行器。状态机或行为树的某个“动作”节点Action Node可以生成一个或多个任务并推入队列。这样高层的AI决策和底层的顺序执行就完美结合了。5.3 一个实用的扩展带回调的任务很多时候我们希望在任务完成后通知其他系统。可以扩展我们的任务基类或接口。// 带回调的任务接口可选扩展 public interface ITaskWithCallback : ITask { System.Action OnTaskCompleted { get; set; } } // 在TaskQueueManager的UpdateCurrentTask中当任务完成时 if (currentTask.IsFinished) { currentTask.OnFinish(); // 触发回调 if (currentTask is ITaskWithCallback taskWithCallback) { taskWithCallback.OnTaskCompleted?.Invoke(); } currentTask null; }然后在你需要的任务类中实现这个接口即可。这样当移动任务完成后可以自动触发播放“到达”音效或触发下一个剧情事件。这套基于Queue的NPC任务队列系统其核心价值在于提供了一种清晰、模块化的代码组织方式。它强迫你将复杂的NPC行为拆解成一个个独立的、可测试的“任务”单元然后通过队列这个简单的数据结构进行编排。从简单的巡逻等待到复杂的任务链、动态响应这个基础框架都能提供良好的支持。在实际项目中你可以根据具体需求在这个骨架上不断添加血肉构建出属于你自己的、功能强大的AI行为系统。
1. 项目概述与核心价值在Unity游戏开发中NPC非玩家角色的行为逻辑是构建沉浸式世界的关键。一个常见的需求是让NPC能够按顺序执行一系列任务比如巡逻、对话、拾取物品、返回原位。新手开发者可能会用一堆if-else或者Invoke来硬编码结果就是代码臃肿、难以维护一旦任务需要动态调整或取消就会陷入混乱。这正是任务队列Task Queue大显身手的地方。这个项目就是教你如何利用C#中的QueueT数据结构为NPC构建一个清晰、灵活、可扩展的任务队列系统。它不仅仅是把任务排个队那么简单而是关乎游戏逻辑的“解耦”与“可控性”。想象一下你的NPC可以接收来自事件系统、玩家交互或脚本触发的任务然后有条不紊地执行中途还能被打断、插入新任务或者清空队列。这种能力对于制作复杂的RPG任务链、RTS单位的指令序列或是模拟经营类游戏中的工人AI都至关重要。我将带你从零开始理解为什么用Queue如何设计一个通用的任务基类再到实现一个健壮的NPC任务调度器最后附上可以直接粘贴进你项目的完整代码。无论你是刚接触Unity的初学者还是想优化现有AI系统的开发者这套方案都能让你对游戏逻辑的架构有新的认识。2. 核心思路与架构设计2.1 为什么选择Queue在数据结构中队列Queue遵循“先进先出”FIFO原则。这完美契合了“任务队列”的直观需求先来的任务先执行。C#的System.Collections.Generic.QueueT提供了Enqueue入队、Dequeue出队、Peek查看队首等高效操作时间复杂度都是O(1)性能上完全满足游戏每帧更新的需求。对比其他方案List/数组虽然也能模拟但需要手动管理索引在移除已完成任务时可能涉及元素移动O(n)复杂度不如Queue纯粹和高效。LinkedList虽然插入删除快但用于简单的顺序执行任务显得有点“杀鸡用牛刀”且Queue的API更简洁直观。协程Coroutine链用yield return串联协程可以实现顺序执行但难以实现动态的任务管理如中途插入、跳过一个任务。将协程作为任务封装进Queue则可以兼顾顺序执行和灵活管理。因此我们的核心思路是用一个QueueITask来存储等待执行的任务一个ITask类型的当前任务变量来跟踪正在执行的任务然后在NPC的Update或协程中驱动这个状态机。2.2 系统架构设计一个健壮的任务队列系统需要以下几个核心部分任务接口ITask定义所有任务必须实现的方法如Start(),Update(),IsFinished属性等。这是实现多态的关键允许队列里存放巡逻、移动、动画等各种不同类型的任务。具体任务类实现ITask接口。例如MoveToTask移动到某点、WaitTask等待一段时间、PlayAnimationTask播放动画、CustomActionTask执行一个委托方法。每个任务类只关心自己的逻辑。任务队列管理器TaskQueueManager这是系统的大脑。它内部维护着任务队列QueueITask和当前任务ITask currentTask。提供EnqueueTask添加任务、ClearQueue清空队列、Pause/Resume暂停/恢复等公共方法并在Update中驱动任务的执行与切换。NPC控制器持有TaskQueueManager实例并根据游戏逻辑如触发区域、事件向管理器中添加任务。这种架构的优势在于解耦NPC的行为逻辑控制器与具体任务执行管理器分离与任务的具体实现具体任务类分离。灵活可以随时动态地添加、取消、清空任务。可扩展要新增一种任务类型只需创建一个实现ITask的新类即可无需修改队列管理器或NPC控制器。可调试可以方便地打印当前队列内容或任务执行状态。3. 核心代码实现与解析下面我们一步步实现这个系统。我会先给出关键代码片段并加以解释最后提供完整的、可运行的代码。3.1 定义任务接口ITask.cs这是所有任务的契约。我们设计一个简单的状态机任务开始、持续更新、结束。// ITask.cs public interface ITask { /// summary /// 任务是否已经完成 /// /summary bool IsFinished { get; } /// summary /// 当任务被设置为当前任务时调用用于初始化 /// /summary void OnStart(); /// summary /// 每帧更新任务逻辑 /// /summary void OnUpdate(); /// summary /// 当任务完成或被迫中断时调用用于清理资源 /// /summary void OnFinish(); }设计要点IsFinished属性让管理器知道何时切换到下一个任务。OnStart、OnUpdate、OnFinish构成了任务的生命周期钩子清晰明了。3.2 实现具体任务类示例我们实现两个最常用的任务移动任务和等待任务。// MoveToTask.cs using UnityEngine; using UnityEngine.AI; // 假设我们使用NavMeshAgent进行移动 public class MoveToTask : ITask { private NavMeshAgent agent; private Vector3 targetPosition; private float stoppingDistance; public bool IsFinished { get; private set; } public MoveToTask(NavMeshAgent agent, Vector3 target, float stoppingDist 0.5f) { this.agent agent; this.targetPosition target; this.stoppingDistance stoppingDist; this.IsFinished false; } public void OnStart() { if (agent ! null agent.isActiveAndEnabled) { agent.isStopped false; agent.SetDestination(targetPosition); } else { // 如果Agent无效直接标记完成避免卡住队列 Debug.LogWarning(MoveToTask: NavMeshAgent is not available. Task aborted.); IsFinished true; } } public void OnUpdate() { if (IsFinished) return; // 检查是否到达目的地 if (agent ! null !agent.pathPending) { float distanceToTarget Vector3.Distance(agent.transform.position, targetPosition); if (distanceToTarget stoppingDistance) { FinishTask(); } // 可选增加超时判断防止因导航失败导致任务永远无法完成 } } public void OnFinish() { // 到达目的地或任务被中断时停止Agent if (agent ! null) { agent.isStopped true; } } private void FinishTask() { IsFinished true; OnFinish(); // 调用清理 } }// WaitTask.cs using UnityEngine; public class WaitTask : ITask { private float duration; private float timer; public bool IsFinished { get; private set; } public WaitTask(float seconds) { this.duration seconds; this.IsFinished false; this.timer 0f; } public void OnStart() { timer 0f; } public void OnUpdate() { if (IsFinished) return; timer Time.deltaTime; if (timer duration) { IsFinished true; } } public void OnFinish() { // 等待任务通常没有需要清理的资源 } }实操心得健壮性在MoveToTask.OnStart()中检查NavMeshAgent的有效性至关重要。如果NPC刚被销毁或禁用不进行检查会导致空引用异常进而使整个任务队列卡死。资源管理OnFinish方法用于清理。对于移动任务需要停止NavMeshAgent防止它继续尝试寻路。对于动画任务可能需要重置动画状态。参数化通过构造函数传入所需参数如目标点、等待时间使得任务对象是自包含的、可复用的。3.3 实现任务队列管理器TaskQueueManager.cs这是系统的核心负责管理队列和驱动任务执行。// TaskQueueManager.cs using System.Collections.Generic; using UnityEngine; public class TaskQueueManager : MonoBehaviour { private QueueITask taskQueue new QueueITask(); private ITask currentTask null; /// summary /// 当前是否有任务正在执行 /// /summary public bool IsBusy currentTask ! null; /// summary /// 队列中等待的任务数量 /// /summary public int QueuedTaskCount taskQueue.Count; void Update() { UpdateCurrentTask(); } /// summary /// 向队列末尾添加一个新任务 /// /summary public void EnqueueTask(ITask task) { if (task null) { Debug.LogWarning(Attempted to enqueue a null task.); return; } taskQueue.Enqueue(task); //Debug.Log($Task enqueued. Queue length: {taskQueue.Count}); } /// summary /// 立即清空所有等待中的任务并可选择是否中断当前正在执行的任务 /// /summary /// param nameinterruptCurrent是否中断当前任务/param public void ClearQueue(bool interruptCurrent false) { taskQueue.Clear(); if (interruptCurrent currentTask ! null) { currentTask.OnFinish(); currentTask null; } } /// summary /// 每帧更新当前任务逻辑 /// /summary private void UpdateCurrentTask() { // 如果当前没有任务尝试从队列中取出下一个 if (currentTask null) { if (taskQueue.Count 0) { currentTask taskQueue.Dequeue(); currentTask.OnStart(); //Debug.Log(Started a new task.); } return; // 没有任务直接返回 } // 更新当前任务 currentTask.OnUpdate(); // 检查当前任务是否完成 if (currentTask.IsFinished) { currentTask.OnFinish(); currentTask null; //Debug.Log(Current task finished.); } } /// summary /// 在下一帧立即执行一个新任务当前任务会被中断原队列任务保留 /// /summary public void ExecuteTaskImmediately(ITask task) { if (task null) return; // 中断当前任务 if (currentTask ! null) { currentTask.OnFinish(); } // 将当前任务如果存在放回队列头部或者丢弃 // 这里选择将新任务设为当前原当前任务丢弃。另一种常见策略是将原当前任务重新入队。 // 我们选择简单处理中断并替换。 currentTask task; currentTask.OnStart(); } /// summary /// 获取当前队列的拷贝用于调试显示注意这是快照 /// /summary public Liststring GetQueueSnapshot() { var snapshot new Liststring(); foreach (var task in taskQueue) { snapshot.Add(task.GetType().Name); } return snapshot; } }核心逻辑解析状态驱动UpdateCurrentTask方法是一个简单的状态机。currentTask null是“空闲”状态会从队列取任务currentTask ! null是“执行”状态会持续调用OnUpdate并检查完成状态。生命周期管理严格遵循OnStart- (OnUpdate循环) -OnFinish的调用顺序确保每个任务都能正确初始化和清理。灵活性ExecuteTaskImmediately方法实现了任务“插队”。这在响应高优先级事件时非常有用比如NPC被攻击时中断巡逻去战斗。这里的设计是直接替换当前任务你也可以根据需求修改为将原任务重新加入队列首部。调试支持GetQueueSnapshot方法在开发时非常有用可以在UI上显示NPC即将执行的任务列表。3.4 NPC控制器示例SimpleNPCController.cs最后我们创建一个使用任务队列管理器的NPC控制器。// SimpleNPCController.cs using UnityEngine; using UnityEngine.AI; public class SimpleNPCController : MonoBehaviour { private NavMeshAgent navMeshAgent; private TaskQueueManager taskQueue; public Transform[] patrolPoints; // 巡逻点 private int currentPatrolIndex 0; void Start() { navMeshAgent GetComponentNavMeshAgent(); taskQueue gameObject.AddComponentTaskQueueManager(); // 动态添加管理器组件 // 示例开始一个简单的巡逻循环 StartPatrol(); } void Update() { // 任务队列的更新由TaskQueueManager自身的Update处理这里可以添加其他NPC逻辑 // 例如检查玩家是否进入视野如果进入则清空巡逻队列并执行追击任务 // if (PlayerInSight()) { taskQueue.ClearQueue(true); EnqueueChaseTask(); } } void StartPatrol() { if (patrolPoints null || patrolPoints.Length 0) { Debug.LogError(No patrol points assigned!); return; } // 清空可能存在的旧任务 taskQueue.ClearQueue(true); // 添加巡逻任务序列移动到点A - 等待2秒 - 移动到点B - 等待2秒 - 循环 EnqueuePatrolCycle(); } void EnqueuePatrolCycle() { // 移动到下一个巡逻点 Vector3 targetPos patrolPoints[currentPatrolIndex].position; taskQueue.EnqueueTask(new MoveToTask(navMeshAgent, targetPos)); // 在巡逻点等待 taskQueue.EnqueueTask(new WaitTask(2.0f)); // 更新下一个巡逻点索引循环 currentPatrolIndex (currentPatrolIndex 1) % patrolPoints.Length; // 关键技巧在队列末尾添加一个“回调任务”用于重新添加巡逻周期实现无限循环 taskQueue.EnqueueTask(new ActionTask(() EnqueuePatrolCycle())); } // 示例一个执行自定义委托的简单任务类 public class ActionTask : ITask { private System.Action action; public bool IsFinished { get; private set; } public ActionTask(System.Action act) { action act; IsFinished false; } public void OnStart() { action?.Invoke(); IsFinished true; // 动作立即执行并完成 } public void OnUpdate() { } public void OnFinish() { } } // 在Inspector中提供一个按钮用于测试立即执行一个“跳跃”任务插队 [ContextMenu(Test Interrupt with Jump)] void TestInterrupt() { // 创建一个简单的“跳跃”动画任务这里用等待模拟 ITask jumpTask new WaitTask(1.5f); // 假设跳跃需要1.5秒 taskQueue.ExecuteTaskImmediately(jumpTask); Debug.Log(Interrupted with a jump task!); } }高级技巧与注意事项循环任务的实现EnqueuePatrolCycle方法末尾它通过ActionTask将一个“添加新巡逻周期”的委托作为任务加入队列。当执行到这个任务时它会调用EnqueuePatrolCycle从而将下一轮巡逻任务加入队列巧妙地实现了无限循环而无需在Update里写判断逻辑。组件化将TaskQueueManager作为组件挂载使得多个NPC可以独立管理自己的队列也方便在Inspector中查看虽然现在没有编辑器扩展但可以添加调试信息绘制。上下文菜单[ContextMenu]属性让你在Unity编辑器的组件上下文菜单中快速测试“插队”功能非常方便调试。4. 完整代码整合与使用指南将上述所有脚本ITask.cs,MoveToTask.cs,WaitTask.cs,TaskQueueManager.cs,SimpleNPCController.cs放入你的Unity项目的Scripts文件夹中。使用步骤在场景中创建一个NPC例如一个胶囊体Capsule。为其添加NavMeshAgent组件并烘焙好导航网格NavMesh。将SimpleNPCController脚本挂载到该NPC上。在Inspector中将SimpleNPCController组件的Patrol Points数组设置好拖入几个空物体作为巡逻点。运行游戏NPC就会开始按照你设定的点进行循环巡逻。在运行模式下选中该NPC在Inspector中右键点击SimpleNPCController组件选择“Test Interrupt with Jump”你会看到NPC立即中断巡逻等待1.5秒模拟跳跃后继续从被打断的巡逻点开始巡逻。5. 常见问题、扩展与优化5.1 常见问题排查NPC不动了检查导航网格确保NavMesh已烘焙且目标点在可行走区域Walkable。检查NavMeshAgent确认NPC上的NavMeshAgent组件未被禁用且Base Offset等参数合理。调试队列在TaskQueueManager的Update方法中添加日志打印当前任务类型和队列长度看任务是否正常添加和执行。检查任务完成条件MoveToTask的完成条件是距离小于stoppingDistance。如果这个值太小或路径被阻挡无法到达任务可能永远无法完成。可以增加一个超时机制。任务执行顺序乱了确保你使用的是Queue先进先出而不是Stack后进先出。检查是否有其他地方如事件监听同时调用了EnqueueTask导致任务顺序不符合预期。性能问题每帧对队列中每个NPC的当前任务调用OnUpdate是轻量级的。但如果同时存在成百上千个活跃的NPC仍需关注。可以考虑按帧分片更新或者对远离玩家的NPC降低其任务更新频率。5.2 系统扩展方向任务优先级当前的Queue是严格FIFO。可以升级为PriorityQueue需要自己实现或使用第三方库为每个任务设置优先级高优先级任务优先执行。并行任务修改ITask接口和TaskQueueManager使其能同时管理多个“当前任务”。例如NPC可以一边播放走路动画一个任务一边向目标移动另一个任务。条件任务与任务链实现ConditionalTask它包含一个条件委托和一个子任务只有条件满足时才执行子任务。还可以实现TaskSequence它本身是一个ITask但内部管理一个子任务列表按顺序执行它们这样可以将一系列任务打包成一个复合任务来入队。可视化调试为TaskQueueManager编写一个自定义编辑器Editor脚本在Scene视图或Game视图中绘制NPC的当前任务、队列内容等信息。与状态机FSM或行为树BT结合任务队列可以作为底层执行器。状态机或行为树的某个“动作”节点Action Node可以生成一个或多个任务并推入队列。这样高层的AI决策和底层的顺序执行就完美结合了。5.3 一个实用的扩展带回调的任务很多时候我们希望在任务完成后通知其他系统。可以扩展我们的任务基类或接口。// 带回调的任务接口可选扩展 public interface ITaskWithCallback : ITask { System.Action OnTaskCompleted { get; set; } } // 在TaskQueueManager的UpdateCurrentTask中当任务完成时 if (currentTask.IsFinished) { currentTask.OnFinish(); // 触发回调 if (currentTask is ITaskWithCallback taskWithCallback) { taskWithCallback.OnTaskCompleted?.Invoke(); } currentTask null; }然后在你需要的任务类中实现这个接口即可。这样当移动任务完成后可以自动触发播放“到达”音效或触发下一个剧情事件。这套基于Queue的NPC任务队列系统其核心价值在于提供了一种清晰、模块化的代码组织方式。它强迫你将复杂的NPC行为拆解成一个个独立的、可测试的“任务”单元然后通过队列这个简单的数据结构进行编排。从简单的巡逻等待到复杂的任务链、动态响应这个基础框架都能提供良好的支持。在实际项目中你可以根据具体需求在这个骨架上不断添加血肉构建出属于你自己的、功能强大的AI行为系统。
)
