碰撞器

碰撞器（Collider）是一种用于检测和响应物理碰撞的组件。引擎提供以下几种碰撞器：

碰撞器组件用于定义物体的物理属性和碰撞行为。Galacean 物理系统提供了三种类型的碰撞器:

1. 动态碰撞器
   动态碰撞器可以自由运动并受物理力的影响,适用于需要物理模拟的可移动物体,如投掷物、可推动的箱子等。

2. 静态碰撞器
   静态碰撞器固定在场景中不会移动,通常用于创建固定的物理障碍物,如地面、墙壁等。

3. 角色控制器
   角色控制器是专门为角色移动设计的碰撞器,支持斜坡行走、台阶攀爬等特性,适用于第一人称或第三人称游戏中的角色控制。

基本概念

所有碰撞器类型都具有以下共同特征：

1. 形状管理：每个碰撞器可以包含多个碰撞形状 (角色控制器只能添加一个)。关于碰撞形状的详细说明请参考碰撞形状文档。

目前支持了四种 碰撞形状，但不同的后端物理包支持程度不同，具体如下：

2. 变换同步：

   • 碰撞器会自动同步实体的世界变换，包括位置、旋转和缩放的同步
   • 碰撞形状 可以设置相对于实体的局部偏移和旋转

3. 碰撞/触发事件：碰撞器在与其他碰撞器交互时可以生成碰撞和触发器事件。有关这些事件的详细信息以及如何处理它们，请参阅碰撞事件文档。

最佳实践

1. 合理使用形状

• 保持碰撞形状数量最小化，仅在必要时添加额外形状，以减少性能开销
• 避免使用过多的碰撞形状
• 对于复杂模型，使用简化的碰撞形状代替精确网格
• 角色控制器推荐使用胶囊体形状，可以更好地处理台阶和斜坡

2. 性能优化

   • 将不会移动的物体设置为静态碰撞器
   • 合并相邻的静态碰撞器
   • 适当调整动态碰撞器的 solverIterations，在性能和精度间取得平衡
   • 合理使用 CollisionDetectionMode，只在必要时启用连续碰撞检测

3. 动态碰撞器设置

   • 根据物体质量调整 linearDamping 和 angularDamping，避免物体运动不自然
   • 使用 constraints 限制不需要的自由度，提高稳定性
   • 适当设置 sleepThreshold，让静止物体及时进入休眠状态

4. 角色控制器配置

   • 根据游戏类型设置合适的 stepOffset，避免卡住或跨越不合理
   • 设置适当的 slopeLimit，需要考虑游戏场景中的斜坡角度
   • 选择合适的 nonWalkableMode，考虑是否需要滑落效果
   • 保持碰撞形状与角色视觉模型的合理匹配

5. 使用场景

   • 静态碰撞器：场景边界、地形、建筑等固定物体
   • 动态碰撞器：可推动物体、物理道具、破坏物等
   • 角色控制器：玩家角色、NPC 等需要特殊移动控制的对象

脚本使用

添加碰撞器

// 添加静态碰撞器
const staticCollider = entity.addComponent(StaticCollider);
 
// 添加动态碰撞器
const dynamicCollider = entity.addComponent(DynamicCollider);
 
// 添加角色控制器
const characterController = entity.addComponent(CharacterController);

更多信息

• 动态碰撞器文档
• 静态碰撞器文档
• 角色控制器文档
• 碰撞事件文档