使用 Item Behavior、Prop 和 Interactable 组件创建可收集物品
概述
当玩家靠近可收集物品（collectible）时，会看到提示按 E 进行交互（interact），物品会被添加到快捷栏（hotbar slot）。玩家随后可按对应数字键使用该物品。 本指南演示如何通过添加模型并挂载以下组件来创建可收集物品：
- 物品行为（Item behavior）：处理物品属性和背包逻辑。
- 道具（Prop）：管理物品的外观和交互表现。
- 可交互（Interactable）：使玩家可与物体交互。
- 事件触发器（Event Trigger）：处理拾取物品、添加到快捷栏等事件。
你也可以直接在 Packages 中使用智能资产 可收集道具（Collectable Item） 快速搭建可收集物品，或参考其实现自定义。
添加可收集物品模型
-
在资产库（Asset Library）中找到模型并放入场景。
-
选中模型，点击 更多（More） 图标打开 属性（Properties） 窗口。
添加组件
-
在 属性 窗口点击 添加组件（Add Components）> 物品行为组件（Item Behavior Component），添加 Item Behavior 组件。
-
配置 Item Behavior 组件。
-
点击 添加组件 > 道具组件（Prop Component），添加并配置 Prop 组件，定义交互方式和提示。
-
点 击 添加组件 > 可交互组件（Interactable Component），添加并配置 Interactable 组件，使玩家可与物体交互。记得添加插件（plug-in，将交互逻辑与道具行为、外观或检查功能关联），并将其分配给 PropComponent 以启用交互。
设置事件触发器
-
在 属性 窗口点击 添加事件触发器（Add Event Trigger）。
-
配置触发器，使玩家交互时将道具添加到快捷栏：
- 触发对象（Trigger Object）：自身（Self）
- 触发事件（Trigger Event）：OnPropInteracted
- 动作对象（Action Object）：自身（Self）
- 动作函数（Action Function）：AddToItemSlots
试玩
进入Play模式，验证如下：
- 按 E 可与可收集物品交互。
- 物品被添加到快捷栏。
- 按分配的数字键可使用物品。
（可选）让可收集物品可检查和可放置
让可收集物品可检查：
-
添加并配置 Inspectable Component。该组件决定检查提示，并允许玩家在检查界面查看物品详情。更多属性说明见 Inspectable。
-
在 Interactable Component 中将 InspectableComponent 作为插件分配。
只有 插件 1（Plug-in 1） 的提示会在游戏中显示。如果 Interactable Component 本身被设为 插件 1 而不是 PropComponent，则物品将无法被收集，即使 PropComponent 是 插件 2。
试玩时，按 E 拾取道具后，按 I 进入检查界面。
在检查界面中：
- 滚轮缩放道具。
- 左键拖动旋转。
- 按 Esc 退出界面。
如只需物品可检查（不可收集），需添加并配置：Item Behavior、Inspectable、Interactable、Event Trigger 组件。
如需让物品拾取后可放置：
- 添加并配置 Placeable Component。该组件允许玩家拾取后将道具重新放回场景。更多属性说明见 Placeable。
故障排查
-
未出现交互提示
- 检查 Interactable 组件是否正确分配了插件（Prop Component 或 Inspectable Component）。
- 确认玩家处于交互范围内。
-
交互后未添加到背包栏
- 检查 Event Trigger 是否正确配置了 Trigger Event 和 Action Function。
- 确认 Item Behavior 组件已正确填写物品数据。
-
Interactable 组件无法选择插件
- 请确保已挂载对应组件（Prop 或 Inspectable）后再选择为插件。
-
检查或放置功能无效
- 检查 Inspectable Component 或 Placeable Component 是否已添加并正确配置。
- 检查 Interactable Component 的插件分配是否与预期功能一致（如检查功能应分配 InspectableComponent）。