企业官网建设流程全解析

1. 项目概述：UE5粒子特效与序列工具的UI交响曲

如果你在UE5里做过粒子特效，尤其是那些需要精确控制发射、变化、消失节奏的复杂效果，那你一定对Sequencer（序列工具）又爱又恨。爱的是它强大的时间线控制能力，恨的是在特效制作流程中，反复在粒子编辑器和Sequencer之间切换、手动对齐关键帧、调试参数同步，这个过程繁琐得让人头皮发麻。今天要聊的这个“基本序列工具UI”项目，正是为了解决这个痛点而生。它不是一个庞大的插件，而是一个精巧的、聚焦于提升粒子特效师与Sequencer协作效率的工具界面。简单来说，它旨在把粒子系统里那些最常需要与时间线联动的参数——比如发射器开关、粒子生成率、颜色、大小等——以一种直观、快捷的方式，集成到Sequencer的UI中，让你能像控制动画角色一样，在时间线上直接“导演”你的粒子特效。

这个工具的核心用户，就是每一位使用UE5进行实时视觉开发的同学，无论是游戏特效师、影视预演艺术家，还是建筑可视化设计师。当你需要制作一个随着音乐节奏爆发的魔法阵、一个角色触碰后逐渐消散的烟雾，或者一段建筑生长动画中同步出现的尘埃粒子时，这个工具能让你告别手忙脚乱的跨窗口操作。它解决的不仅仅是“方便”的问题，更是“精准”和“可迭代”的问题。通过UI将控制逻辑标准化、可视化，你能够更专注于艺术表现本身，而无需分心于底层技术实现的琐碎细节。接下来，我们就深入拆解这个工具的设计思路、实现要点，以及如何将它融入你的特效生产管线。

2. 核心需求与设计思路拆解

2.1 特效师的工作流痛点分析

在传统的UE5粒子特效与Sequencer配合的工作流中，通常存在几个明显的效率瓶颈。首先，参数同步困难。假设你需要粒子在时间线第50帧开始发射，在第100帧达到最大强度，然后在第150帧完全消失。你需要在Niagara或Cascade粒子系统中设置好这些参数随时间变化的曲线，然后回到Sequencer，确保你放置的粒子系统Actor的关键帧与这些变化完美对齐。任何后续的节奏调整，都意味着你需要两边同时修改，极易出错。

其次，实时预览与调试不直观。在Sequencer中播放时间线时，虽然能看到粒子效果，但如果你想微调某个特定时间点的粒子颜色，你必须暂停播放，找到对应帧，然后打开粒子编辑器去修改颜色参数，再返回Sequencer查看效果。这个过程打断了创作的沉浸感，让迭代变得缓慢。

最后，协作与资产管理复杂。一个复杂的场景可能包含数十个粒子系统，每个系统又有多个需要随时间变化的参数。在Sequencer的时间线上，这些参数都以一条条独立的轨道存在，管理起来非常混乱。特效师很难快速定位到某个特定的粒子控制轨道，更不用说将这些控制逻辑封装成易于理解和复用的资产了。

2.2 “基本序列工具UI”的设计目标

基于以上痛点，这个工具UI的设计目标非常明确：

1. 参数暴露的集中化与友好化：不是将所有粒子参数都一股脑地塞进Sequencer，而是精心挑选最常被序列控制的参数（如Emitter Enabled, Spawn Rate, Color, Size, Vector Fields等），并通过一个清晰的UI面板进行分组和展示。
2. 控制逻辑的直观可视化：在Sequencer中为这些暴露的参数创建轨道时，工具应提供自定义的轨道外观（比如不同颜色的轨道代表不同类型的参数），并可能集成迷你曲线编辑器，让用户能在Sequencer内部进行简单的插值调整。
3. 操作流程的线性化：目标是实现“选中粒子系统Actor -> 在细节面板或右键菜单中呼出工具UI -> 勾选需要序列化的参数 -> 自动在Sequencer中生成对应轨道”这样一条龙的操作。极大减少鼠标点击和窗口切换。
4. 数据的非破坏性链接：工具生成的轨道应该与原始的粒子系统资产是链接关系，而非拷贝。这样，当你在粒子编辑器中优化了特效本身（比如改了材质），Sequencer中的控制依然有效，无需重新绑定。

这个设计思路的本质，是在UE5已有的强大框架（Sequencer、粒子系统、属性绑定系统）之上，建造一座便捷的桥梁，而不是重新发明轮子。它尊重用户现有的使用习惯，只是让这个习惯变得更高效。

3. 核心技术点解析与UE5模块选择

3.1 核心依赖：Slate框架与属性系统

要实现这个自定义UI，首要任务是深入理解UE5的两大基础：Slate UI框架和属性系统（Property System）。

Slate是UE5用于构建编辑器界面和游戏内UI的声明式框架。对于编辑器工具开发，我们主要使用它的Slate Widgets来构建界面元素。你需要熟悉SButton、SCheckBox、STextBlock、SListView等基础控件，以及SVerticalBox、SHorizontalBox等布局容器。工具UI通常会作为一个独立的SWindow（窗口）或嵌入到现有编辑器的SDockTab（ dockable tab）中。对于我们的需求，将其作为粒子系统Actor细节面板的一个自定义扩展栏目（IDetailCustomization）是更集成、更友好的方式。

属性系统是UE5反射机制的核心。粒子系统的每一个可调参数，本质上都是UObject类的一个UProperty（或FProperty）。工具需要动态地读取粒子系统组件（UNiagaraComponent或UParticleSystemComponent）上所挂载的资产（UNiagaraSystem/UParticleSystem）中的参数集。这涉及到使用FProperty的元数据（Metadata）来识别哪些参数是用户希望暴露给序列的，以及它们的类型（浮点、向量、颜色、布尔等）。

注意：UE5中Niagara和传统的Cascade粒子系统架构不同，参数访问方式也有差异。工具需要兼容两者，或者至少明确声明主要支持哪一种（目前行业趋势是Niagara）。对于Niagara，参数主要通过UNiagaraComponent::GetOverrideParameters()接口来获取和设置。

3.2 Sequencer扩展：轨迹与截面（Sections）

要让参数在Sequencer中可控，我们必须扩展Sequencer。这主要涉及两个概念：轨迹（Tracks）和截面（Sections）。

一个UMovieSceneTrack代表时间线上的一条轨道（如变换轨道、音频轨道）。我们需要为每一类粒子参数创建自定义的轨迹类型，例如MovieSceneParticleParameterTrack。这条轨迹本身不存储具体数据，它管理的是多个截面（Sections）。

一个UMovieSceneSection是轨迹上的一段数据区间。对于我们来说，一个截面就对应一个粒子参数在时间线上的所有关键帧数据。例如，一个控制“发射率”的MovieSceneParticleParameterSection，内部会存储一系列时间-浮点数值的关键帧。

工具UI的核心任务之一，就是当用户在UI面板上勾选了“发射率（Spawn Rate）”参数后，后台逻辑需要：

1. 获取当前选中的Actor和Sequencer实例。
2. 在Sequencer中为该Actor添加或找到对应的MovieSceneParticleParameterTrack。
3. 在该轨迹上创建一个新的MovieSceneParticleParameterSection。
4. 将这个截面与粒子组件具体的参数（通过一个唯一的参数名或GUID）绑定起来。

3.3 数据绑定与实时评估

创建了轨道和截面只是第一步，如何让Sequencer在播放时，实时地将关键帧数据“施加”到运行的粒子系统上，才是关键。这依赖于UE Sequencer的绑定系统（Binding）和评估系统（Evaluation）。

当你在Sequencer中添加一个Actor，它会创建一个FMovieSceneBinding，将轨道数据与场景中的具体对象（通过Spawnable或Possessable）关联起来。我们的自定义轨道也需要参与这个绑定过程。

在每一帧的评估中，Sequencer会遍历所有轨道和截面。对于我们的粒子参数截面，评估逻辑（通常在对应的MovieSceneParticleParameterSection的Evaluate函数中）需要：

1. 根据当前播放时间，从关键帧数据中插值计算出当前的参数值（比如发射率=500）。
2. 通过绑定找到对应的粒子组件（UNiagaraComponent）。
3. 调用该组件的方法，将计算出的参数值设置为运行时覆盖值（Runtime Override）。例如，对于Niagara，可能是调用SetVariableFloat()或SetOverrideParameterValue()。

这个过程确保了粒子效果能够严格跟随时间线的变化，实现精准的同步。

4. 工具UI的详细实现步骤

4.1 第一步：创建编辑器工具模块

首先，我们需要创建一个新的UE5编辑器模块。在项目的.Build.cs文件中添加Slate,SlateCore,Sequencer,NiagaraEditor（如果支持Niagara）,PropertyEditor等模块的依赖。

// YourProjectEditor.Build.cs PublicDependencyModuleNames.AddRange(new string[] { "Core", "CoreUObject", "Engine", "Slate", "SlateCore", "UnrealEd", "Sequencer", "MovieScene", "MovieSceneTracks", "NiagaraEditor", // 可选，用于Niagara深度集成 "PropertyEditor", // 用于自定义细节面板 "EditorFramework", "EditorStyle", "InputCore", "MainFrame", "Projects" });

然后，在模块的启动函数中，注册我们的自定义细节面板扩展。这是将UI注入到粒子系统Actor细节面板的标准方式。

void FYourParticleSequencerModule::StartupModule() { FPropertyEditorModule& PropertyModule = FModuleManager::LoadModuleChecked<FPropertyEditorModule>("PropertyEditor"); // 注册对ANiagaraActor和/或AEmitterActor的细节面板定制 PropertyModule.RegisterCustomClassLayout( ANiagaraActor::StaticClass()->GetFName(), FOnGetDetailCustomizationInstance::CreateStatic(&FParticleSequencerDetailCustomization::MakeInstance) ); PropertyModule.NotifyCustomizationModuleChanged(); }

4.2 第二步：实现自定义细节面板（IDetailCustomization）

FParticleSequencerDetailCustomization类是实现UI面板的核心。它继承自IDetailCustomization，需要在CustomizeDetails函数中构建我们的Slate控件。

UI布局设计思路：

1. 头部信息区：显示当前选中的粒子系统资产名称，以及一个“刷新参数列表”的按钮。
2. 参数列表区：一个可滚动的列表（SListView），展示从粒子组件中扫描到的、可序列化的参数。每一行包含：
   • 复选框（SCheckBox）：用于选择是否将该参数添加到Sequencer。
   • 参数图标和名称（STextBlock）。
   • 参数类型（浮点、颜色等）。
   • 当前值（可编辑的文本框，仅用于预览，实际控制由Sequencer完成）。
3. 操作按钮区：“添加到Sequencer”按钮、 “从Sequencer移除”按钮、“创建动画轨道”按钮等。

构建Slate UI是一个组合控件的过程，代码结构会类似这样：

TSharedRef<SWidget> FParticleSequencerDetailCustomization::CreatePameterListWidget() { return SNew(SVerticalBox) + SVerticalBox::Slot() .AutoHeight() .Padding(5) [ SNew(STextBlock) .Text(LOCTEXT("Title", "粒子序列控制参数")) .Font(IDetailLayoutBuilder::GetDetailFontBold()) ] + SVerticalBox::Slot() .FillHeight(1.0f) [ SAssignNew(ParameterListView, SListView<TSharedPtr<FParticleParameter>>) .ListItemsSource(&FilteredParameters) // 参数数据源 .OnGenerateRow(this, &FParticleSequencerDetailCustomization::OnGenerateParameterRow) .SelectionMode(ESelectionMode::None) ]; }

OnGenerateParameterRow函数负责生成列表中的每一行，这里就是创建复选框、文本等控件的地方。

4.3 第三步：扫描与筛选粒子参数

这是工具逻辑的关键。我们需要从选中的Actor身上获取粒子组件，并解析其参数。

对于Niagara系统：

1. 通过ANiagaraActor::GetNiagaraComponent()获取组件。
2. 通过UNiagaraComponent::GetAsset()获取UNiagaraSystem。
3. 遍历UNiagaraSystem的GetExposedParameters()或通过UNiagaraComponent::GetOverrideParameters()获取所有可覆盖的参数。
4. 根据参数类型（FNiagaraVariable）进行筛选。我们通常只关心FNiagaraTypeDefinition为Float,Vector2/3/4,Color,Bool等简单类型的参数。复杂的结构体或纹理参数通常不适合直接序列化。

参数筛选逻辑：并非所有暴露的参数都适合用Sequencer控制。一个好的实践是：

• 忽略只读参数：通过参数元数据判断。
• 忽略引擎内部参数：如System.*开头的系统内部变量。
• 提供用户黑名单/白名单：可以在UI上提供一个设置，让用户自定义过滤规则，或者记住用户上次隐藏的参数，提升个性化体验。

扫描到的参数需要封装成FParticleParameter这样的自定义数据结构，存储其名称、类型、默认值、唯一标识符（如Niagara变量的FGuid）以及是否被选中的状态。

4.4 第四步：与Sequencer交互

当用户点击“添加到Sequencer”时，工具需要执行以下操作：

1. 获取当前Sequencer：使用FSequencerUtilities::GetSequencer或通过GEditor->GetEditorSubsystem<UAssetEditorSubsystem>()->FindEditorForAsset来找到当前打开的Level Sequence资产对应的Sequencer实例（ISequencer）。
2. 获取或创建绑定：使用ISequencer::FindSpawnableOrPossessable找到当前选中Actor在Sequencer中的绑定对象（FMovieSceneBinding）。如果不存在（比如Actor还未被添加到Sequencer），则需要先调用ISequencer::AddActor或ISequencer::MakeNewSpawnable将其添加进去。
3. 为每个选中的参数创建轨道和截面：

   // 伪代码逻辑 for (auto& SelectedParam : SelectedParameters) { // 查找或创建粒子参数轨迹 UMovieSceneParticleParameterTrack* ParamTrack = FindOrAddTrack<UMovieSceneParticleParameterTrack>(Binding, Sequencer); // 在轨迹上创建新的截面 UMovieSceneParticleParameterSection* NewSection = Cast<UMovieSceneParticleParameterSection>(ParamTrack->CreateNewSection()); NewSection->SetParameterName(SelectedParam.Name); NewSection->SetParameterId(SelectedParam.UniqueId); // 设置截面范围（默认为整个序列范围） NewSection->SetRange(Sequencer->GetFocusedMovieSceneSequence()->GetMovieScene()->GetPlaybackRange()); // 将截面添加到轨迹 ParamTrack->AddSection(*NewSection); // 可选：在截面上添加两个默认关键帧（开始和结束），使用参数的默认值 NewSection->AddDefaultKeyFrame(0, SelectedParam.DefaultValue); NewSection->AddDefaultKeyFrame(NewSection->GetRange().GetUpperBoundValue(), SelectedParam.DefaultValue); }

4. 刷新Sequencer UI：调用Sequencer->RefreshTree()和Sequencer->NotifyMovieSceneDataChanged()，让新添加的轨道和截面在UI上显示出来。

实操心得：与Sequencer的交互代码需要非常注意时机和对象状态。务必在正确的“事务”（FScopedTransaction）中执行修改操作，以支持撤销/重做。同时，要处理Sequencer可能未打开、多个Sequencer同时存在等边界情况。一个稳健的做法是，当用户点击按钮时，如果当前没有打开的Sequencer，可以弹出一个提示框，引导用户先打开或创建一个Level Sequence。

5. 自定义轨道与截面的实现细节

5.1 定义粒子参数轨道（MovieSceneParticleParameterTrack）

这个轨道类主要负责管理一组同属于一个粒子系统的参数截面。它的定义相对简单：

UCLASS(MinimalAPI) class UMovieSceneParticleParameterTrack : public UMovieSceneNameableTrack { GENERATED_BODY() public: virtual void AddSection(UMovieSceneSection& Section) override; virtual const TArray<UMovieSceneSection*>& GetAllSections() const override; virtual bool HasSection(const UMovieSceneSection& Section) const override; virtual bool IsEmpty() const override; virtual void RemoveSection(UMovieSceneSection& Section) override; virtual void RemoveSectionAt(int32 SectionIndex) override; virtual bool SupportsType(TSubclassOf<UMovieSceneSection> SectionClass) const override; virtual UMovieSceneSection* CreateNewSection() override; // 可以添加一个方法，根据参数名快速查找截面 UMovieSceneParticleParameterSection* FindSectionByParameterName(const FName& InParamName); private: UPROPERTY() TArray<UMovieSceneSection*> Sections; };

CreateNewSection函数应返回我们自定义的UMovieSceneParticleParameterSection实例。

5.2 定义粒子参数截面（MovieSceneParticleParameterSection）

截面类是数据存储和评估的核心。它需要存储关键帧数据，并在评估时应用值。

UCLASS() class UMovieSceneParticleParameterSection : public UMovieSceneSection { GENERATED_BODY() public: UMovieSceneParticleParameterSection(const FObjectInitializer& ObjectInitializer); // 设置/获取此截面控制的参数标识 void SetParameterInfo(const FName& InName, const FGuid& InId); FName GetParameterName() const { return ParameterName; } // 评估函数：根据输入的时间，输出参数值 virtual void Evaluate(const FMovieSceneEvaluationOperand& Operand, const FMovieSceneContext& Context, const FPersistentEvaluationData& PersistentData, FMovieSceneExecutionTokens& ExecutionTokens) const override; // 关键帧数据通道（例如，对于浮点参数，使用FMovieSceneFloatChannel） UPROPERTY() FMovieSceneFloatChannel FloatChannel; // 示例：浮点参数通道 // 对于颜色等复杂类型，可能需要定义对应的通道或使用通用结构 // UPROPERTY() // FMovieSceneVectorChannel VectorChannel; private: FName ParameterName; FGuid ParameterId; // 用于唯一标识粒子系统中的参数 };

在Evaluate函数中，我们需要：

1. 从FloatChannel（或其他通道）中，根据当前帧时间（Context.GetTime()）插值计算出现值。
2. 通过ExecutionTokens添加一个执行令牌（FParticleParameterExecutionToken），这个令牌包含了参数名/ID和计算出的值。Sequencer的最终阶段会消费这些令牌，将值应用到目标对象上。

5.3 实现执行令牌与模板（Template）

执行令牌（IMovieSceneExecutionToken）是连接Sequencer评估和实际对象属性修改的桥梁。我们需要为粒子参数创建一个：

struct FParticleParameterExecutionToken : IMovieSceneExecutionToken { FParticleParameterExecutionToken(FName InParamName, const FGuid& InParamId, const FNiagaraVariable& InValue) : ParamName(InParamName), ParamId(InParamId), Value(InValue) {} virtual void Execute(const FMovieSceneContext& Context, const FMovieSceneEvaluationOperand& Operand, FPersistentEvaluationData& PersistentData, IMovieScenePlayer& Player) override { // 通过Operand找到对应的粒子组件 for (TWeakObjectPtr<> WeakObject : Player.FindBoundObjects(Operand)) { if (UActorComponent* Component = Cast<UActorComponent>(WeakObject.Get())) { // 假设我们有一个辅助函数来应用参数值 ApplyParameterToComponent(Component, ParamName, ParamId, Value); } } } FName ParamName; FGuid ParamId; FNiagaraVariable Value; };

为了让Sequencer知道如何为我们的轨道创建执行器，还需要一个FMovieSceneParticleParameterTemplate。这个模板类在Sequencer初始化时被创建，它负责在评估时生成我们的FParticleParameterExecutionToken。它的Evaluate函数会遍历轨道的所有截面，调用截面的Evaluate函数，截面再将生成的令牌添加到ExecutionTokens中。

6. 高级功能与优化方向

6.1 参数分组与文件夹支持

当粒子系统参数很多时，一个扁平的列表会变得难以管理。我们可以引入分组概念：

• 按模块分组：Niagara系统中，参数属于不同的模块（Emitter Update, Particle Update等）。可以按模块名称对参数进行树状组织。
• 用户自定义分组：允许用户通过元数据（如特定的Tag）或手动拖拽，在UI中创建自定义文件夹，将相关参数（如所有颜色相关的参数）放在一起。在添加到Sequencer时，可以创建对应的文件夹轨道来保持结构清晰。

6.2 批量操作与预设保存

效率工具的核心是批量处理。应实现以下功能：

• 框选多参数：在参数列表中支持Shift/Ctrl多选，一次性添加或移除多个轨道。
• 参数预设：允许用户将一组常用的参数选择（例如，“烟雾基础控制”：密度、颜色、消散速度）保存为预设。当处理同类型特效时，可以一键应用预设，快速完成Sequencer轨道搭建。
• 轨道布局预设：不仅可以保存参数选择，还可以保存这些参数轨道在Sequencer中的排列顺序、折叠状态甚至颜色标签，形成一套标准的控制面板。

6.3 与曲线编辑器的深度集成

目前，参数的关键帧编辑仍需在Sequencer的主时间线或曲线编辑器中进行。更高级的集成可以是：

• 内嵌迷你曲线编辑器：在工具UI的参数行右侧，提供一个按钮，点击后可以展开一个小的、针对该参数的曲线编辑窗口，进行简单的关键帧添加和调整，而无需跳转到庞大的曲线编辑器面板。
• 表达式驱动：支持将参数轨道与Sequencer的其他轨道（如音频振幅轨道）通过简单的表达式链接。例如，让粒子大小绑定到音频轨道的音量值上，实现音频可视化效果。这可以通过扩展截面的功能，使其能引用其他轨道的输出值来实现。

6.4 性能考量与撤销重做

• 延迟加载与虚拟化：如果粒子系统有成百上千个暴露参数，一次性全部扫描和加载到UI列表会卡顿。需要实现列表的虚拟化，只渲染可视区域内的参数行。
• 增量式更新：当用户在Sequencer中频繁添加/删除轨道时，应避免每次都对整个UI或Sequencer进行全量刷新。使用Slate的Invalidate/缓存机制进行局部更新。
• 完善的撤销/重做：每一个用户操作（添加轨道、删除轨道、修改参数选择）都必须包裹在FScopedTransaction中，并提供清晰的撤销描述（如“添加粒子发射率轨道”）。这是专业编辑器工具的基本要求。

7. 常见问题与调试技巧实录

7.1 UI不显示或显示错乱

• 问题：自定义的细节面板扩展没有出现在目标Actor的细节面板中。
• 排查：
  1. 检查模块加载：确保你的编辑器模块已正确加载。在输出日志（Output Log）中查看是否有相关错误。
  2. 检查类名匹配：RegisterCustomClassLayout时使用的类名（如ANiagaraActor::StaticClass()->GetFName()）必须完全匹配。如果希望同时支持AEmitter（Cascade），需要分别注册。
  3. 检查优先级：可能有其他插件注册了更高优先级的同类定制，覆盖了你的UI。可以尝试调整注册顺序或使用FPropertyEditorModule::RegisterCustomClassLayout的变体。
  4. Slate控件调试：使用控制台命令Slate Debugger可以可视化UI的布局和边界，检查控件是否因尺寸计算错误（如高度为0）而不可见。

7.2 参数扫描不全或类型错误

• 问题：工具UI中列出的参数比在Niagara编辑器中看到的少，或者浮点参数被识别成了向量。
• 排查：
  1. 确认API：确保你使用的是正确的API获取参数。对于Niagara，UNiagaraComponent::GetOverrideParameters()获取的是用户覆盖的参数，而UNiagaraSystem::GetExposedParameters().ReadParameterVariables()可能更全面。需要结合使用。
  2. 检查过滤条件：仔细检查你的参数过滤逻辑，是否无意中过滤掉了某些有效参数。可以临时注释掉所有过滤代码，看看是否能列出所有参数。
  3. 验证类型识别：打印或调试查看每个FNiagaraVariable的GetType()信息，确保你的类型映射逻辑（将Niagara类型映射为工具内部的EParamType枚举）是正确的。

7.3 Sequencer轨道添加失败

• 问题：点击“添加到Sequencer”后，没有新轨道出现，或者轨道出现了但没有截面。
• 排查：
  1. Sequencer实例为空：确保你的代码成功获取到了有效的ISequencer指针。在非Sequencer编辑器窗口（如单独的关卡编辑器）中调用此功能时，GEditor->GetEditorSubsystem<UAssetEditorSubsystem>()可能返回空。
  2. Actor绑定失败：检查FindSpawnableOrPossessable的返回值。如果Actor是动态生成的（Spawnable），其绑定方式与直接放置在关卡中的（Possessable）不同。确保你的代码能正确处理这两种情况。
  3. 轨道创建逻辑：在FindOrAddTrack函数中，确保在找不到现有轨道时，正确创建了UMovieSceneParticleParameterTrack并调用AddMasterTrack或AddTrack将其添加到绑定或电影场景中。
  4. 事务处理：确保整个添加操作被包裹在FScopedTransaction中。没有事务，Sequencer可能不会响应数据变化并刷新UI。

7.4 参数动画在运行时不生效

• 问题：在Sequencer中设置了关键帧并播放，但粒子效果没有任何变化。
• 排查：
  1. 评估链路检查：这是最复杂的一环。使用断点或UE_LOG逐层调试：
     • 确认你的自定义UMovieSceneParticleParameterSection::Evaluate函数被调用。
     • 确认Evaluate函数根据当前时间从FloatChannel中正确计算出了数值。
     • 确认FParticleParameterExecutionToken被生成并添加到ExecutionTokens。
     • 确认FParticleParameterExecutionToken::Execute函数被调用。
     • 在Execute函数中，确认成功找到了目标粒子组件（UNiagaraComponent）。
  2. 参数应用检查：在ApplyParameterToComponent函数中，确认你调用了正确的Niagara组件方法（如SetVariableFloat）来设置参数。关键点：Niagara有“系统实例（System Instance）”的概念，运行时参数是设置在实例上的。确保你获取和修改的是正确的实例。

     // 正确的Niagara参数设置示例 if (UNiagaraComponent* NiagaraComp = Cast<UNiagaraComponent>(Component)) { FNiagaraVariable Var(FNiagaraTypeDefinition::GetFloatDef(), ParamName); Var.SetValue(Value); // Value是计算出的浮点数 NiagaraComp->SetVariable(Var); // 或 SetVariableFloat }

  3. 播放状态与预览：确保Sequencer处于正确的播放状态（如“播放”或“跳转”），并且关卡视图port正在实时更新。有时需要在Sequencer中点击“仿真”或“游戏”模式下的播放按钮。

7.5 内存泄漏与资源管理

• 问题：长时间使用工具或频繁开关编辑器后，可能出现内存增长。
• 排查与预防：
  1. Slate资源释放：确保所有TSharedPtr和TSharedRef在模块关闭或UI销毁时正确释放。特别检查列表视图（SListView）的数据源（ItemsSource）的生命周期管理。
  2. 委托（Delegate）解绑：如果你监听了诸如OnActorSelectionChanged、OnSequencerOpened等全局委托，必须在模块的ShutdownModule函数或自定义类的析构函数中将其解绑。
  3. UObject引用：避免在Slate控件或非UObject类中持有对UObject的强引用（UPROPERTY或裸指针而不考虑GC）。如果需要引用，使用TWeakObjectPtr。

实操心得：调试编辑器工具时，输出日志（Output Log）是你的最佳朋友。在关键步骤大量使用UE_LOG(LogTemp, Log/ Warning/ Error, TEXT(“...“))。同时，利用UE5的“调试”->“窗口”->“对象查看器”来实时查看你创建的UObject（如自定义的MovieScene轨道和截面）是否被正确创建和引用。对于Slate UI的布局问题，Slate Widget Reflector工具是无价之宝，它可以让你像浏览器开发者工具一样检查UI树。