在文档中说明蓝图用法
将真实蓝图节点嵌入正文,结合步骤、引脚和连线说明功能,节点文本随文章保存。
本页内容6 节
节点图是功能说明的一部分
介绍蓝图用法时,把相关节点直接放在文章的对应步骤旁。文字说明前置配置、关键引脚和预期结果,节点图展示执行与数据怎样连接;读者打开文章即可阅读,不需要自行复制节点。
节点文本保存在文章的 BlueprintViewer.source 中,与正文一起版本管理和静态发布,刷新后仍会显示。文章中可以放多组节点,每组使用独立标题和画布。
例子见 Async Message 的蓝图收发与解绑:节点组只保留收发主线,任务保存、解绑与业务筛选在旁边说明。优先展示这一步必需的节点,不为说明消息收发额外铺满入口、打印与完整宿主生命周期。当前例子依据真实类与引脚定义整理,正文明确区分节点展示与尚未执行的 PIE 检查。
在网页编辑器中添加
- 在 UE 蓝图编辑器中选中这一步要说明的完整节点组并复制。
- 在文章对应位置插入“蓝图用法说明”组件。
- 填写节点图标题,将复制内容粘贴到“UE 节点文本”字段。
- 保存文章,回到阅读页,对照文字检查节点、引脚与连线。
网页编辑与本地 MDX 使用同一份数据,不需要另存截图或手工绘制连线。
在 MDX 中添加
使用下面的组件格式,source 填写从 UE 复制的完整文本:
<BlueprintViewer title="这组节点的用途" source={'此处填写从 UE 复制的完整节点文本'} />多行节点文本按 JavaScript 字符串转义保存,例如使用 \n 换行;网页编辑器可以直接输入多行。单组最多接收 200,000 个字符,标题用于说明这组节点在当前步骤中的职责。
平移与缩放
画布按节点实际边界自动取景,不必逐篇配置初始缩放。鼠标左键拖动空白区域或节点标题平移,直接滚轮围绕指针缩放;点击“100%”恢复原始大小查看引脚,“适应画布”重新总览。触屏使用单指平移、双指缩放;“重置视图”恢复本组节点的初始取景。需要核对复制内容时,可以展开“查看节点文本”。
写作时先预览
节点预览页用于保存文章前检查复制内容。这里临时粘贴的文本不会写入文章,清空或刷新后移除;确认后将文本放到正文组件的 source 中。预览页是写作辅助,正式说明以文章中的节点图为准。
展示边界
查看器基于本地 blueprintUE 渲染器读取复制文本,不直接打开 .uasset,不执行蓝图,也不连接运行中的项目编辑器。
复杂自定义节点,以及材质、动画、Niagara、PCG 等其他图表,需要使用目标节点文本验证。架构与时序继续使用适合说明关系的正文图表;讲解蓝图操作时再使用实际节点图。
如何维护正文与图表见维护这本手册;项目动作如何衔接见Logic 生命周期与 Input Handler。