2.2 KiB
2.2 KiB
BP_TestItemCluster
基本信息
- 类型: Blueprint (Actor)
- 父类: Actor
- 源文件: /Game/Blueprints/Playground/BP_TestItemCluster.BP_TestItemCluster
- 模块: Content/Blueprints/Playground
功能概述
物品簇 Actor，在场景中生成一组测试物品。通过 EventGraph（4 事件, 15 节点）管理多个 BP_TestItem 的生成和排列，用于测试场景中大量物品的呈现效果。
设计用意
Playground 中用于测试批量物品生成和布局的 Actor，依赖 BP_TestItem 作为子物品模板，验证物品在场景中的集群表现。
职责范围
- 生成和管理多个 BP_TestItem 实例
- 控制物品簇在场景中的布局
项目内依赖
| 依赖项 | 关系 | 源文件 |
|---|---|---|
| BP_TestItem | 引用(子物品) | /Game/Blueprints/Playground/BP_TestItem |
外部视角
BP_TestItemCluster 是 Actor 的子类，从外部调用者视角：
EventGraph 事件
| 事件 | 类型 | 触发时机 | 行为 |
|---|---|---|---|
事件开始运行 |
原生覆盖 (BeginPlay) | Actor 生成时 | 设置定时器 → 10秒后触发 Resume |
事件Actor开始重叠 |
原生覆盖 (OnActorBeginOverlap) | 与其他 Actor 碰撞时 | 预留（当前无连线逻辑） |
事件Tick |
原生覆盖 | 每帧 | 预留（当前无连线逻辑） |
Resume |
自定义事件 | 定时器触发时 | 获取 DefaultSceneRoot 的子组件 → ForEach → Cast 到 ChildActorComponent → 验证 ChildActor 存在 → 取反销毁标记 → 设置新的 ChildActorClass |
接口概览
- 无自定义变量或公开函数
外部交互方式
- 放置在 Playground 关卡中，在场景中生成一组 BP_TestItem 实例
- 外部系统不直接与 BP_TestItemCluster 交互，通过关卡引用访问
使用方法
BP_TestItemCluster 在项目中的典型调用流程：
- 物品簇生成流程 — BeginPlay → 设置 Resume 定时器（10秒循环）→ 定时器触发 → 遍历子 ChildActorComponent → 随机切换子 Actor 类 → 测试不同物品类型的批量展示
用例
| 引用方 | 路径 | 用途 |
|---|---|---|
| Playground | /Game/地图关卡/Playground |
关卡中的物品簇，演示批量物品生成和布局 |