之前聊了很多Web和移動(dòng)端的組件化方案今天把場(chǎng)景切換到游戲引擎聊一個(gè)在虛幻引擎Unreal Engine里非?；A(chǔ)但極其重要的操作創(chuàng)建組件。別小看這個(gè)題目組件系統(tǒng)玩得轉(zhuǎn)不轉(zhuǎn)直接決定了你的項(xiàng)目是清爽的積木式搭建還是淪為一堆互相糾纏的“屎山”藍(lán)圖。這篇文章我會(huì)從組件體系的底層邏輯講起結(jié)合藍(lán)圖和C兩種實(shí)現(xiàn)方式再拆解組件通信和常見(jiàn)坑點(diǎn)把我這些年摸爬滾打的經(jīng)驗(yàn)一次性倒出來(lái)。1. 先搞明白虛幻引擎里的組件到底是個(gè)什么東西1.1 組件不是Actor而是Actor的“器官”很多新手剛接觸UE時(shí)最容易混淆的就是Actor和Component。簡(jiǎn)單來(lái)說(shuō)Actor是場(chǎng)景里的“物體”比如一個(gè)角色、一盞燈、一塊石頭而Component是附著在Actor身上的“器官”或“能力模塊”。舉個(gè)例子一個(gè)角色Actor它身上掛一個(gè)靜態(tài)網(wǎng)格體組件StaticMeshComponent負(fù)責(zé)顯示外觀掛一個(gè)膠囊體碰撞組件CapsuleComponent負(fù)責(zé)物理碰撞再掛一個(gè)音頻組件AudioComponent負(fù)責(zé)發(fā)出腳步聲。每個(gè)組件只做一件事但組合在一起這個(gè)角色Actor就具備了完整的功能。這種“組合優(yōu)于繼承”的設(shè)計(jì)思路在傳統(tǒng)軟件開(kāi)發(fā)里已經(jīng)是被驗(yàn)證過(guò)的架構(gòu)模式。你在Web前端寫過(guò)Vue組件、React組件在安卓里寫過(guò)自定義View其實(shí)思想完全一致把一個(gè)復(fù)雜系統(tǒng)的能力拆成高內(nèi)聚、低耦合的獨(dú)立單元通過(guò)標(biāo)準(zhǔn)化接口進(jìn)行交互。UE把這種思想貫徹到了引擎底層給你提供了一套完整的運(yùn)行時(shí)組件框架。1.2 UE組件家族的三大核心分類UE里的組件類型很多但從基類劃分你主要接觸三類ActorComponent最基礎(chǔ)的組件基類不關(guān)心三維空間位置。它適合做純邏輯模塊比如一個(gè)管理角色屬性數(shù)值的組件完全不需要位置、旋轉(zhuǎn)、縮放信息。SceneComponent繼承自ActorComponent多了Transform位置、旋轉(zhuǎn)、縮放。所有需要附著在場(chǎng)景空間的組件都從它派生比如彈簧臂組件SpringArmComponent、攝像機(jī)組件CameraComponent。PrimitiveComponent繼承自SceneComponent增加了渲染和碰撞相關(guān)能力。網(wǎng)格體組件、粒子系統(tǒng)組件、骨骼網(wǎng)格體組件都?xì)w它管。它能被世界場(chǎng)景拾取、能參與物理模擬、能產(chǎn)生遮擋剔除。搞清楚這個(gè)繼承關(guān)系非常重要因?yàn)槟阍趧?chuàng)建自定義組件時(shí)第一步就是選對(duì)基類。比如你要做一個(gè)小地圖圖標(biāo)跟隨功能那組件本身不需要掛載到場(chǎng)景空間用ActorComponent就夠了但如果你要做一把會(huì)轉(zhuǎn)動(dòng)的風(fēng)扇葉片那必須用SceneComponent派生這樣你才能設(shè)置它的相對(duì)位置和旋轉(zhuǎn)。2. 藍(lán)圖路徑可視化創(chuàng)建你的第一個(gè)自定義組件2.1 從藍(lán)圖類開(kāi)始而不是從Actor開(kāi)始在虛幻編輯器的Content Browser里右鍵選擇“Blueprint Class”父類選擇“Actor”然后在彈出的對(duì)話框里點(diǎn)擊“Add Component”下拉菜單選擇“Scene Component”作為根組件。這時(shí)候你可能會(huì)問(wèn)為什么需要一個(gè)根組件因?yàn)锳ctor本身沒(méi)有Transform概念如果你希望這個(gè)Actor能被放置到場(chǎng)景里并且擁有明確的世界坐標(biāo)就必須掛一個(gè)SceneComponent作為根。后續(xù)你添加的靜態(tài)網(wǎng)格體、碰撞盒等組件都是掛在這個(gè)根組件下面的子節(jié)點(diǎn)。但如果我們想創(chuàng)建的是一個(gè)“能力模塊”類型的組件比如一個(gè)用于管理背包數(shù)據(jù)的InventoryComponent那更合理的方式不是直接在Actor里加而是單獨(dú)創(chuàng)建藍(lán)圖類父類選擇“ActorComponent”。這樣這個(gè)組件藍(lán)圖可以被任意Actor復(fù)用而不是和某個(gè)具體的Actor綁死。2.2 藍(lán)圖里定義組件的變量與函數(shù)新建好ActorComponent藍(lán)圖后你會(huì)在藍(lán)圖編輯器左側(cè)看到Variables列表。這里要遵循一個(gè)原則盡量將組件內(nèi)部狀態(tài)封裝起來(lái)對(duì)外只暴露必要的函數(shù)接口。比如你的InventoryComponent變量里存放一個(gè)Items數(shù)組外部Actor不要直接操作數(shù)組而是通過(guò)調(diào)用AddItem、RemoveItem這些自定義事件Custom Event來(lái)修改數(shù)據(jù)。這樣后續(xù)如果要加入數(shù)量上限校驗(yàn)、背包滿提示邏輯你只需要改動(dòng)組件內(nèi)部使用這個(gè)組件的Actor代碼完全不用動(dòng)。這里有個(gè)交互細(xì)節(jié)在藍(lán)圖里定義函數(shù)時(shí)建議將“Pure”選項(xiàng)勾上如果是只讀函數(shù)。Pure函數(shù)不會(huì)產(chǎn)生執(zhí)行線可以直接像變量一樣在藍(lán)圖中連線取值圖面會(huì)干凈很多。但注意不要濫用因?yàn)镻ure函數(shù)內(nèi)部如果要修改狀態(tài)那邏輯就危險(xiǎn)了。2.3 動(dòng)態(tài)添加組件和靜態(tài)添加組件的區(qū)別默認(rèn)情況下你在Actor藍(lán)圖里添加的組件是靜態(tài)編譯的也就是說(shuō)這個(gè)Actor的所有實(shí)例都會(huì)有這些組件。但有時(shí)候我們需要運(yùn)行時(shí)動(dòng)態(tài)掛載組件比如游戲里角色撿起一把武器才臨時(shí)在角色身上掛一個(gè)武器網(wǎng)格體組件。這時(shí)可以用藍(lán)圖節(jié)點(diǎn)“Add Component by Class”輸入組件類型引擎會(huì)返回新創(chuàng)建的組件實(shí)例你還可以設(shè)置它掛載到哪個(gè)父組件下。動(dòng)態(tài)添加組件時(shí)有幾個(gè)坑要特別注意首先在構(gòu)造函數(shù)Construction Script里動(dòng)態(tài)添加的組件不會(huì)自動(dòng)被保存到關(guān)卡文件里每次Actor被生成都需要重新執(zhí)行其次動(dòng)態(tài)創(chuàng)建的組件如果要在藍(lán)圖里引用它必須把它存儲(chǔ)到組件類型變量里不能像靜態(tài)組件那樣直接拖出引腳。3. C路線用代碼打造高性能且可復(fù)用的組件3.1 創(chuàng)建自定義C組件的完整準(zhǔn)備藍(lán)圖組件方便直觀但在大量Actor都掛載復(fù)雜組件時(shí)藍(lán)圖性能開(kāi)銷和可維護(hù)性都是問(wèn)題。項(xiàng)目規(guī)模上來(lái)后我強(qiáng)烈建議組件用C寫藍(lán)圖只做數(shù)據(jù)配置和事件綁定。在編輯器里通過(guò)Tools → New C Class創(chuàng)建父類選擇ActorComponent或根據(jù)需求選SceneComponent。生成的.h和.cpp文件里你需要關(guān)注的幾個(gè)核心點(diǎn)類聲明里用UCLASS()宏標(biāo)記指定Blueprintable允許被藍(lán)圖繼承、BlueprintType允許在藍(lán)圖里作為變量類型。如果不加這些宏你的組件在藍(lán)圖里根本搜不到。組件類名通常以Component結(jié)尾比如MyInventoryComponent但在構(gòu)造函數(shù)里你可以通過(guò)ObjectInitializer設(shè)置子對(duì)象。用UPROPERTY(EditAnywhere, BlueprintReadWrite, Category Config)暴露配置屬性到細(xì)節(jié)面板設(shè)計(jì)策劃可以直接在藍(lán)圖里調(diào)整參數(shù)值不用動(dòng)代碼。3.2 組件的生命周期初始化、激活、銷毀C組件最核心的就是四個(gè)生命周期函數(shù)BeginPlay游戲開(kāi)始時(shí)調(diào)用適合做初始化、TickComponent每幀調(diào)用適合做持續(xù)更新邏輯、EndPlay角色銷毀時(shí)清理、OnComponentDestroyed組件被銷毀時(shí)的清理。和Actor的Tick區(qū)別是組件的Tick可以被單獨(dú)的ComponentTickEnabled開(kāi)關(guān)控制如果你的組件不需要每幀更新一定要把PrimaryComponentTick.bCanEverTick設(shè)為false否則幾百個(gè)掛載組件的Actor會(huì)白白消耗CPU資源。這里還有個(gè)容易被忽略的點(diǎn)組件在注冊(cè)后RegisterComponent才能訪問(wèn)世界場(chǎng)景、碰撞查詢等能力。如果你在構(gòu)造函數(shù)里就嘗試用GetWorld()-SpawnActor那基本必崩因?yàn)榻M件此時(shí)還沒(méi)注冊(cè)到世界中。通常做法是在BeginPlay里做這些高開(kāi)銷的初始化工作。4. 典型組件實(shí)戰(zhàn)從需求到落地的完整拆解4.1 需求案例制作一個(gè)可交互的開(kāi)關(guān)門組件假設(shè)我們要給一扇門添加開(kāi)關(guān)功能這個(gè)需求背后涉及的門道非常多。直接把這扇門做成藍(lán)圖Actor當(dāng)然可以但如果你游戲里有幾十種不同類型、不同外觀的門重復(fù)在每個(gè)藍(lán)圖里寫開(kāi)關(guān)邏輯就太蠢了。正確做法是創(chuàng)建一個(gè)DoorInteractionComponentActorComponent類型負(fù)責(zé)門旋轉(zhuǎn)動(dòng)畫、播放音效、鎖定狀態(tài)這些邏輯把“外觀是木門還是鐵門”交給網(wǎng)格體組件去決定。這樣任意一個(gè)Actor掛上這個(gè)組件再放一個(gè)靜態(tài)網(wǎng)格體子組件就立刻變成一扇可用門。組件內(nèi)部實(shí)現(xiàn)開(kāi)關(guān)邏輯時(shí)需要訪問(wèn)所屬Actor身上的其他組件。典型的寫法是GetOwner()獲取掛載該組件的Actor再通過(guò)FindComponentByClass拿到網(wǎng)格體組件或碰撞組件。這里要注意在BeginPlay階段做一次緩存即可不要每幀都FindComponentByClass那會(huì)產(chǎn)生不必要的性能損耗。4.2 界面組件在游戲世界里放置UI熱搜詞里有一堆像“輪播圖組件”“echarts組件”之類的Web前端組件其實(shí)UE里對(duì)應(yīng)的是UMGUnreal Motion Graphics系統(tǒng)。通過(guò)WidgetComponent組件你可以把UI控件擺到三維空間里做成頭頂血條、商店招牌、電影里的“全息投影操作臺(tái)”。WidgetComponent有個(gè)關(guān)鍵屬性“Draw Size”決定了UI在空間中的物理尺寸。如果發(fā)現(xiàn)UI在場(chǎng)景里顯示模糊或太小優(yōu)先檢查這個(gè)值而不是盲改字體大小。另外在屏幕空間UI和世界空間UI之間切換時(shí)需要注意WidgetComponent的“Widget Blend Mode”——選擇透明半透明Transparent模式時(shí)陰影和半透明效果才正常。4.3 物理交互組件碰撞體的正確姿勢(shì)物理碰撞也算組件范疇。UE里碰撞檢測(cè)的核心是PrimitiveComponent的碰撞預(yù)設(shè)Collision Presets比如“Pawn”“OverlapAll”“BlockAll”。初學(xué)者最容易犯的錯(cuò)是把碰撞響應(yīng)設(shè)置為重疊Overlap又想著阻擋玩家穿過(guò)結(jié)果玩家直接走過(guò)去了。Overlap只負(fù)責(zé)檢測(cè)重疊事件不會(huì)產(chǎn)生物理阻擋要阻擋必須設(shè)置Block。如果你需要“既能觸發(fā)事件又不讓玩家穿過(guò)”正確思路是放兩個(gè)組件一個(gè)Block靜態(tài)網(wǎng)格體阻擋移動(dòng)一個(gè)AgroBox重疊組件觸發(fā)對(duì)話或傷害判定。5. 組件通信讓組件之間像團(tuán)隊(duì)一樣協(xié)作5.1 三種基礎(chǔ)通信方式選型組件之間總會(huì)有數(shù)據(jù)交換的需求。比如角色身上的血條UI組件需要監(jiān)聽(tīng)健康組件里血量數(shù)值發(fā)生變化的事件。UE里的通信方案主要有直接獲取都掛載同一Actor通過(guò)GetOwner和FindComponentByClass互相訪問(wèn)、事件分發(fā)器Event Dispatcher、藍(lán)圖接口Interface。三者之間我用一個(gè)簡(jiǎn)單的選型表幫你梳理通信方式使用場(chǎng)景耦合度設(shè)置難度直接獲取組件引用同一個(gè)Actor內(nèi)部的組件互相訪問(wèn)較高低事件分發(fā)器組件對(duì)外廣播狀態(tài)變化不關(guān)心誰(shuí)來(lái)接收低中藍(lán)圖接口不同類型Actor之間做能力約定低中5.2 “父?jìng)髯印焙汀白觽鞲浮钡腢E映射前端熱門詞里那些“父?jìng)髯?、子傳父”看著親切其實(shí)在UE里也能找到對(duì)應(yīng)物。子組件要告訴父Actor“我血量歸零了”最優(yōu)雅的做法不是子組件直接調(diào)用Actor某個(gè)函數(shù)而是組件內(nèi)置一個(gè)Event Dispatcher父Actor在自己的藍(lán)圖里綁定這個(gè)事件的執(zhí)行線。綁定操作在父Actor的BeginPlay里做把組件拖進(jìn)藍(lán)圖空白區(qū)域選擇Assign節(jié)點(diǎn)創(chuàng)建事件綁定。斷開(kāi)綁定用Unbind或UnbindAll尤其注意關(guān)卡切換、角色銷毀時(shí)要主動(dòng)解綁否則會(huì)收到懸空引用導(dǎo)致的報(bào)錯(cuò)或崩潰。反過(guò)來(lái)父Actor要主動(dòng)通知子組件做什么事直接調(diào)用組件公開(kāi)的方法即可。比如角色按下交互鍵父Actor調(diào)用DoorInteractComponent的TryUnlockMe()函數(shù)。這里對(duì)父Actor有嚴(yán)格要求不要在組件里直接引用Actor的具體類型否則組件就綁死在特定Actor上了。正確做法是組件只調(diào)用GetOwner()暴露的通用能力或用接口定義“可交互”的能力然后把具體實(shí)現(xiàn)交給Actor。6. 常見(jiàn)問(wèn)題排查實(shí)錄那些我踩過(guò)的坑6.1 運(yùn)行時(shí)提示“Accessed None”或空引用崩潰這類問(wèn)題九成出在組件注冊(cè)和引用時(shí)機(jī)上。我在做AI感知組件時(shí)曾經(jīng)在構(gòu)造函數(shù)里嘗試訪問(wèn)Owner的Transform結(jié)果每次生成AI角色就崩潰。排查后發(fā)現(xiàn)構(gòu)造函數(shù)階段Owner還沒(méi)有被賦好值更不要說(shuō)組件Transform了。經(jīng)驗(yàn)之談所有需要Owner數(shù)據(jù)的操作全部放到BeginPlay或OnRegister之后執(zhí)行。如果是在編輯器里實(shí)時(shí)預(yù)覽就崩潰先檢查是不是在Construction Script里調(diào)用了運(yùn)行時(shí)函數(shù)。6.2 組件掛載了但不更新、不Tick或不同步掛載到Actor但不動(dòng)優(yōu)先檢查兩個(gè)地方組件有沒(méi)有設(shè)置SetComponentTickEnabled(true)組件所在的Actor有沒(méi)有被設(shè)置為“Always Relevant”。如果是在多人聯(lián)機(jī)游戲里你的組件邏輯只在服務(wù)器上運(yùn)行那客戶端不會(huì)同步必須在組件的復(fù)制屬性、RPC函數(shù)上做標(biāo)記Replicated否則外部看這個(gè)組件就是“死”的。解決辦法在UPROPERTY里加Replicated關(guān)鍵字然后在GetLifetimeReplicatedProps里注冊(cè)復(fù)制屬性。6.3 編輯器崩潰動(dòng)態(tài)添加組件導(dǎo)致臟數(shù)據(jù)動(dòng)態(tài)創(chuàng)建的組件如果包含編輯器專用數(shù)據(jù)比如編輯器可視化輔助線在關(guān)閉關(guān)卡時(shí)容易觸發(fā)斷言崩潰?，F(xiàn)在我的做法是所有編輯器輔助圖形繪制代碼都放到#if WITH_EDITOR宏包裹里生產(chǎn)構(gòu)建時(shí)自動(dòng)剔除。另外保存關(guān)卡時(shí)若提示“組件引用已丟失”多半是動(dòng)態(tài)組件掛在Actor上但Actor的構(gòu)造函數(shù)里沒(méi)有對(duì)應(yīng)創(chuàng)建代碼重新編譯后再打開(kāi)關(guān)卡一般能恢復(fù)。我的組件設(shè)計(jì)心得做了這么多項(xiàng)目我最大的體會(huì)是組件設(shè)計(jì)的關(guān)鍵不在“怎么寫”而在“怎么分”。把功能拆到什么粒度、哪些邏輯放組件哪些放Actor這決定了項(xiàng)目后期的維護(hù)成本。我在實(shí)際項(xiàng)目里的經(jīng)驗(yàn)是四條組件盡量小型化一個(gè)組件只解決一個(gè)明確問(wèn)題組件之間不要直接互相依賴通過(guò)事件或接口通信能不Tick就不Tick靜態(tài)配置優(yōu)先所有組件都要能獨(dú)立脫離具體Actor演示和調(diào)試。遵循這幾條哪怕項(xiàng)目規(guī)模翻倍代碼依然清爽。最后再分享一個(gè)小習(xí)慣給組件命名時(shí)用“功能Component”的統(tǒng)一格式。我自己項(xiàng)目里叫AimAssistComponent、HealthComponent、InventoryComponent一目了然。配件管理也一樣場(chǎng)景里幾十個(gè)Actor互相引用組件時(shí)拆組件拆到“所謂組件總線”那一步就能感受到UE這套組件架構(gòu)的威力了。