游戏引擎 / 系统课时
区分碰撞与触发器
区分碰撞与触发器
角色碰到墙应该停下,进入金币范围却应该继续前进并触发拾取。这两种交互都依赖二维碰撞体,但物理响应完全不同。本课通过同一条移动路线,验证普通碰撞与传感器触发的行为和回调时机。
学习目标
- 分辨实体接触阻挡与传感器区域检测的用途。
- 在 Cocos Creator 3.8 中设置
Sensor和接触监听。 - 使用
BEGIN_CONTACT、END_CONTACT实现进入与离开的判定。
同样检测接触,处理结果不同
普通二维碰撞体把 Sensor 设为 false:使用 Box2D 且刚体配置正确时,物理求解器会处理碰撞响应。例如角色被墙挡住、箱子被球撞开。
传感器把 Sensor 设为 true:仍然参与接触检测并可以触发回调,却不产生物理阻挡。金币拾取区、存档点、关卡入口适合这样设计。是否扣血、加分或切换关卡,仍由业务脚本决定,不能只靠勾选 Sensor。

二维系统中应使用 Collider2D.sensor 和 Contact2DType.BEGIN_CONTACT 等 API;不要把三维物理的 isTrigger、onTriggerEnter 直接套进二维代码。开始接触和结束接触描述的是检测时机,不等于“已经执行拾取”或“已经造成伤害”。
搭建金币与墙的对照场景
本例同样选择二维 Box2D 物理模块。在一条水平路线上配置以下节点:
Player放在(0, 0),添加RigidBody2D(Dynamic、Gravity Scale = 0、Fixed Rotation = true)与CircleCollider2D(半径20,Sensor = false)。Coin放在(90, 0),添加CircleCollider2D(半径18,Sensor = true),作为不阻挡角色的静态检测区。Wall放在(230, 0),添加BoxCollider2D(尺寸40 × 140,Sensor = false)与RigidBody2D(Static)。- 让三者处于彼此允许接触的碰撞分组中,将
ContactVsSensor.ts挂在Player上。
至少让移动角色的刚体启用 Enabled Contact Listener,接触事件才能按预期送达。下方脚本也会在启动时设置 enabledContactListener = true,避免忘记勾选。没有动态刚体的纯静态组合不能作为物理阻挡测试。
监听进入和离开
这段完整组件代码监听玩家自身碰撞体的接触事件,根据另一方节点名称和 sensor 属性区分墙与金币。它仅输出可核对的结果,并用布尔标记避免重复拾取。
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;
}
}预期输出(按角色从左向右经过金币、再到墙体的顺序):
进入 Coin:触发拾取,不阻挡角色
离开 Coin
碰到 Wall:角色被物理阻挡预期画面结果:角色穿过金币的圆形感应范围后继续移动,到墙体边缘停止。事件触发的具体时间取决于物理步进;接触回调参数中的物理接触数据只应在回调期间使用。
检查不触发与误阻挡
遇到“金币挡人”,先检查 Coin 的 Sensor 是否为 true;遇到“金币毫无反应”,依次检查节点是否真的重叠、两侧碰撞分组是否允许接触、Player 是否有动态刚体、是否已开启 enabledContactListener、监听器是否注册在正确的 Collider2D 上。
真实拾取逻辑可以在首次进入时记录金币 ID、更新得分,并在安全的业务流程中隐藏或回收道具。不要把 BEGIN_CONTACT 当作每帧事件,也不要在物理回调里立刻销毁仍在参与本次求解的碰撞节点。普通碰撞负责“能不能穿过去”,传感器负责“有没有进入区域”,两者可以在同一关卡中协作。