Entrada & Eventos

Lide com eventos de teclado, mouse, gamepad e do jogo no Bevy - controles responsivos sem sistemas emaranhados.

Receita

fn jump(
    keys: Res<ButtonInput<KeyCode>>,
    mut q: Query<&mut PlayerState>,
) {
    if keys.just_pressed(KeyCode::Space) {
        for mut state in &mut q {
            state.request_jump = true;
        }
    }
}

Quando usar isso:

• Qualquer jogo controlado pelo jogador
• Sistemas de replay gravando bordas de entrada
• Botões de UI disparando gameplay via eventos
• Cooperativo local multijogador no sofá com vários gamepads

Exemplo de Trabalho

use bevy::prelude::*;
 
#[derive(Event)]
struct PlayerShot {
    entity: Entity,
}
 
#[derive(Component)]
struct Cooldown(Timer);
 
fn shooting(
    mouse: Res<ButtonInput<MouseButton>>,
    mut commands: Commands,
    mut reader_q: Query<(Entity, &mut Cooldown)>,
    mut events: EventWriter<PlayerShot>,
    time: Res<Time>,
) {
    if !mouse.just_pressed(MouseButton::Left) {
        return;
    }
    for (entity, mut cd) in &mut reader_q {
        cd.0.tick(time.delta());
        if cd.0.finished() {
            events.write(PlayerShot { entity });
            cd.0.reset();
        }
    }
}
 
fn on_shot(mut events: EventReader<PlayerShot>) {
    for e in events.read() {
        println!("shot from {:?}", e.entity);
    }
}

O que isso demonstra:

• Borda just_pressed para disparo único por clique
• Temporizador de cooldown para evitar spam de eventos
• Consumidor EventReader separado do escritor do sistema

Mergulho Profundo

Como Funciona

• Recursos de entrada atualizados uma vez por frame antes dos sistemas Update.
• Mapas de ação (o leafwing-input-manager da comunidade ou um personalizado) vinculam teclas a intenções.
• Eventos são filas drenadas por leitores; a ordem depende da ordenação do sistema.
• Nós de UI podem bloquear eventos de ponteiro quando interativos.

Tipos de Entrada

Armadilhas

• Usar pressed para ações que precisam ser únicas - a repetição automática parece errada. Correção: just_pressed para ações discretas.
• Sem tempo delta para mira do mouse - a sensibilidade varia com o FPS. Correção: escalar por time.delta_secs().
• Sistemas lendo eventos antes que os escritores sejam executados - lag de um frame. Correção: ordenar .after(shooting) no leitor.
• Milhares de eventos por frame - sobrecarga. Correção: mutação direta de componente para simulações em massa; eventos para sinais esparsos.
• Gamepad não atribuído - jogador 2 inativo. Correção: detectar conexões Gamepad na inserção e mapear por dispositivo.

Alternativas

FAQs

Relacionados

• Bevy Engine - ordenação de sistemas
• Loops de Jogo e Tempo - atualização fixa
• Básicos de Desenvolvimento de Jogos - exemplo de entrada
• Física e Áudio - SFX orientado a eventos

Versões da Pilha: Esta página foi escrita para Rust 1.97.0 (edição 2024), Tokio 1.x, Axum 0.8, serde 1.0, sqlx 0.8, clap 4, e Polars 0.46+.