2.7 KiB
2.7 KiB
BP_TestItem
基本信息
- 类型: Blueprint (Actor)
- 父类: Actor
- 源文件: /Game/Blueprints/Playground/BP_TestItem.BP_TestItem
- 模块: Content/Blueprints/Playground
功能概述
Playground 中的测试用物品 Actor，用于验证物品系统的基础功能。通过 EventGraph（4 事件, 23 节点）处理与 BP_InventoryComp 和 BP_DropItemInvComp 的交互逻辑。
设计用意
Playground 场景中的通用测试物品载体，用于验证物品的生成、持有、丢弃等基础流程。作为物品系统在场景中的最小可测试单元。
职责范围
- 作为场景中的测试物品 Actor 存在
- 通过 BP_InventoryComp 和 BP_DropItemInvComp 与库存系统交互
项目内依赖
| 依赖项 | 关系 | 源文件 |
|---|---|---|
| BP_InventoryComp | 引用 | /Game/Blueprints/Playground/BP_InventoryComp |
| BP_DropItemInvComp | 引用 | /Game/Blueprints/Playground/BP_DropItemInvComp |
外部视角
BP_TestItem 是 Actor 的子类，从外部调用者视角：
接口概览
- 无自定义变量
EventGraph 事件
| 事件 | 类型 | 触发时机 | 行为 |
|---|---|---|---|
事件开始运行 |
原生覆盖 (BeginPlay) | Actor 生成时 | 预留（当前无连线逻辑） |
事件Actor开始重叠 |
原生覆盖 (OnActorBeginOverlap) | 与其他 Actor 碰撞时 | 预留（当前无连线逻辑） |
事件Tick |
原生覆盖 | 每帧 | 预留（当前无连线逻辑） |
On Component Begin Overlap (Collison) |
组件绑定事件 | 玩家进入物品触发区域时 | 检查 BP_DropItemInvComp 有效 → 获取 ItemCount → 获取 ItemViews → 打印物品名称和数量 → 延迟 → 通过 BP_DropItemInvComp.RequestMoveItem 转移物品 → 销毁自身 |
外部交互方式
- 放置在 Playground 关卡中作为测试物品实体
- 通过 BP_InventoryComp 和 BP_DropItemInvComp 与库存系统交互
- 由 BP_TestItemCluster 生成和管理
使用方法
BP_TestItem 在项目中的典型调用流程：
- 物品拾取流程 — 玩家进入测试物品触发区域 → On Component Begin Overlap → 验证 DropItemInvComp 有效 → 打印物品信息到屏幕 → RequestMoveItem 转移物品到玩家库存 → 延迟后销毁自身 Actor
- 批量生成流程 — BP_TestItemCluster 在场景中生成多个 BP_TestItem 子 Actor → 每个作为独立物品实例
用例
| 引用方 | 路径 | 用途 |
|---|---|---|
| Playground | /Game/地图关卡/Playground |
关卡中的测试物品，验证物品系统基础流程 |
| BP_TestItemCluster | /Game/Blueprints/Playground/BP_TestItemCluster |
作为模板批量生成测试物品 |