WBP_TestUI

基本信息

类型: WidgetBlueprint (UserWidget)
父类: UserWidget
源文件: /Game/Blueprints/UI/Dialog/WBP_TestUI.WBP_TestUI
模块: Content/Blueprints/UI/Dialog

功能概述

WBP_TestUI 是对话演示脚本的显示/执行 Widget，实现了 IPresentationScriptExecutor 接口。它接收 FDialogPresentationScriptData，解析其中的 JSON 命令，构建 UI 选择按钮，驱动演示脚本的执行流。同时持有 Ultra Dynamic Sky 引用以支持环境变化命令。

设计用意

WBP_TestUI 是 Dialog 插件在 UI 层的具体实现，承担了脚本执行和 UI 展示的双重职责。在脚本执行侧，它通过 IPresentationScriptExecutor 接口接收 UDialogPresentationSubsystem 的脚本调用，使用 ExecuteScript 启动脚本、ProcessScript 逐条执行命令、ExecuteNextScript 控制流程跳转。在 UI 管理侧，它通过 SummonChoiceButtons 动态生成选项按钮、SetNextScript 设置跳转目标、Get_MainText_Text 绑定主文本显示。这种双职责设计使一个 Widget 即可完成从数据到显示的完整链路。

职责范围

WBP_TestUI 负责演示脚本的接收和执行、对话 UI 的生成和更新、脚本流程控制（跳转、选项分支）。命令的具体实现由 IPresentationStrategyPlugin 处理，DataTable 管理由 UDialogPresentationSubsystem 负责。

项目内依赖

依赖项	关系	源文件
FDialogPresentationScriptData	输入数据	Dialog 插件
FDialogPresentationScriptCommand	输入数据	Dialog 插件
IPresentationScriptExecutor	实现接口	Dialog 插件
UDialogPresentationSubsystem	调用	Dialog 插件

外部视角

WBP_TestUI 是 UserWidget 的子类，实现 IPresentationScriptExecutor 接口，从外部调用者视角：

公开属性（蓝图可读写）

NextScriptName（FName）— 下一条要执行的脚本名称
Sky（Ultra_Dynamic_Sky_C*）— 超动态天空引用，用于环境变化命令

实现接口（IPresentationScriptExecutor）

ExecuteScript(FDialogPresentationScriptData InScript) — 启动一条演示脚本
ProcessScript(FDialogPresentationScriptCommand Presentation) — 逐条解析并执行脚本命令
ExecuteNextScript(FName Name) — 跳转到指定名称的脚本段

UI 管理函数

SummonChoiceButtons(FDialogPresentationScriptData Data) — 动态生成对话选项按钮（WBP_ChoiceButton）
SetNextScritp(FDialogPresentationScriptData Data) — 设置下一条脚本的目标
Get_MainText_Text() → FText — 绑定主文本显示

EventGraph 事件

事件	类型	触发时机	行为
`事件预构造`	原生覆盖 (PreConstruct)	Widget 在蓝图编辑器中放置或运行时创建时	预留（当前无连线逻辑）
`事件构造`	原生覆盖 (Construct)	Widget 创建完成后	预留（当前无连线逻辑）
`事件Tick`	原生覆盖	每帧	预留（当前无连线逻辑）
`事件ExecutePresentationScript`	接口事件 (IPresentationScriptExecutor)	UDialogPresentationSubsystem 调用时	接收 FDialogPresentationScriptData → 调用 ExecuteScript 启动脚本执行
`On Clicked (Next)`	组件绑定事件	用户点击"下一步"按钮时	读取 NextScriptName → 调用 ExecuteNextScript 跳转脚本

外部交互方式

由 UDialogPresentationSubsystem 创建并调用 ExecuteScript
通过 IPresentationScriptExecutor 接口与 Dialog 插件通信
通过 WBP_ChoiceButton 动态生成选项按钮

使用方法

WBP_TestUI 在项目中的典型调用流程：

对话脚本执行流程 — UDialogPresentationSubsystem 加载 DataTable → 收到对话触发信号 → 调用 ExecuteScript（通过接口事件 ExecutePresentationScript）→ WBP_TestUI 的 ProcessScript 逐条解析 JSON 命令 → 更新 MainText 显示文本
选项分支流程 — ProcessScript 遇到选项命令 → 调用 SummonChoiceButtons → 动态生成 WBP_ChoiceButton 并挂接到面板 → 用户选择一个选项 → 更新 NextScriptName
下一步跳转流程 — 用户点击"下一步"按钮 → 触发 On Clicked (Next) → 读取 NextScriptName → 调用 ExecuteNextScript → 跳转到 FDialogPresentationScriptData 中对应名称的脚本段

用例

引用方	路径	用途
DialogTest	`/Game/地图关卡/DialogTest`	在该关卡中执行对话演示脚本

4.5 KiB Raw Permalink Blame History Unescape Escape