碰撞检测、命中判定与空间筛选
碰撞检测回答“哪些形状在何时发生相交”,伤害系统回答“这次接触是否造成什么结果”,物理响应回答“接触后如何运动”。三者可以组合,也可以独立。弹幕命中可能只要几何检测,推箱子需要物理响应,捡金币需要触发事件;不必让全部交互都变成完整刚体模拟。
用简单形状表达玩法
轴对齐矩形 AABB 适合地图块与简单范围,圆适合俯视角色和子弹,凸多边形适合需要旋转的形状。像素级轮廓更精细,却不一定更公平或更便宜。角色受击框可以略小于可见轮廓,攻击框与身体框应分别定义;这些是玩法合同,需要可视化让设计者检查。
type Box = { left: number; right: number; bottom: number; top: number };
function overlapAABB(a: Box, b: Box): boolean {
// 本例把退化矩形与仅贴边视为没有面积重叠。
if (a.right <= a.left || a.top <= a.bottom ||
b.right <= b.left || b.top <= b.bottom) return false;
return a.left < b.right && a.right > b.left &&
a.bottom < b.top && a.top > b.bottom;
}
function overlapCircle(ax: number, ay: number, ar: number,
bx: number, by: number, br: number): boolean {
const dx = ax - bx, dy = ay - by, r = ar + br;
return dx * dx + dy * dy <= r * r;
}
示例故意对贴边使用不同合同:矩形要求正面积,圆把相切算接触。实际项目应按玩法统一边界语义并测试;不能让一个系统用小于、另一个用小于等于后再靠随机容差修复。浮点接近边界时可以采用清楚的 epsilon 或接触容差,但要注明单位与用途。
旋转矩形不能直接用旋转前 AABB 做精确判定;AABB 只能作为外包围筛选。分离轴定理 SAT 用候选轴上的投影检查凸形是否分离;凹形通常先拆成凸形。形状越复杂,维护、计算与接触解释越困难,优先采用满足玩法的简单近似。
广相筛选与窄相检测
n 个对象两两比较是约 n² 规模。广相先按网格、空间哈希、树或包围盒筛掉不可能接触的对;窄相再做精确相交。均匀网格容易实现,适合尺寸差异不大、分布较均匀的弹幕;大跨度对象需要登记多个格,并对候选对去重。空间密集时格子里仍可能很多对象,不能声称网格永远线性。
过滤比优化几何更先值得做。玩家子弹只查敌人,拾取物只查玩家,装饰不查任何对象。Creator 的碰撞分组与矩阵可减少无关接触;射线查询也应带正确掩码。不要每帧查询全场所有节点,再用名字字符串判断它是不是敌人。
高速物体为何穿墙
离散检测只看两个时间点:子弹上一帧在墙左,本帧在墙右,两个位置都不重叠,就会漏掉。解决方向包括更小时间步、连续碰撞、扫掠形状或从旧位置到新位置投射。射线近似适合细小弹丸;有半径的炮弹需要扩张障碍或形状扫掠,不能一律把中心射线当完整碰撞。
Creator Box2D 后端提供射线检测,结果类型有任意、最近和全部等;全部结果未必按距离排序,一个复杂碰撞体还可能对应多个 fixture 命中。处理穿透子弹时应按距离排序并按逻辑目标去重;先命中哪个墙决定后面的敌人是否还能受伤。Builtin 2D 的能力与 Box2D 不同,不能照搬后端不支持的查询。
接触事件不是一次攻击
持续接触可能跨多步,多个碰撞体也可能代表同一敌人。一次近战挥击通常用 attackId + targetId 去重;持续火焰则按定义的伤害间隔结算。金币在同一 tick 被多处检测命中时,只能被消费一次。先收集命中事件,再由规则层验证存活、阵营和无敌状态,更容易控制顺序。
Cocos Box2D 回调需开启刚体碰撞监听;Sensor 产生接触信息但不推动物体。回调里的接触对象可能被复用,若要稍后处理,应复制需要的数据,不能缓存其引用。节点销毁、物理对象变更和事件处理时机也需要遵循引擎约束,常用做法是把业务命令放到安全阶段统一执行。
让调试形状与事件可见
显示攻击框、受击框、广相格子、旧/新位置与投射线。完全没回调,查物理后端、组件启用、矩阵、刚体类型与监听;有回调没伤害,查规则过滤;重复扣血,查事件去重;低帧率漏检,查位移与连续检测。不要为修复命中错误先改精灵图片大小。
浏览器纯函数测试适合验证边界与几何,微信真机需要覆盖实际帧间隔、对象池复用和高密度弹幕。通过低速示例不能证明高速条件。所有图形与日志应使用同一世界空间,避免调试线本身就画错位置。
空间索引的边界也要测试
均匀网格常用 floor 将世界位置映射到格子,负坐标不能简单截断到零;否则原点左侧对象会登记到错误区域。跨多个格子的形状需要覆盖整个包围范围,刚好位于格边时还要保持边界合同一致。候选对可用稳定的最小/最大实体 ID 形成键去重,避免一对子在多个格子里重复结算。
宽相结构更新也有成本。全部对象每步清空重建很直观,静态与动态分层则能减少不动墙体的工作;对象尺寸差异巨大或分布高度不均匀时,树结构可能更合适。先记录候选对与更新耗时,再决定结构,避免为了预期的大规模场景引入难以验证的空间框架。
攻击框还可能随动作阶段出现与消失。启用攻击框时要明确是否检查已经重叠的目标,目标在无敌结束后仍留在范围内是否再次受击。只依赖 begin contact 可能漏掉这些规则变化,需要根据攻击语义主动查询或维护接触集合。接触集合表示空间关系,伤害窗口表示规则许可,二者不能混成一个布尔值。
对称的几何检测结果还需要稳定的业务处理顺序。例如两个投射物同 tick 命中同一弱敌,应统一决定伤害、击杀归属和穿透消耗。延迟销毁可以保留本步事件的完整性,但必须让已消费实体不能再次提供奖励;这是事务式的规则结算问题,不是物理引擎能自动决定的事情。
AI 碰撞任务
实现独立 TypeScript 的圆/AABB 检测和网格广相,加入 attackId/targetId 去重。Creator 3.8.8 演示显示形状、候选对与命中日志;高速弹丸使用旧到新位置投射,并解释半径近似。若使用 Box2D,开启监听并复制延迟使用的接触数据。
验收包含相离、重叠、相切、零尺寸、多个碰撞体同目标、穿过薄墙与同 tick 多次命中;比较广相与全量检测结果一致。性能报告必须给对象数、分布与候选对数量,不能只给 FPS。
来源与适用边界
核查日期:2026-11-17。示例边界合同为本文选择,目标引擎 Creator 3.8.8;无真机检测结果。