Bevy_xpbd 中如何锁定刚体的旋转自由度

在物理引擎中，刚体通常具有6个自由度：3个平移自由度和3个旋转自由度。但在2D物理模拟中，我们通常只需要考虑2个平移自由度和1个旋转自由度。Bevy_xpbd作为Bevy游戏引擎的物理扩展，提供了对刚体运动的精细控制能力。

问题背景

在开发2D物理游戏时，开发者可能会遇到需要限制刚体旋转的情况。例如，当模拟一个只能平移而不能旋转的物体时，或者当需要保持某个物体的特定朝向不变时。

解决方案

Bevy_xpbd提供了LockedAxes组件，可以用来锁定刚体的特定自由度。要锁定旋转自由度，只需为实体添加LockedAxes::ROTATION_LOCKED组件。

实现示例

以下是一个完整的示例代码，展示了如何创建一个被墙壁包围的环境，并在其中放置一个不会旋转的方块：

use avian2d::prelude::*;
use bevy::{prelude::*, render::camera::ScalingMode};

fn main() {
    App::new()
        .add_plugins((DefaultPlugins, PhysicsPlugins::default()))
        .insert_resource(Gravity(Vec2::ZERO))
        .add_systems(Startup, setup)
        .run();
}

fn setup(mut commands: Commands) {
    // 设置相机
    let mut camera = Camera2dBundle::default();
    camera.projection.scaling_mode = ScalingMode::FixedVertical(10.);
    commands.spawn(camera);

    // 创建四周的墙壁
    // 上墙
    commands.spawn((
        RigidBody::Static,
        Collider::rectangle(10., 0.2),
        // ... 其他组件
    ));
    
    // 下墙
    commands.spawn((
        RigidBody::Static,
        Collider::rectangle(10., 0.2),
        // ... 其他组件
    ));
    
    // 左墙
    commands.spawn((
        RigidBody::Static,
        Collider::rectangle(0.2, 6.0),
        // ... 其他组件
    ));
    
    // 右墙
    commands.spawn((
        RigidBody::Static,
        Collider::rectangle(0.2, 6.0),
        // ... 其他组件
    ));

    // 创建不会旋转的方块
    commands.spawn((
        Collider::rectangle(0.5, 0.5),
        RigidBody::Dynamic,
        LinearVelocity(Vec2::new(3., 3.)),
        Restitution::new(1.0).with_combine_rule(CoefficientCombine::Max),
        Friction::ZERO.with_combine_rule(CoefficientCombine::Min),
        LockedAxes::ROTATION_LOCKED, // 关键：锁定旋转自由度
        // ... 其他组件
    ));
}

技术细节

1. LockedAxes组件：这是Bevy_xpbd提供的用于锁定刚体自由度的组件。除了ROTATION_LOCKED外，还可以使用：

   • TRANSLATION_X_LOCKED：锁定X轴平移
   • TRANSLATION_Y_LOCKED：锁定Y轴平移
   • TRANSLATION_Z_LOCKED：锁定Z轴平移（3D场景）
   • 这些选项可以通过位或操作(|)组合使用

2. 物理属性设置：

   • Restitution设置为1.0表示完全弹性碰撞
   • Friction设置为0表示无摩擦力
   • 这些设置确保了方块的运动只受碰撞影响，不受其他因素干扰

3. 应用场景：

   • 2D平台游戏中的玩家角色（通常不需要旋转）
   • 滑动门或平台
   • 任何需要保持固定朝向的物体

注意事项

1. 锁定旋转自由度后，刚体将完全不会对碰撞产生的扭矩做出反应，这在某些情况下可能导致不自然的物理行为。

2. 如果需要部分限制旋转而非完全锁定，可以考虑使用AngularDamping组件增加旋转阻尼，而不是完全锁定。

3. 在复杂的物理交互中，过度使用自由度锁定可能导致物理模拟不稳定，应谨慎使用。

通过合理使用LockedAxes组件，开发者可以精确控制游戏对象的物理行为，创造出符合游戏设计需求的物理效果。