1. 项目概述为什么物理碰撞与碰撞回调是游戏交互的基石在Cocos Creator里做游戏尤其是动作、射击、跑酷这类强交互的类型物理碰撞和碰撞回调是绕不开的核心技术。很多新手朋友可能会觉得给两个节点都加上碰撞组件它们就能“撞”起来了这就算实现了物理碰撞。但实际开发中你会发现事情远不止这么简单。比如一个子弹击中敌人我们不仅需要它们发生碰撞还需要知道“击中了”然后触发敌人掉血、播放受击动画、可能还有音效甚至子弹要消失。这个“知道击中了”并执行后续逻辑的过程就是碰撞回调的职责。所以“物理碰撞”解决的是“能不能撞”的问题是物理引擎如Box2D在底层根据形状、位置、速度进行的模拟计算。而“碰撞回调”解决的是“撞了之后怎么办”的问题是游戏逻辑层面对碰撞事件的响应。一个完整的碰撞交互必须是这两者的结合。只做物理碰撞游戏会缺乏反馈死气沉沉只依赖回调而不启用物理则无法实现真实的物理运动效果比如反弹、滑动。这次我们就来彻底搞懂在Cocos Creator中如何从零开始搭建一套既稳定又高效的“物理碰撞碰撞回调”双实现方案。2. 核心概念拆解碰撞组件、刚体与回调函数在动手写代码之前我们必须先理清Cocos Creator物理系统中几个核心概念的关系这是避免后续踩坑的关键。2.1 碰撞组件 (Collider)定义“形状”碰撞组件决定了你的游戏对象在物理世界中的“轮廓”。Cocos Creator提供了多种形状的碰撞组件Box Collider (矩形碰撞盒)最常用性能最好适合方形物体如箱子、地板、墙壁。Circle Collider (圆形碰撞盒)适合球体、圆形角色计算效率高。Polygon Collider (多边形碰撞盒)可以自定义任意凸多边形形状更精确但顶点数不宜过多通常建议不超过8个否则影响性能。PhysicsPolygonCollider (物理多边形碰撞器3D项目)。注意碰撞组件的形状应该尽量简化贴合物体的视觉轮廓即可。用一个复杂的多边形去匹配一个近似圆形的物体远不如直接用一个Circle Collider来得高效和稳定。这是优化物理性能的第一条黄金法则。2.2 刚体组件 (RigidBody)定义“物理属性”刚体组件为节点赋予了物理属性使其能够参与物理模拟。它是连接碰撞组件和物理世界的桥梁。类型通常分为Static静态如山体、地面、Dynamic动态如玩家、子弹、Kinematic运动学可由代码完全控制运动如移动平台。质量、密度、摩擦力、弹性这些属性共同决定了物体在碰撞时的行为。例如弹性系数(Restitution)为1时近似完全弹性碰撞为0时则完全无反弹。关键点一个节点想要参与物理碰撞检测必须同时拥有碰撞组件和刚体组件。只有碰撞组件它只是一个“幽灵”形状不会被物理引擎计算只有刚体组件它只是一个有质量的点无法与其他物体发生形状上的交互。2.3 碰撞回调函数事件的“监听器”这是游戏逻辑的入口。当两个都具备刚体和碰撞组件的物体发生碰撞时物理引擎会触发一系列回调函数。你需要在挂载了碰撞组件的节点上编写脚本并实现这些函数来响应碰撞。3. 双实现方案一基础物理碰撞配置让我们从一个最简单的例子开始让一个球从空中落下撞击地面后弹起。这里我们主要关注物理碰撞的自动模拟。3.1 场景搭建与组件添加创建地面 (Ground)创建一个Sprite节点命名为Ground拉宽作为地面。为其添加PhysicsBoxCollider组件。在属性检查器中调整Size使其与地面精灵大小匹配。为其添加RigidBody组件。由于其是静止的将Type设置为Static。创建小球 (Ball)创建一个Sprite节点命名为Ball使用圆形纹理。为其添加PhysicsCircleCollider组件。调整Radius匹配精灵。为其添加RigidBody组件。Type保持为Dynamic。这里可以设置一下Restitution弹性为0.8让它弹得高一些。配置物理系统在项目设置 - 物理中确保物理系统是启用的。对于2D项目默认使用的是Box2D引擎。此时如果你运行游戏小球会受到重力下落撞击地面后根据弹性系数弹起。整个过程完全由物理引擎驱动我们没有写一行逻辑代码。这就是最基础的物理碰撞实现。3.2 关键参数详解与避坑指南刚体类型选择Static用于永远不会移动的物体地面、墙壁。性能最优物理引擎会对它们做特殊优化。Dynamic用于需要受物理力重力、碰撞力影响的物体玩家、箱子。最常用。Kinematic用于需要通过代码如setLinearVelocity精确控制运动的物体电梯、移动平台。它不会受普通力的影响但可以推动Dynamic物体。碰撞分组管理 在项目设置 - 物理 - 碰撞矩阵中可以定义不同分组之间是否进行碰撞检测。这是性能优化和逻辑控制的重要手段。场景子弹和子弹之间通常不需要碰撞检测避免无谓的计算。你可以将“子弹”和“子弹”分组的交叉格取消勾选。逻辑你可以设置“玩家”和“金币”碰撞但“玩家”和“友军”不碰撞。实操心得永远不要将所有物体的分组都设置为“默认”并允许全部相互碰撞。对于大型游戏这会导致碰撞检测次数呈平方级增长严重消耗性能。规划好你的碰撞分组是项目初期就必须做的设计。4. 双实现方案二碰撞回调的精细控制现在我们进入核心部分碰撞回调。假设我们的球不是普通的球而是一个“火球”击中地面后要播放一个爆炸特效然后消失。4.1 回调函数详解与挂载在Ball节点上新建一个脚本例如BallController.js。Cocos Creator提供了四个关键的碰撞回调函数cc.Class({ extends: cc.Component, properties: { // 可以在这里定义需要预加载的爆炸特效预制体 explosionPrefab: cc.Prefab }, // 1. 开始接触回调 onBeginContact: function (contact, selfCollider, otherCollider) { // 当两个碰撞体开始接触边缘第一次碰到时调用只调用一次。 cc.log([开始接触] 火球碰到了: ${otherCollider.node.name}); // 这是一个绝佳的位置来播放音效、触发一次性事件如得分。 }, // 2. 结束接触回调 onEndContact: function (contact, selfCollider, otherCollider) { // 当两个碰撞体结束接触完全分开时调用只调用一次。 cc.log([结束接触] 火球离开了: ${otherCollider.node.name}); }, // 3. 预求解回调 (每次物理步进前) onPreSolve: function (contact, selfCollider, otherCollider) { // 在物理引擎计算本次碰撞的力和冲量**之前**调用。每次物理步进只要接触持续就会调用。 // 可以在这里动态修改本次碰撞的摩擦系数、弹性系数等。 // contact.setFriction(0); // 例如让这次碰撞变得光滑 }, // 4. 后求解回调 (每次物理步进后) onPostSolve: function (contact, selfCollider, otherCollider) { // 在物理引擎计算完本次碰撞的力和冲量**之后**调用。每次物理步进只要接触持续就会调用。 // 可以在这里获取到本次碰撞产生的冲量impulse用于计算伤害等。 // var impulse contact.getImpulse(); // 注意这个API可能需要查阅具体版本 }, // 注意必须确保刚体组件开启了接触监听 // 在 onLoad 或 start 中检查 start () { let rigidBody this.getComponent(cc.RigidBody); if (rigidBody) { rigidBody.enabledContactListener true; // 确保开启 } } });关键步骤将BallController脚本挂载到Ball节点上。这是很多人会忘记的一步没有脚本回调函数永远不会被触发。4.2 在回调中实现游戏逻辑我们修改onBeginContact函数实现火球撞击爆炸的效果onBeginContact: function (contact, selfCollider, otherCollider) { // 1. 判断碰撞对象 if (otherCollider.node.name Ground) { cc.log(火球击中地面); // 2. 播放爆炸特效 if (this.explosionPrefab) { let explosion cc.instantiate(this.explosionPrefab); explosion.setPosition(this.node.position); // 在碰撞点生成 this.node.parent.addChild(explosion); // 添加到场景 // 可以给爆炸特效加一个自动销毁的脚本2秒后删除 } // 3. 播放爆炸音效 cc.audioEngine.playEffect(this.explosionSound, false); // 4. 销毁火球自身延迟一帧避免物理引擎错误 this.scheduleOnce(function() { this.node.destroy(); }, 0); } },4.3 深入理解 Contact 对象回调函数中的contact参数包含了丰富的碰撞信息是进行高级处理的钥匙。获取碰撞点与世界法向量 这是最常用的信息。碰撞点(points)是实际发生接触的一个或多个点的数组通常是1-2个。法向量(normal)是从selfCollider指向otherCollider的单位向量指示了解决碰撞最快的方向。onBeginContact: function (contact, selfCollider, otherCollider) { // 获取世界坐标下的碰撞信息 var worldManifold contact.getWorldManifold(); var points worldManifold.points; // 碰撞点数组 (Vec2) var normal worldManifold.normal; // 世界法向量 (Vec2) // 示例在第一个碰撞点画一个标记假设有一个标记预制体 if (points.length 0) { let hitPoint points[0]; cc.log(碰撞发生在世界坐标: (${hitPoint.x}, ${hitPoint.y})); cc.log(法向量方向: (${normal.x}, ${normal.y})); // 可用于判断撞击角度 } }动态禁用碰撞 有时我们希望在一次碰撞发生后暂时忽略这次碰撞。比如一个“无敌”状态的角色需要穿过敌人。onBeginContact: function (contact, selfCollider, otherCollider) { if (otherCollider.node.group enemy this.isInvincible) { // 仅禁用本次接触的碰撞响应物体依然会重叠但不会产生弹力等 contact.disabled true; // 或者只禁用当前物理步进的这一次计算 // contact.disabledOnce true; } }重要警告contact对象及其内部信息如worldManifold的生命周期仅限于本次回调函数执行期间。绝对不要尝试将它存储到类的成员变量中供后续使用因为下一次物理步进时它引用的内存可能已被回收或用于其他碰撞导致程序崩溃或数据错乱。如果需要这些信息应该立即提取并复制所需的数据如points[0].clone()。5. 实战实现一个“双人弹球”游戏核心机制让我们用一个更复杂的例子来串联所有知识。实现两个玩家控制的挡板和一个球。球在碰到挡板时会根据击中位置改变反弹角度像《Pong》或《打砖块》那样并且播放音效和屏幕震动。5.1 场景与组件设置球 (Ball)刚体类型Dynamic。设置适当的密度和弹性如Restitution: 1近似完全弹性。碰撞组件Circle Collider。挂载脚本Ball.js。玩家挡板 (Paddle_Player1, Paddle_Player2)刚体类型Kinematic。因为我们需要用键盘精确控制它的上下移动而不希望它被球撞飞。碰撞组件Box Collider。挂载脚本Paddle.js(控制移动) 和PaddleCollision.js(处理碰撞逻辑)。墙壁和天花板/地板刚体类型Static。碰撞组件Box Collider。5.2 挡板控制脚本 (Paddle.js)cc.Class({ extends: cc.Component, properties: { moveSpeed: 300, upKey: { default: cc.macro.KEY.w }, // 玩家1W上 downKey: { default: cc.macro.KEY.s } // 玩家1S下 }, update (dt) { let rigidBody this.getComponent(cc.RigidBody); if (!rigidBody) return; let moving false; let linearVelocity cc.v2(0, 0); // 键盘输入检测 if (cc.inputManager.isKeyDown(this.upKey)) { linearVelocity.y this.moveSpeed; moving true; } else if (cc.inputManager.isKeyDown(this.downKey)) { linearVelocity.y -this.moveSpeed; moving true; } // 对于Kinematic刚体我们直接设置线性速度来控制运动 if (moving) { rigidBody.linearVelocity linearVelocity; } else { // 没有输入时速度归零使其立即停止 rigidBody.linearVelocity cc.v2(0, 0); } } });5.3 高级碰撞反馈脚本 (PaddleCollision.js)这是核心我们利用onPreSolve回调来动态修改球的反弹方向。cc.Class({ extends: cc.Component, properties: { // 最大偏转角度弧度例如45度 - Math.PI / 4 maxReflectAngle: { default: Math.PI / 4, tooltip: 球击中挡板边缘时的最大偏转角 }, hitEffectPrefab: cc.Prefab, hitSound: cc.AudioClip }, onPreSolve: function (contact, selfCollider, otherCollider) { // 只处理与球的碰撞 if (otherCollider.node.name ! Ball) return; let ballRigidBody otherCollider.node.getComponent(cc.RigidBody); let ballCollider otherCollider; if (!ballRigidBody) return; // 1. 获取碰撞点和法向量 let worldManifold contact.getWorldManifold(); let hitPoint worldManifold.points[0]; let normal worldManifold.normal; // 这个法向量是物理引擎计算的“最短分离方向” // 2. 计算击中点相对于挡板中心的偏移比例-1 到 1 let paddleCenterY this.node.y; let hitOffsetY hitPoint.y - paddleCenterY; let paddleHalfHeight selfCollider.node.height * selfCollider.node.scaleY / 2; let hitRatio cc.misc.clampf(hitOffsetY / paddleHalfHeight, -1, 1); // 限制在[-1, 1] // 3. 根据击中位置计算自定义的反弹方向 // 我们希望击中中心垂直反弹击中边缘则有一个角度。 let customNormal cc.v2(0, 0); // 假设挡板是垂直的在屏幕左右那么物理法向量 normal 大致是水平的 (1,0) 或 (-1,0) // 我们保留X方向向左或向右但根据hitRatio修改Y方向。 customNormal.x normal.x; // 保持原来的左右方向 customNormal.y hitRatio * this.maxReflectAngle; // Y方向与击中位置成比例 // 归一化这个自定义的法向量 customNormal.normalizeSelf(); // 4. 计算球的当前速度并基于新的法向量反射 let currentVelocity ballRigidBody.linearVelocity; let speed currentVelocity.mag(); // 速度标量 // 反射公式: newVelocity currentVelocity - 2 * (currentVelocity · customNormal) * customNormal let dotProduct currentVelocity.dot(customNormal); let newVelocity currentVelocity.sub(customNormal.mul(2 * dotProduct)); // 保持速度大小不变只改变方向 newVelocity.normalizeSelf().mulSelf(speed); // 5. 在 onPreSolve 中我们可以通过修改 contact 信息来影响物理计算 // 但更直接的方式是立即设置球的新速度。 // 注意在 onPreSolve 中直接设置速度可能会被后续的物理计算覆盖一部分。 // 更稳健的做法是在 onPostSolve 中设置或者结合使用。 // 这里为了演示我们选择在 onPostSolve 中设置。 // 我们先存储计算好的新速度。 this._cachedNewVelocity newVelocity; // 6. 可选修改本次碰撞的弹性让击打感更“脆” contact.setRestitution(1.2); // 弹性系数可以大于1获得加速效果 }, onPostSolve: function (contact, selfCollider, otherCollider) { if (otherCollider.node.name ! Ball) return; let ballRigidBody otherCollider.node.getComponent(cc.RigidBody); if (!ballRigidBody || !this._cachedNewVelocity) return; // 在物理引擎计算完碰撞后应用我们自定义的速度 ballRigidBody.linearVelocity this._cachedNewVelocity; this._cachedNewVelocity null; // 清空缓存 // 7. 触发视觉和听觉反馈 this.playHitEffect(contact); }, playHitEffect: function (contact) { // 播放音效 if (this.hitSound) { cc.audioEngine.playEffect(this.hitSound, false); } // 生成击中特效如闪光 if (this.hitEffectPrefab) { let worldManifold contact.getWorldManifold(); let hitPoint worldManifold.points[0]; let effect cc.instantiate(this.hitEffectPrefab); effect.setPosition(hitPoint); cc.director.getScene().addChild(effect); // 特效节点应自带一个定时销毁的脚本 } // 简单屏幕震动可选 // 可以调用一个全局的摄像机震动管理器 // CameraManager.instance.shake(0.1, 5); } });5.4 碰撞分组优化在这个游戏中两个玩家的挡板之间不需要碰撞球和球之间也不需要如果有多球模式。我们需要配置碰撞矩阵。在项目设置 - 物理中添加分组Ball,Paddle,Wall。配置矩阵Ball与Paddle✅ 碰撞Ball与Wall✅ 碰撞Paddle与Paddle❌ 不碰撞Paddle与Wall✅ 碰撞防止挡板移出屏幕在场景中为每个节点的碰撞组件设置对应的Group。6. 性能优化与常见问题排查即使功能实现了如果没有良好的实践物理系统很容易成为性能瓶颈和Bug之源。6.1 性能优化要点精简碰撞体形状永远使用能满足需求的最简形状。圆形优于矩形矩形优于凸多边形顶点数尽量少。善用碰撞分组这是最有效的优化手段。杜绝“全员互撞”。静态刚体多用Static对于背景、固定障碍物务必设为Static。控制物理更新频率在项目设置 - 物理中Physics Delta Time可以设置。默认是1/60约0.0167秒。如果你的游戏帧率是30fps可以尝试设置为1/30能减少物理计算次数但会降低模拟精度。在移动端可酌情调整。避免在回调函数中进行耗时操作onPreSolve和onPostSolve每帧可能调用多次。不要在这里面执行复杂的计算、实例化大量对象或进行网络请求。如果需要可以标记一个状态在update中处理。及时销毁物理节点销毁一个带有刚体的节点时物理引擎内部需要清理数据。如果大量节点频繁创建销毁考虑使用对象池。6.2 常见问题排查表问题现象可能原因解决方案碰撞根本没有发生1. 节点缺少RigidBody或Collider组件。2. 刚体类型都是Static静态物体之间不会产生碰撞响应。3. 碰撞分组矩阵未勾选相应分组。4. 碰撞体大小/位置设置错误视觉上重叠但物理形状未重叠。1. 检查组件是否添加完整。2. 确保至少有一个参与方是Dynamic或Kinematic。3. 检查项目设置中的碰撞矩阵。4. 在场景编辑器中开启物理调试绘制Physics Debug Draw查看碰撞体轮廓。碰撞回调函数不执行1. 脚本未挂载在拥有碰撞组件的节点上。2. 刚体的enabledContactListener属性未开启默认为false。3. 回调函数名拼写错误必须是onBeginContact等。1. 确认脚本挂载正确。2. 在脚本start中或属性检查器里确保enabledContactListener为true。3. 仔细核对函数名。物体穿透或抖动1. 物体速度过快每帧移动距离超过自身尺寸。2. 碰撞体形状太薄或太小。3. 物理步长时间(Physics Delta Time)设置过大。1. 这是“隧道效应”。解决方案a) 降低速度b) 使用CCD连续碰撞检测将刚体的Bullet属性设为true性能开销大c) 增大碰撞体。2. 避免使用极端细长的碰撞体。3. 尝试减小Physics Delta Time。contact.getWorldManifold()返回空或错误在错误的回调阶段或时机访问contact信息。worldManifold主要在onPreSolve和onPostSolve中有效且稳定。在onBeginContact和onEndContact中信息可能不完整。优先在onPreSolve中读取。物理表现不稳定每次运行不一样1. 在update中直接修改刚体的位置(position)而非速度(linearVelocity)。2. 帧率波动导致物理计算不稳定。1. 对于Dynamic刚体永远使用力(applyForce)或冲量(applyLinearImpulse)来改变运动。对于Kinematic刚体使用linearVelocity。2. 确保游戏逻辑与物理更新解耦。使用固定的Physics Delta Time。6.3 调试技巧开启物理调试在场景编辑器的顶部工具栏找到并点击物理调试按钮通常是一个小雷达图标。这会在游戏运行时用线框绘制出所有碰撞体的形状和刚体的速度向量一目了然。善用cc.log在碰撞回调开始时打印日志确认回调被触发并输出selfCollider.node.name和otherCollider.node.name这是最直接的调试方式。检查属性面板运行时可以在属性检查器中动态修改刚体的速度、位置观察实时变化辅助调试。物理碰撞和回调是连接游戏视觉表现与内在逻辑的桥梁。理解其原理掌握其API并遵循性能最佳实践你就能创造出既真实又富有响应感的游戏交互体验。记住多动手实验多使用调试工具是掌握这门技术的不二法门。
