游戏引擎 / 系统课时
给对象加上碰撞体
给对象加上碰撞体
在 Cocos Creator 3.8 的二维场景里,角色看起来碰到墙,不代表物理系统知道它们接触。本课用一个会向右移动的角色和静止墙体,配置准确的二维碰撞形状,并验证角色确实被墙挡住。
学习目标
- 根据物体外形选择盒形、圆形或多边形碰撞体。
- 正确配置
Collider2D与RigidBody2D,完成基础阻挡测试。 - 借助调试轮廓定位碰撞范围偏移和尺寸失配。
碰撞形状不等于图片轮廓
Sprite 负责显示,Collider2D 定义参与碰撞计算的几何区域。图片有透明边、阴影或不规则轮廓时,直接按整张图片设置碰撞体,常会造成“还没碰到就停下”或者视觉上已经重叠才触发接触。
常用的二维组件有三种:
BoxCollider2D:适合墙壁、箱子、矩形平台,设置Size和Offset。CircleCollider2D:适合球、圆形道具或近似圆形角色,设置Radius和Offset。PolygonCollider2D:适合明显不规则的地形或障碍,可编辑顶点;顶点过多会增加计算与维护成本。
优先用简单形状覆盖真正需要接触的主体,而不是追求与美术边缘逐像素一致。角色圆形碰撞体可以让侧向接触更平滑,长墙则更适合盒形。

配出能阻挡角色的场景
先确认项目使用支持刚体碰撞响应的二维 Box2D 物理模块,而不是仅用于轻量检测的 Builtin;可在“项目 → 项目设置 → 功能裁剪”中检查相关模块。以下步骤都在二维场景中完成:
- 建立
Player和Wall两个节点,分别放在(0, 0)与(220, 0)附近,使它们在同一水平线上,起初互不重叠。 - 给
Player添加RigidBody2D,类型设为Dynamic,关闭重力影响并固定旋转;再添加CircleCollider2D,取消勾选Sensor。 - 给
Wall添加BoxCollider2D,将尺寸设为宽30、高160,取消勾选Sensor;再添加RigidBody2D,类型设为Static。 - 确认碰撞分组及碰撞矩阵允许两者接触。把下面的脚本
ColliderShapeDemo.ts挂在Player上。
RigidBody2D 决定物体如何由物理系统运动;碰撞体只定义接触形状。静止墙体使用 Static,可以接受动态角色的接触而不被推走。
用脚本统一角色尺寸并测试
下面的代码在启动时将角色碰撞半径设为 24,向右施加恒定初速度,并开启二维物理形状的调试绘制。它是可直接挂载在上述 Player 节点上的完整组件脚本。
import {
_decorator, Component, CircleCollider2D,
RigidBody2D, Vec2, PhysicsSystem2D, EPhysics2DDrawFlags
} from 'cc';
const { ccclass } = _decorator;
@ccclass('ColliderShapeDemo')
export class ColliderShapeDemo extends Component {
start() {
const body = this.getComponent(RigidBody2D);
const circle = this.getComponent(CircleCollider2D);
if (!body || !circle) {
console.warn('Player 缺少刚体或圆形碰撞体');
return;
}
// 修改碰撞几何后让 Box2D 更新实际形状
circle.radius = 24;
circle.offset = new Vec2(0, 0);
circle.sensor = false;
circle.apply();
// 让刚体驱动位移,不用逐帧直接改节点坐标
body.gravityScale = 0;
body.fixedRotation = true;
body.linearVelocity = new Vec2(120, 0);
PhysicsSystem2D.instance.debugDrawFlags = EPhysics2DDrawFlags.Shape;
console.log('角色向右移动;碰撞圆半径 24');
}
}预期输出(控制台):
角色向右移动;碰撞圆半径 24预期画面结果:角色向右移动,到达墙体左侧时停止继续穿入;调试轮廓显示角色圆与墙体矩形的接触位置。这里的 120 是世界坐标单位每秒的水平速度,调整预览窗口大小不会改变物理速度。
用轮廓排查接触位置
先观察调试形状,再判断碰撞规则:如果视觉上提前停止,检查 Size、Radius、Offset 和节点缩放;如果穿墙,检查 Sensor 是否意外开启、刚体是否为 Dynamic、分组矩阵是否允许碰撞,以及是否真的使用 Box2D。
对于高速物体,还要考虑离散物理步长导致的穿透,不能无限增大速度来验证普通接触。完成测试后可关闭调试绘制,避免把诊断信息当作正式游戏画面。