游戏引擎 / 系统课时

给对象加上碰撞体

给对象加上碰撞体

在 Cocos Creator 3.8 的二维场景里,角色看起来碰到墙,不代表物理系统知道它们接触。本课用一个会向右移动的角色和静止墙体,配置准确的二维碰撞形状,并验证角色确实被墙挡住。

学习目标

  • 根据物体外形选择盒形、圆形或多边形碰撞体。
  • 正确配置 Collider2D 与 RigidBody2D,完成基础阻挡测试。
  • 借助调试轮廓定位碰撞范围偏移和尺寸失配。

碰撞形状不等于图片轮廓

Sprite 负责显示,Collider2D 定义参与碰撞计算的几何区域。图片有透明边、阴影或不规则轮廓时,直接按整张图片设置碰撞体,常会造成“还没碰到就停下”或者视觉上已经重叠才触发接触。

常用的二维组件有三种:

  • BoxCollider2D:适合墙壁、箱子、矩形平台,设置 Size 和 Offset。
  • CircleCollider2D:适合球、圆形道具或近似圆形角色,设置 Radius 和 Offset。
  • PolygonCollider2D:适合明显不规则的地形或障碍,可编辑顶点;顶点过多会增加计算与维护成本。

优先用简单形状覆盖真正需要接触的主体,而不是追求与美术边缘逐像素一致。角色圆形碰撞体可以让侧向接触更平滑,长墙则更适合盒形。

二维精灵与盒形、圆形、多边形碰撞体的覆盖差异

配出能阻挡角色的场景

先确认项目使用支持刚体碰撞响应的二维 Box2D 物理模块,而不是仅用于轻量检测的 Builtin;可在“项目 → 项目设置 → 功能裁剪”中检查相关模块。以下步骤都在二维场景中完成:

  1. 建立 Player 和 Wall 两个节点,分别放在 (0, 0) 与 (220, 0) 附近,使它们在同一水平线上,起初互不重叠。
  2. 给 Player 添加 RigidBody2D,类型设为 Dynamic,关闭重力影响并固定旋转;再添加 CircleCollider2D,取消勾选 Sensor。
  3. 给 Wall 添加 BoxCollider2D,将尺寸设为宽 30、高 160,取消勾选 Sensor;再添加 RigidBody2D,类型设为 Static。
  4. 确认碰撞分组及碰撞矩阵允许两者接触。把下面的脚本 ColliderShapeDemo.ts 挂在 Player 上。

RigidBody2D 决定物体如何由物理系统运动;碰撞体只定义接触形状。静止墙体使用 Static,可以接受动态角色的接触而不被推走。

用脚本统一角色尺寸并测试

下面的代码在启动时将角色碰撞半径设为 24,向右施加恒定初速度,并开启二维物理形状的调试绘制。它是可直接挂载在上述 Player 节点上的完整组件脚本。

ts
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');
    }
}

预期输出(控制台):

text
角色向右移动;碰撞圆半径 24

预期画面结果:角色向右移动,到达墙体左侧时停止继续穿入;调试轮廓显示角色圆与墙体矩形的接触位置。这里的 120 是世界坐标单位每秒的水平速度,调整预览窗口大小不会改变物理速度。

用轮廓排查接触位置

先观察调试形状,再判断碰撞规则:如果视觉上提前停止,检查 Size、Radius、Offset 和节点缩放;如果穿墙,检查 Sensor 是否意外开启、刚体是否为 Dynamic、分组矩阵是否允许碰撞,以及是否真的使用 Box2D。

对于高速物体,还要考虑离散物理步长导致的穿透,不能无限增大速度来验证普通接触。完成测试后可关闭调试绘制,避免把诊断信息当作正式游戏画面。

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

目录与阅读设置

阅读设置

17

记录一个想法

给对象加上碰撞体

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

登录哪都通