刻 Unreal EQS:環(huán)境查詢系統(tǒng)設(shè)計與實(shí)現(xiàn))
這次我們來看一個很經(jīng)典但 Unity 側(cè)沒有內(nèi)置的 AI 玩法Unreal Engine 里的 EQS也就是 Environment Query System環(huán)境查詢系統(tǒng)。很多射擊、潛行、生存游戲里AI 不會傻乎乎直線沖鋒而是會找掩體、繞后、選制高點(diǎn)看起來很聰明背后就是這套“生成候選位置 多維度打分 選擇最優(yōu)解”的邏輯在驅(qū)動。比較麻煩的是Unity 里沒有完全等價的現(xiàn)成系統(tǒng)。行為樹容易找NavMesh 尋路也成熟但“讓 AI 在運(yùn)行環(huán)境里動態(tài)評估多個候選點(diǎn)再挑一個最好的點(diǎn)”這層能力通常要自己搭。不過思路本身不復(fù)雜完全可以在 Unity 6 里從零復(fù)刻出一套輕量 EQS接上 NavMesh、視線檢測、距離評分和可視化調(diào)試讓 AI 真正學(xué)會“看環(huán)境選位置”。這篇文章會給出完整的系統(tǒng)設(shè)計方案、核心 C# 代碼、候選點(diǎn)生成與測試邏輯、Gizmos 調(diào)試流程、性能優(yōu)化方向以及常見問題排查清單。開發(fā)環(huán)境以 Unity 6 AI Navigation 包為例不需要第三方 AI 插件核心邏輯用純 C# 就能跑通。如果你最近在做 AI 射擊、潛行、恐怖游戲或者正在研究行為樹和尋路之外的“環(huán)境感知決策”這篇可以直接收藏。另外先說明一點(diǎn)本篇文章是結(jié)合相關(guān) Unity 6 復(fù)刻 EQS 教程思路整理的實(shí)現(xiàn)方案不是原視頻或付費(fèi)內(nèi)容的直接搬運(yùn)。復(fù)現(xiàn)過程中的代碼和場景設(shè)計都屬于通用工程思路但如果你后續(xù)要引用別人的腳本、模型或視頻片段仍然要注意來源授權(quán)。1. 核心能力速覽能力項(xiàng)說明項(xiàng)目類型Unity 6 技術(shù)方案 / EQS 系統(tǒng)復(fù)刻對應(yīng)引擎Unity 6推薦 6000.0 及以上版本核心依賴UnityEngine.AI、AI Navigation 包ai.navigation主要功能候選點(diǎn)生成、距離測試、視線測試、NavMesh 可達(dá)性測試、掩蔽評分、AI 目標(biāo)選擇交互方式組件配置 C# 代碼調(diào)用調(diào)試方式Gizmos 可視化候選點(diǎn)與分?jǐn)?shù)、Debug 面板硬件要求純 CPU 計算不需要 GPU建議 8GB 內(nèi)存以上是否支持批量支持多 Agent 查詢但需要分幀或 Job System 優(yōu)化是否支持 APIUnity 內(nèi)部 C# 接口可直接被行為樹或狀態(tài)機(jī)調(diào)用適合場景射擊 AI 找掩體、潛行 AI 規(guī)劃路線、收集型 AI 選目標(biāo)點(diǎn)這套方案的核心價值不是做一個“千人同屏 AI”而是把 Unreal EQS 的設(shè)計思路搬到 Unity先生成大量候選位置再用可配置的測試項(xiàng)逐個打分最后選出得分最高的點(diǎn)。后續(xù)加新玩法只需要新增一個 Test 子類不需要改整體框架。2. EQS 原理拆解查詢、生成器、測試與評分想在 Unity 里復(fù)刻 EQS首先要理解 Unreal 那邊 EQS 的五個核心組成部分。2.1 Query查詢一個 Query 是完整的查詢配置包含上下文、生成器和測試列表。你可以把它理解成“一次完整決策”的藍(lán)圖。AI 需要一個目標(biāo)點(diǎn)時向 EQS 發(fā)起一次查詢系統(tǒng)依次完成候選點(diǎn)生成和評分。2.2 Context上下文Context 定義查詢的“基準(zhǔn)位置”。常見的有執(zhí)行查詢的 Pawn 自身位置。當(dāng)前追逐目標(biāo)的 Actor 位置。某個自定義錨點(diǎn)比如玩家上次被發(fā)現(xiàn)的位置。多個目標(biāo)的平均位置或最近位置。在 Unity 實(shí)現(xiàn)中我會用一個輕量的EQQueryContext類來保存這些數(shù)據(jù)。2.3 Generator生成器生成器負(fù)責(zé)產(chǎn)生候選點(diǎn)或候選 Actor。Unreal 常見類型包括同心圓生成器圍繞基準(zhǔn)點(diǎn)生成一圈圈均勻分布的點(diǎn)。格柵生成器在一定范圍內(nèi)生成網(wǎng)格狀點(diǎn)??牲c(diǎn)擊點(diǎn)生成器直接收集場景中的相關(guān) Actor。候選點(diǎn)的數(shù)量直接決定查詢開銷所以生成器通常要能配置半徑、點(diǎn)數(shù)和分布密度。2.4 Test測試每個候選點(diǎn)都要經(jīng)過一個或多個測試。測試有兩種模式Filter 模式不滿足條件直接淘汰比如“候選點(diǎn)必須可達(dá)”。Scorer 模式按結(jié)果打分比如“離目標(biāo)越近分?jǐn)?shù)越高”。Unreal 里面常見的測試有距離測試、視線測試、NavMesh 可達(dá)性測試、掩蔽測試、自熱測試等。復(fù)刻到 Unity 時我會把測試設(shè)計成可繼承的抽象類每一個測試只做一件事。2.5 Score評分多個測試的分?jǐn)?shù)乘上各自權(quán)重后累加得到候選點(diǎn)的最終得分。分?jǐn)?shù)越高越優(yōu)。為了調(diào)試方便每個測試最好把輸出歸一化到 0 到 1這樣權(quán)重才有對比意義。整體執(zhí)行流程可以概括為獲取查詢上下文包括查詢者位置、目標(biāo)位置等。生成器根據(jù)上下文生成候選點(diǎn)列表。對每個候選點(diǎn)依次運(yùn)行測試列表。Filter 測試不通過則直接排除該點(diǎn)。Scorer 測試得到 0 到 1 分乘權(quán)重后累加。對所有候選點(diǎn)按分?jǐn)?shù)降序排序返回最高分點(diǎn)或前 N 個點(diǎn)。3. Unity 6 本地部署環(huán)境準(zhǔn)備Unity 6 中接入這套 EQS 系統(tǒng)不需要額外安裝復(fù)雜插件但環(huán)境準(zhǔn)備要做扎實(shí)。3.1 安裝 Unity 6從 Unity Hub 安裝 Unity 6。一般來說使用 6000.0 及以上版本穩(wěn)定性足夠。安裝時建議勾選 Windows Build Support 或目標(biāo)平臺支持方便后續(xù)打包測試。3.2 安裝 AI Navigation 包后續(xù)章節(jié)里的 NavMesh 可達(dá)性測試依賴 AI Navigation 包。打開 Package ManagerWindow - Package Manager - Unity Registry - AI Navigation - Install安裝完成后場景中會多出NavMeshSurface相關(guān)組件用來烘焙 NavMesh。3.3 搭建測試場景建議創(chuàng)建一個單獨(dú)場景來驗(yàn)證 EQS地面一個 Plane 或 Cube 拉伸成地面。墻體幾個 Cube 作為障礙物給它們單獨(dú)設(shè)置 Layer比如Obstacle。AI 角色一個 Capsule掛NavMeshAgent組件作為查詢發(fā)起者。目標(biāo)對象一個 Sphere代表玩家或敵人作為 AI 要評估的目標(biāo)位置。3.4 烘焙 NavMesh使用 AI Navigation 包時可以通過NavMeshSurface組件烘焙在地面對象上添加NavMeshSurface組件。將墻體和障礙物設(shè)為靜態(tài)導(dǎo)航阻擋物。點(diǎn)擊Bake按鈕生成 NavMesh。烘焙完成后進(jìn)入 Play ModeNavMeshAgent才能正確計算路徑。3.5 推薦目錄結(jié)構(gòu)建議把代碼按模塊分離方便后續(xù)擴(kuò)展。Assets/Scripts/EQS/ EQEnvironmentQuery.cs EQQueryContext.cs EQItemGeneratorBase.cs EQGenerator_RadialPoints.cs EQTestBase.cs EQTest_Distance.cs EQTest_LineOfSight.cs EQTest_NavMeshReachable.cs EQTest_Cover.cs Assets/Scripts/Demo/ EQAgent.cs4. 復(fù)刻 EQS 的 Unity 系統(tǒng)設(shè)計在寫代碼之前先把類設(shè)計說清楚。整體設(shè)計目標(biāo)是“一個可配置的查詢?nèi)肟? 一組可插拔的測試項(xiàng)”這樣不需要后續(xù)改動查詢主邏輯。4.1 核心類職責(zé)類/接口職責(zé)EQQueryContext保存查詢者位置、目標(biāo)位置、查詢者 TransformEQItemGeneratorBase抽象生成器子類決定候選點(diǎn)如何分布EQGenerator_RadialPoints在圓形范圍內(nèi)生成均勻候選點(diǎn)EQTestBase抽象測試子類決定如何計算分?jǐn)?shù)或過濾EQTest_Distance距離測試可設(shè)置最近/最遠(yuǎn)距離和偏好方向EQTest_LineOfSight視線測試從查詢者到候選點(diǎn)是否可見EQTest_NavMeshReachable可達(dá)性測試候選點(diǎn)是否在 NavMesh 上有可達(dá)路徑EQTest_Cover簡化掩體測試候選點(diǎn)對目標(biāo)是否形成遮擋EQEnvironmentQuery查詢?nèi)肟谪?fù)責(zé)生成候選點(diǎn)并匯總評分EQAgent演示組件控制 AI 定期執(zhí)行查詢并移動4.2 執(zhí)行流程設(shè)計在 Unity 中一次完整查詢可以拆成五個階段調(diào)用RunQuery(querier, targetPos)創(chuàng)建上下文。調(diào)用生成器的Generate方法得到候選點(diǎn)列表。遍歷候選點(diǎn)依次執(zhí)行所有測試。測試結(jié)果為 Fail 且模式為 Filter 時直接丟棄該點(diǎn)。測試結(jié)果為 Scorer 時累加加權(quán)分?jǐn)?shù)最后選出最高分。這個流程的核心特點(diǎn)是“每個測試只負(fù)責(zé)一個維度”后續(xù)加新的評分邏輯不會污染主流程。5. 核心代碼實(shí)現(xiàn)下面進(jìn)入代碼部分。我按時間線實(shí)現(xiàn)一個最小可運(yùn)行的 EQS圓形生成器、距離測試、視線測試、NavMesh 可達(dá)性測試、匯總查詢?nèi)肟谧詈蠼右粋€移動 Demo Agent。5.1 查詢上下文using UnityEngine; namespace EQS.Core { public class EQQueryContext { public Transform Querier; public Vector3 QuerierPosition; public Vector3 TargetPosition; } }5.2 生成器抽象類與圓形生成器using System.Collections.Generic; using UnityEngine; namespace EQS.Core { public abstract class EQItemGeneratorBase { public abstract ListVector3 Generate(Vector3 center, Quaternion orientation); } public class EQGenerator_RadialPoints : EQItemGeneratorBase { public int Count 16; public float Radius 10f; public override ListVector3 Generate(Vector3 center, Quaternion orientation) { ListVector3 points new ListVector3(); for (int i 0; i Count; i) { float angle (360f / Count) * i * Mathf.Deg2Rad; Vector3 dir new Vector3(Mathf.Cos(angle), 0f, Mathf.Sin(angle)); points.Add(center dir * Radius); } return points; } } }這個生成器適合快速驗(yàn)證。實(shí)際項(xiàng)目中可以繼續(xù)擴(kuò)展格柵生成器、沿路徑生成器、Actor 收集生成器。5.3 測試基類namespace EQS.Core { public enum EQTestMode { Filter, Scorer } public abstract class EQTestBase { public EQTestMode Mode EQTestMode.Scorer; public float Weight 1f; public abstract bool Run(Vector3 candidate, EQQueryContext ctx, out float score); } }5.4 距離測試using UnityEngine; namespace EQS.Tests { public class EQTest_Distance : EQTestBase { public float MinDistance 0f; public float MaxDistance 20f; public bool PreferCloser true; public override bool Run(Vector3 candidate, EQQueryContext ctx, out float score) { float dist Vector3.Distance(candidate, ctx.TargetPosition); if (dist MinDistance || dist MaxDistance) { score 0f; return false; } float t Mathf.InverseLerp(0f, MaxDistance, dist); score Mathf.Clamp01(PreferCloser ? 1f - t : t); return true; } } }這個測試的MinDistance和MaxDistance可以直接理解為 Filter 邊界但測試仍返回 false讓上層根據(jù) Mode 決定是否丟棄候選點(diǎn)。5.5 視線測試using UnityEngine; namespace EQS.Tests { public class EQTest_LineOfSight : EQTestBase { public LayerMask ObstacleMask; public bool RequireVisible false; public override bool Run(Vector3 candidate, EQQueryContext ctx, out float score) { Vector3 start ctx.QuerierPosition Vector3.up * 1.2f; Vector3 end candidate Vector3.up * 1.2f; bool visible !Physics.Linecast(start, end, ObstacleMask); if (RequireVisible !visible) { score 0f; return false; } score visible ? 1f : 0f; return true; } } }RequireVisible設(shè)置為 true 時AI 只會選擇能直接看見的目標(biāo)點(diǎn)設(shè)置為 false 時AI 會選擇被遮擋的掩體點(diǎn)。射擊游戲找掩體時通常更想要“被遮擋”的點(diǎn)。5.6 NavMesh 可達(dá)性測試using UnityEngine; using UnityEngine.AI; namespace EQS.Tests { public class EQTest_NavMeshReachable : EQTestBase { public float SampleDistance 2f; public override bool Run(Vector3 candidate, EQQueryContext ctx, out float score) { if (!NavMesh.SamplePosition(candidate, out NavMeshHit hit, SampleDistance, NavMesh.AllAreas)) { score 0f; return false; } NavMeshPath path new NavMeshPath(); if (NavMesh.CalculatePath(ctx.QuerierPosition, hit.position, NavMesh.AllAreas, path)) { if (path.status NavMeshPathStatus.PathComplete) { score 1f; return true; } } score 0f; return false; } } }這個測試在候選點(diǎn)數(shù)量多時會比較貴后面性能優(yōu)化章節(jié)會專門說明。5.7 簡化掩體測試掩體測試的思路是從候選點(diǎn)看向目標(biāo)如果中間有障礙物說明這個候選點(diǎn)對目標(biāo)形成了遮擋加分。using UnityEngine; namespace EQS.Tests { public class EQTest_Cover : EQTestBase { public LayerMask CoverMask; public override bool Run(Vector3 candidate, EQQueryContext ctx, out float score) { Vector3 fromCandidate candidate Vector3.up * 1.2f; Vector3 toTarget ctx.TargetPosition Vector3.up * 1.2f; bool occluded Physics.Linecast(fromCandidate, toTarget, CoverMask); score occluded ? 1f : 0f; return true; } } }和EQTest_LineOfSight的區(qū)別是這里是“從候選點(diǎn)看向目標(biāo)”用于判斷掩體效果視線測試是“從 AI 當(dāng)前位置看向候選點(diǎn)”用于判斷路徑上是否可見。5.8 EQS 查詢?nèi)肟趗sing System.Collections.Generic; using UnityEngine; namespace EQS.Core { public class EQEnvironmentQuery : MonoBehaviour { public EQItemGeneratorBase Generator; public ListEQTestBase Tests new ListEQTestBase(); [Header(Debug)] public bool DrawPoints true; public bool DrawBestPoint true; private EQQueryContext _ctx new EQQueryContext(); public EQResult RunQuery(Transform querier, Vector3 targetPos) { _ctx.Querier querier; _ctx.QuerierPosition querier.position; _ctx.TargetPosition targetPos; ListVector3 candidates Generator.Generate(querier.position, querier.rotation); EQResult best null; foreach (Vector3 point in candidates) { EQResult result EvaluatePoint(point, _ctx); if (result.Passed (best null || result.Score best.Score)) { best result; } } return best; } private EQResult EvaluatePoint(Vector3 point, EQQueryContext ctx) { EQResult result new EQResult(); result.Point point; result.Passed true; result.Score 0f; foreach (EQTestBase test in Tests) { if (test null) continue; bool ok test.Run(point, ctx, out float score); if (!ok) { if (test.Mode EQTestMode.Filter) { result.Passed false; result.RejectReasons.Add(test.GetType().Name); result.Score 0f; return result; } score 0f; } result.Score Mathf.Clamp01(score) * test.Weight; } return result; } } }對應(yīng)的結(jié)果類using System.Collections.Generic; using UnityEngine; namespace EQS.Core { public class EQResult { public Vector3 Point; public float Score; public bool Passed true; public Liststring RejectReasons new Liststring(); } }5.9 Demo AI Agent最后寫一個演示組件讓 AI 每隔一段時間執(zhí)行一次查詢?nèi)缓笞叩阶罡叻值狞c(diǎn)。using UnityEngine; using UnityEngine.AI; using EQS.Core; namespace EQS.Demo { public class EQAgent : MonoBehaviour { public EQEnvironmentQuery EQS; public NavMeshAgent Agent; public Transform Target; public float QueryInterval 1f; private float _lastTime -999f; void Update() { if (EQS null || Agent null || Target null) return; if (Time.time - _lastTime QueryInterval) return; _lastTime Time.time; EQResult best EQS.RunQuery(transform, Target.position); if (best ! null best.Passed) { Agent.SetDestination(best.Point); } } } }這個QueryInterval很重要后續(xù)優(yōu)化時會反復(fù)提到。6. 可視化調(diào)試與功能測試EQS 這種系統(tǒng)最大的問題是“黑盒”分?jǐn)?shù)不知道怎么來的。所以可視化調(diào)試是這套系統(tǒng)能不能用起來的關(guān)鍵。6.1 Gizmos 繪制候選點(diǎn)在EQEnvironmentQuery中添加 Gizmos 繪制邏輯private void OnDrawGizmos() { if (!Application.isPlaying) return; if (Generator null) return; ListVector3 candidates Generator.Generate( transform.position, transform.rotation ); foreach (Vector3 point in candidates) { Vector3 center point Vector3.up * 0.5f; float d Vector3.Distance(center, _ctx.TargetPosition); Color color Color.Lerp(Color.green, Color.red, Mathf.Clamp01(d / 10f)); Gizmos.color color; Gizmos.DrawWireSphere(center, 0.25f); } }這個方案比較粗糙正式項(xiàng)目里最好把候選點(diǎn)、最終選擇點(diǎn)、各測試分?jǐn)?shù)存到調(diào)試列表里然后逐項(xiàng)繪制。更實(shí)用的做法是在EQAgent中把best結(jié)果緩存起來持續(xù)繪制選中點(diǎn)private EQResult _lastBest; void Update() { // ... 省略查詢邏輯 _lastBest EQS.RunQuery(transform, Target.position); } private void OnDrawGizmos() { if (_lastBest null || !_lastBest.Passed) return; Gizmos.color Color.cyan; Gizmos.DrawSphere(_lastBest.Point Vector3.up * 0.5f, 0.4f); }6.2 場景搭建步驟建議按下面的順序驗(yàn)證創(chuàng)建地面、墻體、AI Capsule、Target Sphere。給 AI 添加NavMeshAgent和EQAgent組件。給場景中的動態(tài)對象添加EQEnvironmentQuery組件。在 Inspector 中指定生成器設(shè)置Count 16、Radius 8。添加一個EQTest_Distance設(shè)置MaxDistance 20PreferCloser true。添加一個EQTest_NavMeshReachable讓它以 Filter 模式運(yùn)行。點(diǎn)擊 Play觀察 AI 是否移動到離目標(biāo)最近的可達(dá)點(diǎn)。然后再逐步添加視線測試和掩體測試觀察候選點(diǎn)顏色和 AI 行為變化。6.3 功能驗(yàn)證用例測試場景輸入配置預(yù)期結(jié)果空場地找最近點(diǎn)16 點(diǎn)圓形生成器距離測試AI 走向離目標(biāo)最近且可達(dá)的點(diǎn)一堵墻擋路加視線測試RequireVisiblefalseAI 可能選擇墻后掩體點(diǎn)墻后點(diǎn)不可達(dá)加 NavMesh 可達(dá)性 Filter不可達(dá)點(diǎn)被過濾AI 選最近可達(dá)點(diǎn)多個掩體對比距離 視線 掩體測試AI 選擇遮擋更充分且距離合理的點(diǎn)無有效點(diǎn)所有點(diǎn)都被 Filter 淘汰best為 nullAI 停在原地通過這組用例可以判斷系統(tǒng)是否真正具備“環(huán)境感知決策”能力。7. 功能擴(kuò)展API 與批量任務(wù)思路EQS 本質(zhì)上是 C# 內(nèi)部的邏輯模塊不是 Web 服務(wù)所以不需要 HTTP API。但如果你做的是服務(wù)器驅(qū)動的 AI 決策或者想讓策劃通過配置驅(qū)動 AI可以把查詢封裝成可序列化配置。7.1 配置驅(qū)動思路可以用ScriptableObject保存查詢配置[CreateAssetMenu(fileName EQSQueryConfig, menuName AI/EQS Query Config)] public class EQSQueryConfig : ScriptableObject { public EQItemGeneratorBase Generator; public ListEQTestBase Tests new ListEQTestBase(); }這樣策劃可以創(chuàng)建多套查詢配置比如“找掩體”“找巡邏點(diǎn)”“找攻擊位置”運(yùn)行時按狀態(tài)切換。7.2 多 Agent 批量查詢多 Agent 同時調(diào)用RunQuery會出現(xiàn)明顯的 CPU 峰值因?yàn)槊總€ Agent 都要生成候選點(diǎn)、計算路徑。優(yōu)化思路有兩個方向時間分片每個 Agent 錯開查詢時間避免同幀計算??臻g分塊同一個區(qū)域內(nèi)多個 Agent 共用一份查詢結(jié)果而不是各算各的。下面是一個簡單的錯開查詢示例public class StaggeredQueryAgent : MonoBehaviour { public EQEnvironmentQuery EQS; public float Offset 0f; public float Interval 1f; void Update() { float t Time.time Offset; if (t % Interval Time.deltaTime) { // 執(zhí)行查詢 } } }通過給不同 Agent 設(shè)置不同Offset可以顯著降低同幀計算壓力。7.3 RaycastCommand 批量視線測試視線測試在候選點(diǎn)多的時候會產(chǎn)生大量 Raycast。Unity 提供了RaycastCommand做批量射線檢測配合 Job System 可以并行執(zhí)行。下面是一個簡化示例using Unity.Collections; using UnityEngine; public static class LineOfSightBatcher { public static bool[] BatchCheck(int count, Vector3 start, Vector3[] ends, LayerMask mask) { var commands new NativeArrayRaycastCommand(count, Allocator.TempJob); var results new NativeArrayRaycastHit(count, Allocator.TempJob); for (int i 0; i count; i) { commands[i] new RaycastCommand( start, (ends[i] - start).normalized, Vector3.Distance(start, ends[i]), mask ); } var handle RaycastCommand.ScheduleBatch(commands, results, 32, default); handle.Complete(); bool[] visible new bool[count]; for (int i 0; i count; i) { visible[i] results[i].collider null; } commands.Dispose(); results.Dispose(); return visible; } }這個示例展示了批量思路實(shí)際接入時要注意RaycastCommand的初始位置不能位于碰撞體內(nèi)部否則會產(chǎn)生誤判。7.4 NavMeshPath 緩存與復(fù)用NavMesh.CalculatePath是 EQS 里最貴的操作之一。候選點(diǎn)越多路徑計算越頻繁。工程化建議只對通過距離和視線測試的點(diǎn)做可達(dá)性測試。把NavMeshPath對象緩存復(fù)用避免每次 new 一個。同一幀內(nèi)相同起始點(diǎn)和終點(diǎn)不重復(fù)計算路徑。8. 資源占用與性能觀察EQS 屬于 CPU 密集邏輯它的瓶頸不是 GPU而是候選點(diǎn)數(shù)、測試復(fù)雜度和查詢頻率。8.1 性能瓶頸分析假設(shè)一次查詢有 32 個候選點(diǎn)、3 個測試那么單次查詢最多執(zhí)行 96 次測試。如果其中包含可達(dá)性測試最壞情況是 32 次 NavMesh 路徑搜索這已經(jīng)會帶來幾毫秒的開銷。所以不要讓 AI 每幀查詢。一般射擊游戲 AI 的決策頻率是 1 到 4 Hz也就是每 0.25 到 1 秒查詢一次完全夠用。8.2 如何觀察 CPU 峰值Unity Profiler 是主要工具Window - Analysis - Profiler重點(diǎn)觀察PlayerLoop下的邏輯開銷如果單幀耗時突然變高優(yōu)先查看是否有多個 Agent 在同一幀執(zhí)行路徑計算。8.3 降低開銷的建議手段說明降低候選點(diǎn)數(shù)先用 16 到 32 個點(diǎn)驗(yàn)證效果不夠再加降低查詢頻率0.5 到 1 秒一次通常足夠Filter 前置先做便宜的 Filter 測試再做貴的路徑測試調(diào)整 NavMesh SampleDistance過大的采樣距離會放寬候選點(diǎn)范圍使用 Job System將視線測試批量并行化多 Agent 錯幀給每個 Agent 設(shè)置隨機(jī)起始偏移8.4 內(nèi)存與顯存這套方案是純 CPU 計算基本不占用顯存。內(nèi)存方面主要開銷來自測試過程中產(chǎn)生的NavMeshPath和候選點(diǎn)列表。工程上建議復(fù)用這些對象不要在高頻查詢時反復(fù) new。9. 常見問題與排查方法問題現(xiàn)象可能原因排查方式解決方案候選點(diǎn)沒有生成生成器未配置或 Count 為 0檢查 Inspector 中 Generator 引用和 Count 值設(shè)置有效生成器并讓 Count 0AI 永遠(yuǎn)停在原地所有候選點(diǎn)被 Filter 淘汰開啟 Gizmos 看候選點(diǎn)顏色調(diào)整測試閾值或關(guān)閉 Filter 模式可達(dá)性測試全失敗NavMesh 未烘焙查看 Navigation 窗口是否已有數(shù)據(jù)重新 Bake NavMesh視線測試結(jié)果不符合預(yù)期LayerMask 未包含墻體檢查 ObstacleMask 配置讓墻體使用單獨(dú) Layer游戲運(yùn)行時卡頓明顯每幀查詢且計算路徑打開 Profiler 定位耗時增加 QueryInterval減少候選點(diǎn)數(shù)Gizmos 不顯示場景視圖 Gizmos 被關(guān)閉檢查 Scene 右上角 Gizmos 開關(guān)打開 Gizmos 并確認(rèn)繪制代碼存在多個 Agent 同幀卡頓缺乏錯幀邏輯查看同時發(fā)起查詢的 Agent 數(shù)量使用偏移量錯開查詢時間分?jǐn)?shù)結(jié)果不穩(wěn)定測試分?jǐn)?shù)未歸一化輸出各測試得分在匯總前對 score 做 Clamp01Linecast 起點(diǎn)在物體內(nèi)部起點(diǎn)高度太低或偏移不夠調(diào)試時繪制射線把起點(diǎn)抬高并添加偏移候選點(diǎn)集中在 NavMesh 外生成器只按圓分布未貼地采樣觀察候選點(diǎn) Y 軸高度使用 NavMesh.SamplePosition 修正高度其中最容易踩的坑是“視線測試結(jié)果全反”。原因很常見把RequireVisible配置成 true卻期待 AI 找掩體。實(shí)際上找掩體時應(yīng)該用掩體測試而不是視線測試。建議把每個測試的作用寫在 Inspector 的 Tooltip 里避免策劃配錯。10. 邊界與合規(guī)使用提醒這篇文章是基于通用工程思路的復(fù)現(xiàn)整理不是直接照搬原視頻或付費(fèi)內(nèi)容。如果你學(xué)習(xí)某個教程后做項(xiàng)目請遵守下面幾條邊界不要直接復(fù)制教程中的付費(fèi)腳本、美術(shù)資源和關(guān)卡內(nèi)容。如果引用了開源實(shí)現(xiàn)保留原作者署名和許可證聲明。使用 AI 生成素材時確認(rèn)素材版權(quán)和商業(yè)使用權(quán)限。如果是團(tuán)隊(duì)項(xiàng)目涉及玩家數(shù)據(jù)、網(wǎng)絡(luò)同步等功能需要遵守隱私和數(shù)據(jù)合規(guī)要求。正式發(fā)布前對 EQS 生成的 AI 行為做充分測試避免出現(xiàn)卡墻、穿墻或無限循環(huán)等異常。復(fù)刻 EQS 這類系統(tǒng)價值在于把“決策邏輯”從具體玩法中抽離出來。它本身不涉及敏感內(nèi)容但如果 AI 行為應(yīng)用到商業(yè)游戲仍然需要做完整的功能與性能驗(yàn)證。11. 最佳實(shí)踐與后續(xù)擴(kuò)展如果你決定在項(xiàng)目里正式落地這套 EQS建議按下面的次序推進(jìn)。11.1 先跑通最小閉環(huán)不急著做掩體、視線、Job System。先讓 AI 能通過“圓形生成器 距離測試 可達(dá)性測試”選出一個點(diǎn)并走過去。這個閉環(huán)跑通后后面所有測試項(xiàng)都是增量工作。11.2 每個測試單獨(dú)開關(guān)在EQEnvironmentQuery里為每個測試增加enable字段或者使用[SerializeReference]讓 Inspector 支持動態(tài)增刪測試項(xiàng)。調(diào)試時只開一個測試更容易定位問題。11.3 把得分結(jié)構(gòu)輸出到 UI更進(jìn)階的做法是在場景里用OnGUI或 TextMeshPro 輸出每個候選點(diǎn)的得分明細(xì)void OnGUI() { if (_lastResult null) return; GUILayout.Label($Best Point: {_lastResult.Point}); GUILayout.Label($Score: {_lastResult.Score}); }這樣策劃不用看代碼也能理解 AI 為什么選這個位置。11.4 擴(kuò)展方向這套框架可以繼續(xù)擴(kuò)展成更完整的 AI 決策層接入行為樹把查詢結(jié)果寫進(jìn)黑板變量行為樹中的MoveTo任務(wù)直接讀取目標(biāo)點(diǎn)。增加 Actor 生成器直接收集場景中的敵人或掉落物做收集型 AI。增加“方向偏好”測試讓 AI 偏向玩家背后方向?qū)崿F(xiàn)繞后效果。增加“熱度”測試通過體素?zé)岫葓鲎?AI 避開危險區(qū)域。生成器支持組合圓形生成器生成后經(jīng)過 NavMesh 采樣修正高度再做一次附近掩體投影。服務(wù)端 AI 決策如果做 MOBA 或俯視角射擊可以將查詢邏輯放在服務(wù)器使用純 C# 計算不依賴 Unity 物理。12. 總結(jié)與下一步這次整理的 Unity 6 EQS 復(fù)刻方案核心思路是“生成候選點(diǎn) - 多維度測試 - 加權(quán)打分 - 輸出最優(yōu)解”。它不是一個具體插件而是一套可插拔、可調(diào)試、可擴(kuò)展的 AI 環(huán)境決策框架。復(fù)制代碼跑通 Demo 之后你會發(fā)現(xiàn) Unity 里做“AI 找掩體”“AI 選巡邏點(diǎn)”“AI 繞后”這類需求都比直接寫死邏輯要穩(wěn)得多。接下來建議先做兩件事把最小閉環(huán)跑通驗(yàn)證候選點(diǎn)生成和得分選擇。配置 Gizmos 調(diào)試把每個候選點(diǎn)的分?jǐn)?shù)可視化。如果每一步都能看到“為什么選這個點(diǎn)”這套 EQS 就算真正落地了。這個方向后面還能擴(kuò)展很多實(shí)用玩法建議收藏備用準(zhǔn)備做 AI 決策系統(tǒng)的時候直接照著搭。