Excalibur游戏引擎中的碰撞体(Colliders)详解-CSDN博客

Excalibur游戏引擎中的碰撞体(Colliders)详解

前言

在游戏开发中，碰撞检测是物理系统的基础功能之一。Excalibur游戏引擎提供了一套完善的碰撞体(Colliders)系统，让开发者能够轻松实现各种形状的碰撞检测。本文将深入解析Excalibur中的碰撞体系统，帮助开发者掌握这一核心功能。

什么是碰撞体？

碰撞体是Excalibur中对几何形状的抽象表示，它们实现了Collider接口，能够：

检测与其他碰撞体的相交
进行射线投射测试
检查点是否包含在碰撞体内
提供各种几何运算功能

需要注意的是，碰撞体与物理体(Bodies)是不同的概念。碰撞体只负责检测碰撞，而物理体则负责处理碰撞后的物理响应。

碰撞体的基本特性

相对性：碰撞体是相对于所属实体的TransformComponent的，它们只表示相对于实体变换组件的几何形状。
偏移：可以通过Collider.offset属性调整碰撞体的位置偏移。
依赖实体：碰撞体必须附加到实体上才有实际意义，单独的碰撞体没有世界坐标位置。

Excalibur中的碰撞体类型

1. 圆形碰撞体(CircleCollider)

圆形碰撞体是最简单的碰撞体类型，适用于球体、圆形角色等游戏对象。

// 方式1：通过Actor的radius属性自动创建
const actorWithCircle = new ex.Actor({
  pos: ex.vec(5, 5),
  radius: 10  // 自动创建半径为10的圆形碰撞体
});

// 方式2：显式创建并设置
const circle = new ex.CircleCollider({
  radius: 10
});

// 方式3：使用Shape工具创建
const circle = ex.Shape.Circle(10);

const actor = new ex.Actor({
  pos: ex.vec(100, 100),
  collider: circle
});

// 动态修改碰撞体
actor.collider.set(new ex.CircleCollider({ radius: 20 }));

2. 多边形碰撞体(PolygonCollider)

多边形碰撞体可以定义任意凸多边形。注意必须是凸多边形，即多边形内部没有凹陷。

// 创建矩形碰撞体(使用Shape工具)
const box = ex.Shape.Box(100, 10);  // 宽100，高10

// 创建三角形碰撞体
const triangle = new ex.PolygonCollider({
  points: [
    ex.vec(-100, 0),  // 左下点
    ex.vec(0, -50),   // 顶点
    ex.vec(100, 0)    // 右下点
  ]
});

const actor = new ex.Actor({
  pos: ex.vec(100, 100),
  collider: triangle
});

3. 边缘碰撞体(EdgeCollider)

边缘碰撞体定义了一条线段，常用于创建墙壁、平台等游戏元素。

const edge = new ex.EdgeCollider({
  begin: ex.vec(0, 0),   // 起点(相对于实体位置)
  end: ex.vec(100, 0)    // 终点
});

const platform = new ex.Actor({
  pos: ex.vec(100, 100),
  collider: edge
});

4. 复合碰撞体(CompositeCollider)

复合碰撞体允许将多个碰撞体组合在一起，创建复杂的碰撞形状。

// 创建胶囊形状碰撞体(由两个圆和一个矩形组成)
const capsule = new ex.CompositeCollider([
  ex.Shape.Circle(10, ex.vec(0, -20)),  // 顶部圆
  ex.Shape.Box(20, 40),                 // 中间矩形
  ex.Shape.Circle(10, ex.vec(0, 20))    // 底部圆
]);

const player = new ex.Actor({
  pos: ex.vec(100, 100),
  collider: capsule
});

高级用法：子实体碰撞

除了使用复合碰撞体，还可以通过子实体来实现复杂的碰撞逻辑。这种方法特别适合实现感应区域、触发区域等需求。

const player = new ex.Actor({...});

// 创建感应区域(半径100像素)
const sensor = new ex.Actor({
  radius: 100
});

player.addChild(sensor);

// 监听感应区域的碰撞开始事件
sensor.on('collisionstart', (evt) => {
  if (evt.other !== player) {
    console.log('有物体接近玩家100像素范围内');
  }
});