限制

• 必须手动将游戏手柄分配给每个输入映射：从 Gamepads 资源读取并使用 InputMap::set_gamepad。

入门

1. 将 leafwing-input-manager 添加到你的 Cargo.toml。
2. 创建一个枚举来表示你想要表示的逻辑动作，并为其推导 Actionlike 特性。
3. 将 InputManagerPlugin 添加到你的 App。
4. 将 InputManagerBundle 添加到你的玩家实体（或实体！）。
5. 通过修改玩家实体上的 InputMap 组件来配置你的输入与动作之间的映射。
6. 读取玩家实体上的 ActionState 组件以检查收集到的输入状态！

use bevy::prelude::*;
use leafwing_input_manager::prelude::*;

fn main() {
    App::new()
        .add_plugins(DefaultPlugins)
        // This plugin maps inputs to an input-type agnostic action-state
        // We need to provide it with an enum which stores the possible actions a player could take
        .add_plugins(InputManagerPlugin::<Action>::default())
        // The InputMap and ActionState components will be added to any entity with the Player component
        .add_systems(Startup, spawn_player)
        // Read the ActionState in your systems using queries!
        .add_systems(Update, jump)
        .run();
}

// This is the list of "things in the game I want to be able to do based on input"
#[derive(Actionlike, PartialEq, Eq, Hash, Clone, Copy, Debug, Reflect)]
enum Action {
    Run,
    Jump,
}

#[derive(Component)]
struct Player;

fn spawn_player(mut commands: Commands) {
    // Describes how to convert from player inputs into those actions
    let input_map = InputMap::new([(Action::Jump, KeyCode::Space)]);
    commands
        .spawn(InputManagerBundle::with_map(input_map))
        .insert(Player);
}

// Query for the `ActionState` component in your game logic systems!
fn jump(query: Query<&ActionState<Action>, With<Player>>) {
    let action_state = query.single();
    // Each action has a button-like state of its own that you can check
    if action_state.just_pressed(&Action::Jump) {
        println!("I'm jumping!");
    }
}

此片段是从 examples 文件夹中的 minimal.rs 示例：请在那里查找更多深入的学习材料！

存储库功能标志

请参阅 Cargo.toml 中的 [features] 部分，了解有关可用存储库功能的详细信息。