一下、按住与松手

老雷给试招台排了三个动作：空格出剑，左 Shift 按住运劲，松手收势。三个动作对“按”的理解各不相同——出剑认“按下的那一下”，运劲认“按住的每一刻”，收势认“松开的那一瞬”。ButtonInput 正好备了三种问法：

rust

/// 三种问法，三种招式：一下出剑、按住运劲、松手收势
fn moves(
    keyboard: Res<ButtonInput<KeyCode>>,
    time: Res<Time>,
    mut ayan: Single<&mut Sprite, With<Ayan>>,
    mut charge: Local<f32>,
    mut slashes: Local<u32>,
) {
    // just_pressed：只在按下的那一帧为真——按住不放也只出一剑
    if keyboard.just_pressed(KeyCode::Space) {
        *slashes += 1;
        let name = ["拨云", "断浪", "归鞘"][(*slashes as usize - 1) % 3];
        println!("阿燕：青霜剑——{name}！（第 {} 剑）", *slashes);
    }

    // pressed：按住期间每帧都为真——劲随时间越运越足
    if keyboard.pressed(KeyCode::ShiftLeft) {
        *charge = (*charge + time.delta_secs()).min(2.0);
        let heat = Color::srgb(1.0, 0.84, 0.40);
        ayan.color = Color::WHITE.mix(&heat, *charge / 2.0);
    }

    // just_released：只在松开的那一帧为真——正好用来结算
    if keyboard.just_released(KeyCode::ShiftLeft) {
        println!("场记：收势。这口劲运了 {:.1} 秒。", *charge);
        *charge = 0.0;
        ayan.color = Color::WHITE;
    }
}

Listing 17-3（其一）：三问三招——just_pressed、pressed、just_released（examples/listing-17-03.rs）

just_pressed 只在按下的那一帧为真，just_released 只在松开的那一帧为真，pressed 则从按下到松开全程为真。一次完整的按键在快照里的一生，画在时间线上是这样：

时间线示意图：手上的键在第 3 帧按下、第 7 帧松开；pressed 行在第 3 到 7 帧为真，just_pressed 仅第 3 帧为真，just_released 仅第 8 帧为真

Figure 17-2：一次按键的一生——三种问法各在哪几帧答“真”

跑起来试：

console

cargo run -p ch17-input --example listing-17-03

点按空格三下、按住左 Shift 一秒再松手，台账如下（场记的“速记”行先按下不表，马上解释）：

text

阿燕：青霜剑——拨云！（第 1 剑）
阿燕：青霜剑——断浪！（第 2 剑）
阿燕：青霜剑——归鞘！（第 3 剑）
场记：收势。这口劲运了 1.0 秒。

每点一下出一剑，运劲期间阿燕的戏服随 charge 渐渐染金（Mix 是第 15 章调色间的手艺），松手一笔结清。都符合直觉。

现在做个实验：按住空格两秒不放。文本编辑器里这么干会打出一串空格——操作系统的自动重复在替你连按。阿燕呢？

只出一剑。

流水账与快照

“一剑”是 ButtonInput 替我们挡掉了什么的结果。想看清挡掉了什么，得绕到快照背后，看输入的原始形态。键盘事件进入 Bevy 时首先是消息——第 7 章的 Message，类型叫 KeyboardInput，按下、松开、自动重复，每个事件一条。给场记开一本流水账，逐条速记：

rust

/// 流水账：每条 KeyboardInput 消息原样过一遍场记的笔
fn transcript(mut events: MessageReader<KeyboardInput>) {
    for event in events.read() {
        let state = if event.state.is_pressed() {
            "按下"
        } else {
            "松开"
        };
        let repeat = if event.repeat { "（系统重复）" } else { "" };
        let text = match &event.text {
            Some(t) => format!("，落字 {t:?}"),
            None => String::new(),
        };
        println!(
            "场记速记：{:?} {state}{repeat}，逻辑键 {:?}{text}",
            event.key_code, event.logical_key
        );
    }
}

Listing 17-3（其二）：流水账——逐条读 KeyboardInput 消息

两个系统同台跑。这回按住空格不放，再看输出：

text

阿燕：青霜剑——拨云！（第 1 剑）
场记速记：Space 按下，逻辑键 Space，落字 " "
场记速记：Space 按下（系统重复），逻辑键 Space，落字 " "
场记速记：Space 按下（系统重复），逻辑键 Space，落字 " "
场记速记：Space 松开，逻辑键 Space

真相摆在台面上：操作系统确实在连发“按下”事件（repeat: true 的那些行），流水账一条不落地记了；而出剑只触发一次——快照在折叠流水时把重复滤掉了，已经在“按住”集合里的键再收到按下事件不会再进 just_pressed。自动重复是给文本编辑准备的服务，对游戏是噪声，ButtonInput 替你消了音。

一条 KeyboardInput 消息里有这几样：key_code（物理键）、logical_key（逻辑键）、state（按下/松开）、repeat（是不是系统重复）、text（这一按产出的文本，空格键落字 " "）、window（哪个窗口收的）。做聊天框、起名输入框时就读这条流水里的 text——不过中文输入法的组字另有一条 Ime 消息通道，那是第 35 章窗口细节的事。

流水与快照的全景是这样接起来的：

管线示意图：设备事件以消息流进入，PreUpdate 的 InputSystems 把流折叠成本帧快照，Update 里你的系统可以问快照也可以读流水

Figure 17-3：同一份输入的两种读法——绝大多数玩法问快照，要逐条细节才读流水

第 6 章那张调度表说过“键盘输入由 bevy_input 的系统在 PreUpdate 写进资源”，现在这句话有了完整的画面：InputPlugin 在 PreUpdate 跑一组折叠系统（系统集 InputSystems），把本帧攒下的消息汇成各路快照。于是有一条很值钱的保证：快照每帧只刷新一次，同一帧里所有 Update 系统看到的输入完全一致——不存在“前一个系统看到按着、后一个系统看到松开”的撕裂。

失焦不卡键。 按住 D 走着，Alt+Tab 切去回微信，再切回来——阿燕没有原地狂奔。窗口失焦时 winit 发一条 KeyboardFocusLost 消息，折叠系统收到后把所有按着的键统一登记成“松开”（它们会触发一次 just_released）。这类脏活引擎都包了。
顺带埋一句：快照的 just_pressed 以帧为粒度，而 FixedUpdate 调度和帧不是一对一的——在那里面读 just_pressed 会丢拍或重拍。这个坑连同它的解法，留给第 18 章。

一下、按住与松手 ​

流水账与快照 ​

一下、按住与松手

流水账与快照