游戏客户端架构 / 系统课时
角色拾取为什么会重复触发
角色拾取为什么会重复触发
同一个道具被角色碰到后,背包数量却增加两次,常见原因是角色有多个碰撞体、触发区被反复进入,或道具销毁前仍收到回调。本课用统一的玩家身份和一次性消费标记,让一次拾取最多成功记账一次。
学习目标
- 区分物理触发次数与业务拾取次数。
- 使用玩家根组件和状态标记阻止重复记账。
- 在 Unity 场景中复现并验证多碰撞体拾取。
重复回调从哪里来
Unity 的 OnTriggerEnter(Collider other) 面向碰撞体接触关系,而不是“玩家捡起道具”这一业务事件。角色的身体、脚部可能各有 Collider,它们先后进入同一个拾取 Trigger 时,就可能分别触发回调。角色退出再进入,也会产生新一次 Enter。
此外,Destroy(gameObject) 默认不是立刻在回调中完成销毁。如果每次触发都先加背包、再安排销毁,就可能在物品尚未移除时重复执行。OnTriggerStay 更会随物理更新重复调用;OnTriggerExit 不适合作为一次性拾取的唯一复位依据。
统一玩家身份与消费状态
不要把 other 所指的每个 Collider 当作独立玩家。应从它向父级查找同一个 PlayerInventory,这样身体和脚部碰撞都汇聚到同一个接收者。
道具自身保存 consumed。每次回调先检查是否已消费;确认是有效玩家后,先置为 true,再尝试写入背包。写入失败时恢复 false,成功时禁用 Trigger 并销毁道具。一次拾取是否完成由业务状态决定,不由回调次数决定。

可运行的拾取组件
创建 PlayerInventory.cs,挂在玩家根对象上。容量不足时返回 false,不修改数量。
using UnityEngine;
public sealed class PlayerInventory : MonoBehaviour
{
[SerializeField, Min(1)] private int capacity = 10;
public int Count { get; private set; }
public bool TryAdd(int amount)
{
// 只接受能完整放入背包的数量
if (amount <= 0 || amount > capacity - Count) return false;
Count += amount;
Debug.Log($"Inventory: {Count}");
return true;
}
}创建 PickupOnce.cs,挂在道具 Trigger 所在的对象上。下面两份脚本共同组成完整示例。
using UnityEngine;
[RequireComponent(typeof(Collider))]
public sealed class PickupOnce : MonoBehaviour
{
[SerializeField, Min(1)] private int amount = 1;
private Collider pickupTrigger;
private bool consumed;
private void Awake()
{
pickupTrigger = GetComponent<Collider>();
pickupTrigger.isTrigger = true;
}
private void OnTriggerEnter(Collider other)
{
if (consumed) return;
PlayerInventory inventory = other.GetComponentInParent<PlayerInventory>();
if (inventory == null || !inventory.isActiveAndEnabled) return;
// 先锁定,避免添加背包时的同步回调重复提交
consumed = true;
if (!inventory.TryAdd(amount))
{
consumed = false; // 失败不消耗道具,允许下次进入重试
return;
}
pickupTrigger.enabled = false;
Destroy(gameObject);
}
}预期输出:背包初始为空、道具 amount 为 1 时,即使两个角色 Collider 先后进入,控制台也只出现一次:
Inventory: 1场景布置与验收
- 玩家根对象添加
Rigidbody和PlayerInventory;在其子对象上配置身体、脚部两个非 Trigger Collider,确保两者会进入拾取区。 - 道具添加 Collider 与
PickupOnce,脚本会在Awake中把该 Collider 设为 Trigger;将道具置于角色移动路径。 - 运行场景让两个 Collider 依次穿过道具,检查背包只增加 1,随后道具消失。
- 将背包容量设为 1,先拾取一件,再碰第二件:第二件不会消失,数量不变;只有退出再进入触发区,才会重新尝试。
对象复用时的边界
此实现采用销毁道具。若改用对象池,回收时应禁用碰撞体,仅在下一次正式生成时重置 consumed 和 Trigger,不能在 OnTriggerExit 中随意清零,否则仍可能重复领取。碰撞层过滤能够减少无关回调,但无法替代这道一次性消费保护。