游戏引擎 / 系统课时

区分碰撞与触发器

区分碰撞与触发器

角色碰到墙应该停下,进入金币范围却应该继续前进并触发拾取。这两种交互都依赖二维碰撞体,但物理响应完全不同。本课通过同一条移动路线,验证普通碰撞与传感器触发的行为和回调时机。

学习目标

  • 分辨实体接触阻挡与传感器区域检测的用途。
  • 在 Cocos Creator 3.8 中设置 Sensor 和接触监听。
  • 使用 BEGIN_CONTACT、END_CONTACT 实现进入与离开的判定。

同样检测接触,处理结果不同

普通二维碰撞体把 Sensor 设为 false:使用 Box2D 且刚体配置正确时,物理求解器会处理碰撞响应。例如角色被墙挡住、箱子被球撞开。

传感器把 Sensor 设为 true:仍然参与接触检测并可以触发回调,却不产生物理阻挡。金币拾取区、存档点、关卡入口适合这样设计。是否扣血、加分或切换关卡,仍由业务脚本决定,不能只靠勾选 Sensor。

普通碰撞与传感器在运动结果及事件上的区别

二维系统中应使用 Collider2D.sensor 和 Contact2DType.BEGIN_CONTACT 等 API;不要把三维物理的 isTrigger、onTriggerEnter 直接套进二维代码。开始接触和结束接触描述的是检测时机,不等于“已经执行拾取”或“已经造成伤害”。

搭建金币与墙的对照场景

本例同样选择二维 Box2D 物理模块。在一条水平路线上配置以下节点:

  1. Player 放在 (0, 0),添加 RigidBody2D(Dynamic、Gravity Scale = 0、Fixed Rotation = true)与 CircleCollider2D(半径 20,Sensor = false)。
  2. Coin 放在 (90, 0),添加 CircleCollider2D(半径 18,Sensor = true),作为不阻挡角色的静态检测区。
  3. Wall 放在 (230, 0),添加 BoxCollider2D(尺寸 40 × 140,Sensor = false)与 RigidBody2D(Static)。
  4. 让三者处于彼此允许接触的碰撞分组中,将 ContactVsSensor.ts 挂在 Player 上。

至少让移动角色的刚体启用 Enabled Contact Listener,接触事件才能按预期送达。下方脚本也会在启动时设置 enabledContactListener = true,避免忘记勾选。没有动态刚体的纯静态组合不能作为物理阻挡测试。

监听进入和离开

这段完整组件代码监听玩家自身碰撞体的接触事件,根据另一方节点名称和 sensor 属性区分墙与金币。它仅输出可核对的结果,并用布尔标记避免重复拾取。

ts
import {
    _decorator, Component, Collider2D,
    Contact2DType, RigidBody2D, Vec2
} from 'cc';

const { ccclass } = _decorator;

@ccclass('ContactVsSensor')
export class ContactVsSensor extends Component {
    private collider: Collider2D | null = null;
    private collected = false;

    onEnable() {
        this.collider = this.getComponent(Collider2D);
        if (!this.collider) return;
        this.collider.on(Contact2DType.BEGIN_CONTACT, this.onBeginContact, this);
        this.collider.on(Contact2DType.END_CONTACT, this.onEndContact, this);
    }

    start() {
        const body = this.getComponent(RigidBody2D);
        if (!body) {
            console.warn('Player 缺少 RigidBody2D');
            return;
        }
        // 开启接触通知,再由刚体朝右移动
        body.enabledContactListener = true;
        body.gravityScale = 0;
        body.fixedRotation = true;
        body.linearVelocity = new Vec2(120, 0);
    }

    private onBeginContact(_self: Collider2D, other: Collider2D) {
        if (other.node.name === 'Coin' && other.sensor && !this.collected) {
            this.collected = true; // 只处理一次拾取,不在物理回调里直接销毁节点
            console.log('进入 Coin:触发拾取,不阻挡角色');
        } else if (other.node.name === 'Wall' && !other.sensor) {
            console.log('碰到 Wall:角色被物理阻挡');
        }
    }

    private onEndContact(_self: Collider2D, other: Collider2D) {
        if (other.node.name === 'Coin') {
            console.log('离开 Coin');
        }
    }

    onDisable() {
        if (!this.collider) return;
        this.collider.off(Contact2DType.BEGIN_CONTACT, this.onBeginContact, this);
        this.collider.off(Contact2DType.END_CONTACT, this.onEndContact, this);
        this.collider = null;
    }
}

预期输出(按角色从左向右经过金币、再到墙体的顺序):

text
进入 Coin:触发拾取,不阻挡角色
离开 Coin
碰到 Wall:角色被物理阻挡

预期画面结果:角色穿过金币的圆形感应范围后继续移动,到墙体边缘停止。事件触发的具体时间取决于物理步进;接触回调参数中的物理接触数据只应在回调期间使用。

检查不触发与误阻挡

遇到“金币挡人”,先检查 Coin 的 Sensor 是否为 true;遇到“金币毫无反应”,依次检查节点是否真的重叠、两侧碰撞分组是否允许接触、Player 是否有动态刚体、是否已开启 enabledContactListener、监听器是否注册在正确的 Collider2D 上。

真实拾取逻辑可以在首次进入时记录金币 ID、更新得分,并在安全的业务流程中隐藏或回收道具。不要把 BEGIN_CONTACT 当作每帧事件,也不要在物理回调里立刻销毁仍在参与本次求解的碰撞节点。普通碰撞负责“能不能穿过去”,传感器负责“有没有进入区域”,两者可以在同一关卡中协作。

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

目录与阅读设置

阅读设置

17

记录一个想法

区分碰撞与触发器

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

登录哪都通