跳至主要內容

Input.action_release

EVOCOSMOS2026/4/14大约 7 分钟

最后同步日期：2026-04-15 | Godot 官方原文 — Input.action_release

Input.action_release

定义

想象你按住了一个按钮不放——你的角色一直在做某个动作（比如蓄力、冲刺）。现在你想让角色停下来，就需要松开按钮。action_release 就是用来在代码里"松手"的。

它是 action_press 的搭档。action_press 负责"按下去"，action_release 负责"松开"。两个函数配合使用，就能在代码中完整地模拟一次按键的"按下-松开"过程。

一句话总结

action_release = "让代码替玩家松开按键"——结束由 action_press 开始的模拟按下状态。

和 action_press 的关系

action_release 通常和 action_press 成对使用。如果你只调用了 action_press 而忘记调用 action_release，该动作会永远处于按下状态，直到游戏结束。这就像你按住门铃不松手——门铃会一直响。

函数签名

C#
public static void ActionRelease(string action)

参数说明

参数类型必需说明
actionstring是要模拟松开的动作名称，在项目设置（Project Settings -> Input Map）中定义。比如 "jump"、"shoot"

返回值

此函数没有返回值（void）。

代码示例

基础用法

最简单的用法——模拟一次完整的"按下然后松开"：

C#
using Godot;

public partial class TestActionRelease : Node
{
    public override void _Ready()
    {
        // 第一步：模拟按下
        Input.ActionPress("jump");
        GD.Print("按下后: " + Input.IsActionPressed("jump"));
        // 运行结果: 按下后: True

        // 第二步：模拟松开
        Input.ActionRelease("jump");
        GD.Print("松开后: " + Input.IsActionPressed("jump"));
        // 运行结果: 松开后: False
    }
}

实际场景

在一个格斗游戏中，实现"蓄力攻击"：按住攻击键蓄力，松开后释放。用 action_press 和 action_release 来让 AI 角色也能执行蓄力攻击：

C#
using Godot;

public partial class ChargeAttack : Node
{
    [Export] public float ExMaxChargeTime = 2.0f;
    [Export] public int ExMinDamage = 10;
    [Export] public int ExMaxDamage = 50;

    private bool _isCharging = false;
    private float _chargeStartTime;

    public override void _UnhandledInput(InputEvent @event)
    {
        // 玩家按下攻击键：开始蓄力
        if (@event.IsActionPressed("attack"))
        {
            _isCharging = true;
            _chargeStartTime = (float)Time.GetTicksMsec() / 1000f;
            GD.Print("开始蓄力...");
            // 运行结果: 开始蓄力...
        }

        // 玩家松开攻击键：释放攻击
        if (@event.IsActionReleased("attack") && _isCharging)
        {
            ReleaseCharge();
        }
    }

    public override void _Process(double delta)
    {
        if (!_isCharging) return;

        // 显示蓄力进度
        float chargeTime = (float)Time.GetTicksMsec() / 1000f - _chargeStartTime;
        float progress = Mathf.Clamp(chargeTime / ExMaxChargeTime, 0f, 1f);
        GD.Print($"蓄力中: {progress * 100:F0}%");
        // 运行结果: 蓄力中: 25%
        //          蓄力中: 50%
        //          蓄力中: 75%
    }

    private void ReleaseCharge()
    {
        _isCharging = false;
        float chargeTime = (float)Time.GetTicksMsec() / 1000f - _chargeStartTime;
        float progress = Mathf.Clamp(chargeTime / ExMaxChargeTime, 0f, 1f);

        int damage = (int)(ExMinDamage + (ExMaxDamage - ExMinDamage) * progress);
        GD.Print($"释放攻击！蓄力={progress * 100:F0}%，伤害={damage}");
        // 运行结果: 释放攻击！蓄力=75%，伤害=40
        //          释放攻击！蓄力=100%，伤害=50
    }

    // AI 角色也可以使用蓄力攻击
    public async void AIChargeAttack(float chargeDuration)
    {
        GD.Print("AI 开始蓄力攻击");
        // 运行结果: AI 开始蓄力攻击

        Input.ActionPress("attack");
        await ToSignal(GetTree().CreateTimer(chargeDuration), SceneTreeTimer.SignalName.Timeout);
        Input.ActionRelease("attack");
    }
}

进阶用法

实现一个连招系统——用 action_press 和 action_release 自动执行一系列连续的按键操作，形成连招效果。这在格斗游戏或动作游戏中非常常见：

C#
using Godot;

public partial class ComboSystem : Node
{
    // 连招定义：每个步骤包含动作名和持续时间（秒）
    private readonly record ComboStep(string Action, double HoldTime);

    private Godot.Collections.Array<ComboStep> _currentCombo = new();
    private int _currentStep = 0;
    private double _stepTimer = 0;
    private bool _isExecuting = false;

    // 预设连招：三连击
    private readonly ComboStep[] _tripleHitCombo = new ComboStep[]
    {
        new ComboStep("attack_light", 0.15),
        new ComboStep("attack_light", 0.15),
        new ComboStep("attack_heavy", 0.3),
    };

    // 预设连招：冲刺 + 上挑 + 下砸
    private readonly ComboStep[] _launchCombo = new ComboStep[]
    {
        new ComboStep("dash", 0.2),
        new ComboStep("attack_up", 0.15),
        new ComboStep("attack_down", 0.3),
    };

    public override void _UnhandledInput(InputEvent @event)
    {
        // 按 1 键执行三连击
        if (@event.IsActionPressed("combo_1"))
        {
            ExecuteCombo(_tripleHitCombo);
        }
        // 按 2 键执行上挑连招
        if (@event.IsActionPressed("combo_2"))
        {
            ExecuteCombo(_launchCombo);
        }
    }

    private void ExecuteCombo(ComboStep[] combo)
    {
        if (_isExecuting) return; // 正在执行中，不重复触发

        _currentCombo.Clear();
        foreach (var step in combo)
        {
            _currentCombo.Add(step);
        }

        _currentStep = 0;
        _isExecuting = true;

        GD.Print("=== 开始执行连招，共 " + _currentCombo.Count + " 步 ===");
        // 运行结果: === 开始执行连招，共 3 步 ===
    }

    public override void _Process(double delta)
    {
        if (!_isExecuting || _currentStep >= _currentCombo.Count) return;

        var step = _currentCombo[_currentStep];
        _stepTimer += delta;

        if (_stepTimer == 0)
        {
            // 第一步：按下当前动作
            Input.ActionPress(step.Action);
            GD.Print($"第 {_currentStep + 1} 步: 按下 {step.Action}");
            // 运行结果: 第 1 步: 按下 attack_light
        }

        if (_stepTimer >= step.HoldTime)
        {
            // 时间到：松开当前动作，进入下一步
            Input.ActionRelease(step.Action);
            GD.Print($"第 {_currentStep + 1} 步: 松开 {step.Action}");
            // 运行结果: 第 1 步: 松开 attack_light

            _currentStep++;
            _stepTimer = 0;

            if (_currentStep >= _currentCombo.Count)
            {
                _isExecuting = false;
                GD.Print("=== 连招执行完毕 ===");
                // 运行结果: === 连招执行完毕 ===
            }
        }
    }
}

注意事项

  • 必须和 action_press 配对使用：action_release 的作用是解除由 action_press 设置的"按下"状态。如果你在调用 action_release 之前没有调用过 action_press，调用也不会报错，但不会有任何效果。
  • 同样不会产生 InputEvent 事件：和 action_press 一样，action_release 也不会触发 InputEvent。_Input、_UnhandledInput 等回调函数收不到这个模拟的松开事件。它只影响 Input.IsActionPressed、Input.IsActionJustReleased 等查询方法的返回值。
  • 忘记释放会导致"卡键"：如果你调用了 action_press 但忘记调用 action_release，该动作会一直保持按下状态，is_action_just_released 可能会在下一帧触发一次，但 is_action_pressed 会一直返回 true。这会导致你的角色"卡住"（比如一直处于跳跃或攻击状态）。建议在不需要模拟输入时，确保所有之前 action_press 过的动作都被正确 action_release。
  • 可以用 flush_buffer 清除所有状态：如果你不确定当前有哪些动作处于模拟按下状态，可以调用 Input.FlushBuffer()（C#）/ Input.flush_buffer()（GDScript）来一次性清除所有模拟的输入状态，相当于"全部松开"。
  • 玩家真实输入会覆盖模拟状态：如果玩家真实按下了某个你正在用 action_press 模拟的动作，真实输入会与模拟输入叠加。松开真实按键或调用 action_release 都会改变动作的状态。建议在模拟输入期间暂时禁用或忽略玩家的真实输入，避免冲突。
  • C# 差异：C# 中方法名用 PascalCase（Input.ActionRelease），GDScript 中用 snake_case（Input.action_release）。
最近更新:
贡献者: zefeng.peng,bobokaka
EVOCOSMOS
Copyright © 2026 EVOCOSMOS