游戏引擎 / 系统课时

把输入映射抽成独立层

把输入映射抽成独立层

当角色脚本直接判断 WASD 和空格键时,接入手柄、修改键位或打开菜单都会牵动玩法代码。本课使用 Unity Input System 把设备绑定转换为 Move、Jump 动作,再通过适配器输出统一的玩法意图,让角色控制逻辑不依赖具体按键。

学习目标

  • 区分设备绑定、Input Action 与玩法命令的职责。
  • 让键盘和手柄通过同一套动作驱动角色。
  • 实现可替换的输入来源,并验证按下边沿和组件生命周期。

先划清设备、动作与玩法的边界

输入映射层回答“哪个设备操作触发哪个动作”,玩法层回答“收到动作后做什么”。例如 WASD 和手柄左摇杆都产生二维 Move 值;空格和手柄南侧按钮都表示 Jump。角色脚本不应出现具体设备路径,否则每增加一种输入方案就要修改玩法代码。

设备输入 Input Action 交给玩法的语义
WASD 四向组合、手柄左摇杆 Move:Value / Vector2 移动方向
空格、手柄南侧按钮 Jump:Button 本帧跳跃请求

设备绑定经过动作与适配器到达玩法组件

这样的分层还把“动作是否启用”集中管理:正常游戏启用 Gameplay;进入独占输入的菜单时,由统一的输入上下文管理器停用 Gameplay、启用 UI。动作名与角色状态分离后,后续重绑定只修改 Binding,不必重写移动、攻击或交互逻辑。

配置同一组动作的多种绑定

先在 Package Manager 确认已安装 Input System;项目若提示切换 Active Input Handling,选择 Input System Package 或 Both,并按提示重启编辑器。然后按以下顺序操作:

  1. 在 Project 窗口通过 Assets > Create > Input Actions 创建 GameControls.inputactions,双击打开动作编辑器。
  2. 新建 Gameplay Action Map。添加 Move:Action Type 为 Value,Control Type 为 Vector2;绑定手柄 <Gamepad>/leftStick,再添加 2D Vector Composite,分别绑定 W、S、A、D 到 Up、Down、Left、Right。
  3. 添加 Jump:Action Type 为 Button,分别绑定 <Keyboard>/space 与 <Gamepad>/buttonSouth。保存动作资产。

Action Map 是一组可以统一启停的动作,而不是一个物理设备。一个 Action 可以有多条 Binding,因此本例无需判断当前究竟来自键盘还是手柄。这里先面向单名玩家;本地多人设备配对需使用 PlayerInput 等机制管理各玩家的设备与动作实例。

用适配器提供稳定的玩法接口

下面三个文件组成一个可运行示例。前两个定义玩法接口与 Input System 适配器,第三个只读取语义;单独复制其中一个文件并不能构成完整示例。

PlayerCommandSource.cs:

csharp
using UnityEngine;

public abstract class PlayerCommandSource : MonoBehaviour
{
    // 玩法代码只依赖语义,避免引用具体设备与绑定。
    public abstract Vector2 Move { get; }
    public abstract bool JumpPressed { get; }
}

ActionCommandSource.cs:

csharp
using UnityEngine;
using UnityEngine.InputSystem;

public sealed class ActionCommandSource : PlayerCommandSource
{
    [SerializeField] private InputActionReference move;
    [SerializeField] private InputActionReference jump;

    public override Vector2 Move => move.action.ReadValue<Vector2>();
    public override bool JumpPressed => jump.action.WasPressedThisFrame();

    private void OnEnable()
    {
        // 本例由该适配器独占管理两个 Action 的启停。
        move.action.Enable();
        jump.action.Enable();
    }

    private void OnDisable()
    {
        move.action.Disable();
        jump.action.Disable();
    }
}

InputActionReference 指向动作资产中的具体 Action,不会把设备键名写死在脚本中。连续输入用 ReadValue<Vector2>() 获取当前值;一次性操作用 WasPressedThisFrame() 读取按下边沿,避免按住按钮时每帧都重复触发。

在玩法端消费并验证输入

SimplePlayerMover.cs:

csharp
using UnityEngine;

public sealed class SimplePlayerMover : MonoBehaviour
{
    [SerializeField] private PlayerCommandSource commands;
    [SerializeField, Min(0f)] private float speed = 4f;

    private void Update()
    {
        // 只演示XZ平面移动;碰撞运动可交给CharacterController。
        Vector2 axis = Vector2.ClampMagnitude(commands.Move, 1f);
        Vector3 direction = new Vector3(axis.x, 0f, axis.y);
        transform.position += direction * (speed * Time.deltaTime);

        if (commands.JumpPressed)
            Debug.Log("Jump 请求");
    }
}

在场景中新建一个 Capsule,挂上 ActionCommandSource 和 SimplePlayerMover。把 Gameplay/Move、Gameplay/Jump 拖到适配器的两个引用槽,把适配器拖到移动脚本的 Commands 槽。运行后分别使用 WASD 和手柄左摇杆;两者都应使 Capsule 在 XZ 平面移动。空格或手柄南侧按钮单次按下时,Console 预期输出:

text
Jump 请求

这是可观察的跳跃请求,不是实际物理起跳;真实角色可以把该语义交给跳跃状态机。若需要在 FixedUpdate 执行物理跳跃,应先在 Update 缓存按下事件,避免固定步进遗漏短按。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

把输入映射抽成独立层

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通