55 lines
2.2 KiB
Markdown
55 lines
2.2 KiB
Markdown
# 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` | 关卡中的物品簇，演示批量物品生成和布局 |
|