游戏客户端架构 / 系统课时

角色拾取为什么会重复触发

角色拾取为什么会重复触发

同一个道具被角色碰到后,背包数量却增加两次,常见原因是角色有多个碰撞体、触发区被反复进入,或道具销毁前仍收到回调。本课用统一的玩家身份和一次性消费标记,让一次拾取最多成功记账一次。

学习目标

  • 区分物理触发次数与业务拾取次数。
  • 使用玩家根组件和状态标记阻止重复记账。
  • 在 Unity 场景中复现并验证多碰撞体拾取。

重复回调从哪里来

Unity 的 OnTriggerEnter(Collider other) 面向碰撞体接触关系,而不是“玩家捡起道具”这一业务事件。角色的身体、脚部可能各有 Collider,它们先后进入同一个拾取 Trigger 时,就可能分别触发回调。角色退出再进入,也会产生新一次 Enter。

此外,Destroy(gameObject) 默认不是立刻在回调中完成销毁。如果每次触发都先加背包、再安排销毁,就可能在物品尚未移除时重复执行。OnTriggerStay 更会随物理更新重复调用;OnTriggerExit 不适合作为一次性拾取的唯一复位依据。

统一玩家身份与消费状态

不要把 other 所指的每个 Collider 当作独立玩家。应从它向父级查找同一个 PlayerInventory,这样身体和脚部碰撞都汇聚到同一个接收者。

道具自身保存 consumed。每次回调先检查是否已消费;确认是有效玩家后,先置为 true,再尝试写入背包。写入失败时恢复 false,成功时禁用 Trigger 并销毁道具。一次拾取是否完成由业务状态决定,不由回调次数决定。

角色多个碰撞体与一次性拾取门控的关系

可运行的拾取组件

创建 PlayerInventory.cs,挂在玩家根对象上。容量不足时返回 false,不修改数量。

csharp
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 所在的对象上。下面两份脚本共同组成完整示例。

csharp
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 先后进入,控制台也只出现一次:

text
Inventory: 1

场景布置与验收

  1. 玩家根对象添加 Rigidbody 和 PlayerInventory;在其子对象上配置身体、脚部两个非 Trigger Collider,确保两者会进入拾取区。
  2. 道具添加 Collider 与 PickupOnce,脚本会在 Awake 中把该 Collider 设为 Trigger;将道具置于角色移动路径。
  3. 运行场景让两个 Collider 依次穿过道具,检查背包只增加 1,随后道具消失。
  4. 将背包容量设为 1,先拾取一件,再碰第二件:第二件不会消失,数量不变;只有退出再进入触发区,才会重新尝试。

对象复用时的边界

此实现采用销毁道具。若改用对象池,回收时应禁用碰撞体,仅在下一次正式生成时重置 consumed 和 Trigger,不能在 OnTriggerExit 中随意清零,否则仍可能重复领取。碰撞层过滤能够减少无关回调,但无法替代这道一次性消费保护。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

角色拾取为什么会重复触发

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通