游戏引擎 / 系统课时
通过攻击输入驱动连击状态
通过攻击输入驱动连击状态
本课把第三人称角色的攻击按钮接成可验证的三段连击:第一次按下进入 Attack1,后续按键只有落入指定时间窗才会排队,动作结束时再切到下一段。完成后能区分单击、连点、长按与受击中断,避免重复触发或无限连击。
学习目标
- 配置
Attack的按下触发方式与三段 Animator 状态。 - 使用 0.15 秒输入缓冲和分段窗口决定能否接招。
- 验证长按不连发、过早输入失效及中断后重置。
绑定输入与动画状态
以下适用于 Unity 6 与 Input System 1.x。先在 Window > Package Manager 确认已安装 Input System,再完成这些设置:
- 在
.inputactions资源中打开PlayerAction Map,新建Attack,设Action Type = Button,绑定<Mouse>/leftButton,需要手柄时再加<Gamepad>/buttonWest。 - 在
Attack的Interactions添加Press,将Behavior设为Press Only。不要使用Hold或Press And Release,否则按住或松开可能改变触发次数。 - 角色根对象挂
PlayerInput,Actions指向上述资源,Default Map选Player。下文直接订阅该玩家的动作回调,不要求修改既有Behavior设置。 - Animator Controller 的
Base Layer准备Locomotion、Attack1、Attack2、Attack3四个状态,后三者分别放入一段非循环攻击剪辑,状态播放速度均为1。攻击状态之间不要另设会自动触发的 Transition,避免与脚本抢控制权。
将 MeleeComboController 挂到角色根对象,把角色模型的 Animator 拖到脚本字段。示例使用 Animator.Play 直接切换状态,Locomotion 可以是包含 Idle/Walk/Run 的混合树状态。
规定接招窗口与重置条件
以动画播放速度为 1、未暂停的试玩关卡为例,先选定一组与真实攻击剪辑一致的时长。窗口用本段动作的归一化进度表示,0 为起点,1 为终点。
| 当前动作 | 剪辑时长 | 可确认下一击的进度 | 对应秒数 |
|---|---|---|---|
| Attack1 | 0.60 秒 | 40%~80% | 0.24~0.48 秒 |
| Attack2 | 0.70 秒 | 45%~85% | 0.315~0.595 秒 |
| Attack3 | 0.85 秒 | 不接第四段 | 动作结束后重置 |
按键允许最多提前 0.15 秒暂存:例如 Attack1 开始后 0.12 秒按第二次,先入缓冲,走到 0.24 秒时确认;在 0.05 秒按则太早,直接忽略。确认下一击不等于马上打断当前动作,脚本会等本段结束再切换。每段只接受一次后续输入。
没有确认后续输入时,本段播放完即回到 Locomotion;第三段结束也直接重置。受击、死亡或强制打断则清空所有排队输入,下一次允许攻击时必须从 Attack1 开始。

编写连击控制脚本
在 Assets/Scripts 创建 MeleeComboController.cs。代码使用 PlayerInput.actions 中当前玩家自己的 Player/Attack,由 PlayerInput 负责启停 Action Map,因此不在脚本里再次调用 Enable() 或 Disable()。示例按指定剪辑时长计时,若实际动画长短不同,须同步修改 Durations。
using UnityEngine;
using UnityEngine.InputSystem;
[RequireComponent(typeof(PlayerInput))]
public sealed class MeleeComboController : MonoBehaviour
{
[SerializeField] private Animator animator;
[SerializeField, Min(0f)] private float inputBufferSeconds = 0.15f;
// 与三个非循环剪辑的实际播放时长保持一致
private static readonly float[] Durations = { 0.60f, 0.70f, 0.85f };
private static readonly float[] WindowOpen = { 0.40f, 0.45f };
private static readonly float[] WindowClose = { 0.80f, 0.85f };
private static readonly int[] AttackHashes =
{
Animator.StringToHash("Base Layer.Attack1"),
Animator.StringToHash("Base Layer.Attack2"),
Animator.StringToHash("Base Layer.Attack3")
};
private static readonly int LocomotionHash =
Animator.StringToHash("Base Layer.Locomotion");
private PlayerInput playerInput;
private InputAction attackAction;
private bool started;
private int stage; // 0=非攻击,1~3=当前连段
private float stageStartedAt;
private float bufferedAt;
private bool buffered;
private bool nextConfirmed;
private void Awake()
{
playerInput = GetComponent<PlayerInput>();
if (animator == null) animator = GetComponentInChildren<Animator>();
}
private void Start()
{
started = true;
Subscribe();
}
private void OnEnable()
{
if (started) Subscribe();
}
private void Subscribe()
{
if (animator == null)
{
Debug.LogError("MeleeComboController: Animator 未赋值");
enabled = false;
return;
}
attackAction = playerInput.actions.FindAction("Player/Attack", true);
attackAction.performed += OnAttack;
}
private void OnDisable()
{
if (attackAction != null)
{
attackAction.performed -= OnAttack;
attackAction = null;
}
InterruptCombo();
}
private void OnAttack(InputAction.CallbackContext context)
{
if (stage == 0)
{
EnterStage(1);
return;
}
if (stage == 3 || buffered || nextConfirmed) return;
float elapsed = Time.time - stageStartedAt;
float open = Durations[stage - 1] * WindowOpen[stage - 1];
float close = Durations[stage - 1] * WindowClose[stage - 1];
// 最多允许在窗口开启前0.15秒预存一次按键
if (elapsed >= open - inputBufferSeconds && elapsed <= close)
{
buffered = true;
bufferedAt = Time.time;
}
}
private void Update()
{
if (stage == 0) return;
float elapsed = Time.time - stageStartedAt;
if (stage < 3 && buffered)
{
float open = Durations[stage - 1] * WindowOpen[stage - 1];
float close = Durations[stage - 1] * WindowClose[stage - 1];
if (elapsed >= open && elapsed <= close &&
Time.time - bufferedAt <= inputBufferSeconds)
{
nextConfirmed = true;
buffered = false;
}
else if (elapsed > close ||
Time.time - bufferedAt > inputBufferSeconds)
{
buffered = false; // 过期输入不能接到下一段
}
}
if (elapsed < Durations[stage - 1]) return;
if (nextConfirmed && stage < 3) EnterStage(stage + 1);
else FinishCombo();
}
private void EnterStage(int nextStage)
{
stage = nextStage;
stageStartedAt = Time.time;
buffered = false;
nextConfirmed = false;
animator.Play(AttackHashes[stage - 1], 0, 0f);
Debug.Log($"Attack{stage}");
}
private void FinishCombo()
{
InterruptCombo();
animator.Play(LocomotionHash, 0, 0f);
Debug.Log("Combo reset");
}
// 受击/死亡逻辑先调用此方法,再播放自身的受击或死亡状态
public void InterruptCombo()
{
stage = 0;
buffered = false;
nextConfirmed = false;
}
}预期结果:运行场景,第一次单击后在 Attack1 的有效窗口内再单击,在 Attack2 的有效窗口内第三次单击;待三段动画结束,Console 顺序显示:
Attack1
Attack2
Attack3
Combo reset这里的 Time.time 和 Animator 的 Normal 更新模式都受游戏时间缩放影响。原型阶段保持 Time.timeScale = 1、Animator.speed = 1、各攻击状态 Speed = 1;正式项目需要变速攻击时,改用实际 Animator 状态进度或统一的战斗计时器,不要只改动画速度而保留固定时长数组。
验收输入边界与中断恢复
在 Play 模式打开 Window > General > Console,按下列输入顺序检查;每次测试前等 Console 出现 Combo reset。
| 操作 | 预期行为 |
|---|---|
| 只单击一次 | 只有 Attack1,0.60 秒后重置 |
| Attack1 开始后 0.12 秒再按一次 | 提前缓存,动作结束接 Attack2 |
| Attack1 开始后 0.05 秒再按一次 | 输入过早,仍只打 Attack1 |
| Attack1 开始后 0.52 秒再按一次 | 已超出关闭窗口,不进入 Attack2 |
| 一直按住攻击键 2 秒 | 只打 Attack1;松开再按才是新输入 |
| 有效窗口内快速连点多次 | 当前段最多确认下一段一次,不跳段 |
验证受击中断时,由现有生命值或受击脚本调用 combo.InterruptCombo(),然后播放 Hit 或 Death 状态,并在禁止攻击期间禁用该连击组件;复活或硬直结束后重新启用。此方法只清空连段,不会擅自播放 Locomotion 覆盖受击动画。若复活后仍接 Attack2,优先检查是否有另一个脚本也在处理 Attack 或调用 Animator 攻击状态。
如果动画切段明显过早或过晚,检查 Durations 是否等于剪辑的实际有效时长,以及 Animator 状态是否开启循环、加速或自动 Transition。此示例只负责输入接招与状态切换,伤害判定应由攻击动画的命中帧另行触发,不能把“按键确认下一段”直接当成命中事件。