游戏客户端架构 / 系统课时

Unity的新旧输入模型怎么隔离

Unity的新旧输入模型怎么隔离

当 Unity 项目同时存在旧版 Input Manager 和新版 Input System 时,直接在角色脚本中调用两套 API 会增加迁移成本。本课通过统一输入接口和适配器,把设备读取与玩法逻辑分开,使角色代码不必关心输入来自哪个系统。

学习目标

  • 理解 Unity 新旧输入模型的差异及迁移边界。
  • 使用统一接口封装移动与跳跃输入。
  • 验证切换输入实现后玩法代码无需修改。

新旧输入模型的差异

Unity 旧版输入模型主要通过 UnityEngine.Input 读取按键和轴值,例如 Input.GetAxisRaw()、Input.GetButtonDown()。它适合维护已有项目,但输入设备和映射配置与玩法代码容易形成直接依赖。

新版 Input System 使用 InputAction 描述游戏动作,并支持设备绑定、输入处理器、触发条件和运行时重绑定。它更适合多设备和需要灵活配置的项目。

关注点 旧版 Input Manager 新版 Input System
输入读取 轮询 Input API Action 读取或事件回调
按键映射 Input Manager 配置 Input Action 绑定
设备扩展 通常需要额外适配 支持多种设备与控制方案
迁移风险 玩法直接依赖旧 API 玩法可能直接依赖 InputAction

两个系统的 API 不同,但游戏真正需要的通常只是移动向量、跳跃请求等语义信息。因此,隔离的核心不是把旧 API 改名,而是建立稳定的玩法输入契约。

通过接口隔离设备与玩法

设计一个 IGameInput 接口,向角色提供两个能力:获取二维移动向量,以及判断当前帧是否触发跳跃。

Unity 新旧输入模型通过适配器连接统一玩法接口的架构图

接口只描述输入结果,不包含 InputAction、KeyCode 或其他 Unity 输入实现细节。这样既能替换底层设备,也方便在自动化测试中注入模拟输入。

下面的示例使用两个适配组件和一个角色组件。为便于直接理解,采用统一轮询方式;生产项目也可以在适配层把事件回调转换为输入状态。

实现旧版与新版适配器

首先建立 IGameInput.cs,定义玩法所需的最小接口。

csharp
using UnityEngine;

public interface IGameInput
{
    Vector2 Move { get; }
    bool JumpPressed { get; }
}

旧版实现读取 Input Manager 中的 Horizontal、Vertical 和 Jump。新建 LegacyInputAdapter.cs:

csharp
using UnityEngine;

public class LegacyInputAdapter : MonoBehaviour, IGameInput
{
    public Vector2 Move => new Vector2(
        Input.GetAxisRaw("Horizontal"),
        Input.GetAxisRaw("Vertical")
    );

    // GetButtonDown 只在按下的首帧返回 true。
    public bool JumpPressed => Input.GetButtonDown("Jump");
}

这个实现依赖旧版 Input Manager 中存在对应映射。使用 Unity 默认输入配置的项目通常已经包含这些名称;如果映射被删除,需要重新配置。

新版实现通过 InputAction 创建相同的动作语义。新建 ModernInputAdapter.cs,示例使用 WASD、方向键和空格键。

csharp
using UnityEngine;
using UnityEngine.InputSystem;

public class ModernInputAdapter : MonoBehaviour, IGameInput
{
    private InputAction moveAction;
    private InputAction jumpAction;

    public Vector2 Move => moveAction.ReadValue<Vector2>();
    public bool JumpPressed => jumpAction.WasPressedThisFrame();

    private void Awake()
    {
        moveAction = new InputAction("Move", InputActionType.Value);

        // 两组 2DVector 绑定输出统一的二维移动值。
        AddMovementKeys("<Keyboard>/w", "<Keyboard>/s",
            "<Keyboard>/a", "<Keyboard>/d");
        AddMovementKeys("<Keyboard>/upArrow", "<Keyboard>/downArrow",
            "<Keyboard>/leftArrow", "<Keyboard>/rightArrow");

        moveAction.AddBinding("<Gamepad>/leftStick");
        jumpAction = new InputAction("Jump", InputActionType.Button,
            "<Keyboard>/space");
        jumpAction.AddBinding("<Gamepad>/buttonSouth");
    }

    private void AddMovementKeys(string up, string down,
        string left, string right)
    {
        moveAction.AddCompositeBinding("2DVector")
            .With("Up", up)
            .With("Down", down)
            .With("Left", left)
            .With("Right", right);
    }

    private void OnEnable()
    {
        moveAction.Enable();
        jumpAction.Enable();
    }

    private void OnDisable()
    {
        moveAction.Disable();
        jumpAction.Disable();
    }

    private void OnDestroy()
    {
        moveAction.Dispose();
        jumpAction.Dispose();
    }
}

这里使用代码创建 Action,不依赖额外的 Input Actions 资源。对于正式项目,更推荐用 Input Actions Asset 集中管理设备绑定与重绑定配置。

最后,新建 PlayerInputConsumer.cs。角色只访问接口,不调用任意一套输入 API。

csharp
using UnityEngine;

public class PlayerInputConsumer : MonoBehaviour
{
    [SerializeField] private MonoBehaviour inputProvider;
    private IGameInput gameInput;

    private void Awake()
    {
        gameInput = inputProvider as IGameInput;
        if (gameInput == null)
        {
            Debug.LogError("Input provider must implement IGameInput.");
            enabled = false;
        }
    }

    private void Update()
    {
        Vector2 move = gameInput.Move;
        if (move.sqrMagnitude > 0.001f)
            Debug.Log($"Move: {move}");

        // 玩法层处理跳跃意图,不需要知道按键来源。
        if (gameInput.JumpPressed)
            Debug.Log("Jump requested");
    }
}

该组件目前只输出输入意图,不直接改变角色位置。实际项目中可以把输入向量交给角色移动组件,把跳跃请求交给角色状态机。

在 Unity 中切换并验证

新版适配器需要安装 Input System 包。可以在 Window > Package Manager 中查找并安装 Input System,然后在 Edit > Project Settings > Player > Other Settings > Active Input Handling 选择输入后端。

迁移期间可选择 Both,让新旧输入系统同时可用;完成迁移后再考虑仅启用新版。修改后按编辑器提示重启。

具体操作如下:

  1. 创建空的 GameObject,添加 PlayerInputConsumer。
  2. 添加 LegacyInputAdapter,并拖到消费者的 Input Provider 字段。
  3. 进入 Play 模式,按 WASD 或方向键,再按空格键,观察 Console。
  4. 退出 Play 模式,移除或禁用旧适配器,添加 ModernInputAdapter。
  5. 将新的适配器拖入同一个 Input Provider 字段,再次运行并测试。

预期结果:移动时 Console 输出 Move: 开头的二维向量信息,按空格键时输出 Jump requested。具体移动向量与按键持续时间有关,不要求每一帧一致。

整个切换过程不修改 PlayerInputConsumer。这说明玩法层使用的是稳定输入契约,而非具体 API。

迁移时需要避免的隐患

最常见的问题是把旧输入和新输入同时连接到同一个角色,使一次按键产生重复命令。Both 只是允许两套后端运行,并不代表需要让两套适配器同时驱动同一个玩家。

还要注意输入的时间语义。旧版 GetButtonDown() 与新版 WasPressedThisFrame() 都适合按帧检查按下动作,但不能直接假设所有触发器事件具有完全相同的行为。对于长按、连击和蓄力,应在适配层明确区分按下、持续和释放。

另外,本例的接口属于按帧读取模型,消费端应当在 Update() 中读取。若玩法命令由 FixedUpdate 处理,应缓存输入意图,再由固定步长逻辑消费,避免漏掉短暂按键。

真正完成隔离的判断标准是:替换旧版与新版适配器时,输入绑定方式可以改变,但移动、跳跃等玩法组件以及它们的测试不需要随之重写。

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

目录与阅读设置

阅读设置

17

记录一个想法

Unity的新旧输入模型怎么隔离

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

登录哪都通