游戏引擎 / 系统课时

区分碰撞和触发事件

区分碰撞和触发事件

墙体需要阻挡,金币区域只需要通知进入,两者都可能产生接触回调。本节通过 sensor 区分物理响应与触发用途,并按 2D API 的回调签名读取接触双方。

学习目标

  • 注册 BEGIN_CONTACT 与 END_CONTACT
  • 说明 sensor 对物理响应的影响
  • 避免保存短生命周期接触对象

事件与阻挡不是同一件事

继续使用 Box2D 后端。一个动态 Player 先穿过金币触发区,再接触非 sensor 的墙体。Player 和墙使用非 sensor 碰撞器;金币区域使用静态刚体与 sensor 碰撞器,tag 设为 42。分组矩阵须允许 Player 与两者配对。

sensor 仍参与接触检测,却不产生阻挡。它不会自动实现拾取、加分或销毁金币,这些都是业务逻辑。非 sensor 的两个碰撞器也不保证一定发生阻挡,还要满足刚体类型、后端与分组条件。

触发区通知与实体墙阻挡

注册成对的接触监听

保存 ContactProbe.ts,挂到 Player;Player 的 RigidBody2D 勾选 Enabled Contact Listener。下列监听绑定在 Player 的 Collider2D 上,回调中的 self 是该碰撞器,other 是接触对方。

ts
import { _decorator, Component, Collider2D, Contact2DType, IPhysics2DContact } from 'cc';
const { ccclass } = _decorator;

@ccclass('ContactProbe')
export class ContactProbe extends Component {
    private shape: Collider2D | null = null;
    onEnable(): void {
        this.shape = this.getComponent(Collider2D);
        this.shape?.on(Contact2DType.BEGIN_CONTACT, this.begin, this);
        this.shape?.on(Contact2DType.END_CONTACT, this.end, this);
    }
    onDisable(): void {
        this.shape?.off(Contact2DType.BEGIN_CONTACT, this.begin, this);
        this.shape?.off(Contact2DType.END_CONTACT, this.end, this);
    }
    private begin(self: Collider2D, other: Collider2D, contact: IPhysics2DContact | null): void {
        const kind = self.sensor || other.sensor ? 'trigger' : 'solid';
        console.log('begin:' + kind + ':' + other.tag); // 拷贝业务标识,不保留 contact
    }
    private end(self: Collider2D, other: Collider2D): void {
        console.log('end:' + other.tag);
    }
}

预期结果:进入金币区域时出现 begin:trigger:42,离开时出现 end:42,角色继续穿过;接触墙体时出现 begin:solid: 后接墙体 tag,并由物理系统处理阻挡。接触保持期间不会每帧重新触发 BEGIN_CONTACT。

在回调内只采集必要事实

接触对象可能被引擎缓存与复用,只在当前回调内读取;需要之后使用的接触点和法线应复制数值,不能缓存原对象。不同后端支持的接触阶段不同,内置检测后端的 contact 可能为 null,因此访问详细流形前要确认后端和非空条件。

Box2D 在求解期间可能锁定物理世界,回调内直接创建或销毁刚体、切换场景、改变物理结构容易触发异常。先记录待处理的拾取或伤害意图,在安全的后续逻辑阶段执行结构变化,并检查目标是否仍有效。对金币要立即标记“已领取”,防止清理前的其他接触重复加分。

一个角色可能有多个碰撞器,进入事件数量不等于角色数量。持续区域效果可按角色身份维护重叠计数,处理每个接触对的进入和退出;不要把某个碰撞器退出直接解释成整个角色离开。官方接触回调说明 给出了后端与生命周期约束。

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

目录与阅读设置

阅读设置

17

记录一个想法

区分碰撞和触发事件

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

登录哪都通