7.2 输入映射与多端交互适配

7.2 输入映射与多端交互适配

本节摘要：输入系统的核心是动作抽象——把键位翻译成游戏动词，逻辑只认动词不认设备。输入事件沿场景树分发，界面层先于游戏层消费。手柄键盘触屏各有形态差异，统一之道是动作层收敛加设备特性单独处理。本节讲动作设计、事件流、多设备适配与手感细节。

一款游戏要同时支持键盘、手柄与触屏，最坏的做法是在游戏逻辑里到处判断"现在是什么设备、按的是哪个键"——设备与键位的组合爆炸会淹死代码。输入映射的存在就是为了消灭这层爆炸：项目设置里定义动作（跳跃、攻击、暂停），每个动作绑定若干设备输入；逻辑代码只写动作名。设备与键位的变化被压缩在一张映射表里，代码零改动。

动作设计：给游戏动词命名

动作命名是输入层的第一份设计文档。命名的质量标准是语义完整——读代码的人不需要注释就懂这行输入在问什么。

# 动作查询的三种时态，各有用途
func _physics_process(delta: float) -> void:
    var axis := Input.get_axis(&"move_left", &"move_right")     # 连续量：移动
    if Input.is_action_just_pressed(&"dig"):                    # 瞬时按下：触发型动作
        try_dig()
    if Input.is_action_pressed(&"sprint"):                      # 持续按住：状态型动作
        velocity.x *= 1.4
​

三个查询接口对应三种时态，选错时态是输入 bug 的高发区：该用"瞬时按下"的地方用了"按住"，长按键位就成了连发；该用"按住"的用了"瞬时"，按住不放的效果每帧重启。记忆口诀：触发用瞬时、状态用持续、模拟量用轴。

动作表设计还有两条实战经验。其一，预留"修饰"动作：冲刺、瞄准这类与移动并存的第二功能单独设动作，别复用组合键判断。其二，死区与灵敏度在动作层配：摇杆漂移（不碰也输出微小偏移）靠死区参数过滤，动作层配置对全游戏生效，不必每个用轴的地方各写一遍。

事件流：输入怎么走到你的代码

理解分发路径才能解释"为什么界面打开时游戏还在动"。输入事件从根视口出发，沿场景树自顶向下传播：先问界面层（当前持有焦点的控件要不要消费），没人消费再交给节点的输入回调，最后落到默认处理。每一步都可以"消费"事件，截断后续传播。

# 暂停菜单打开时截断游戏输入：消费的艺术
func _unhandled_input(event: InputEvent) -> void:
    if event.is_action_pressed(&"pause"):
        set_paused(true)
        get_viewport().set_input_as_handled()     # 截断：没人再收到这次按键
​

回放一次经典翻车：按暂停键，菜单弹出了，但游戏角色同时跳了一下。原因是暂停处理写在默认输入层，按键穿透到了游戏逻辑。修法正是上例的分发控制——该拦截的层要明确消费。三档回调按接收顺序排：界面优先输入（焦点控件）、节点输入回调、未处理输入（兜底）。游戏逻辑通常写在最后一档，界面写在第一档，天然错层不打架。

手柄、键盘与触屏的统一与差异

动作层把三类设备收敛到同一组动词，但差异终究存在，需要单独料理的部分有清单可循。

手柄：震动反馈（特定事件触发强度与时长）、按键提示图（界面上显示的按键图标按当前设备切换）、连接状态（手柄拔出时暂停并提示）。按键提示切换是"手柄支持"的门面——界面还在显示键位提示而玩家握着手柄，体验立即打折。

键盘：全键位可改（重映射界面几乎必备）、冲突检测（两个动作绑了同一个键）、焦点导航（方向键在控件间移动焦点）。

触屏：虚拟摇杆与按钮（本质是输出动作的控件，自制或用社区控件）、多点触控（摇杆加跳跃同时按）、界面放大（触屏点击的命中区比鼠标大，控件最小尺寸要抬）。

# 检测最后使用的设备，切换按键提示风格
func _ready() -> void:
    Input.joy_connection_changed.connect(_on_joy_changed)
    Input.set_use_accumulated_input(true)

func _input(event: InputEvent) -> void:
    if event is InputEventJoypadButton or event is InputEventJoypadMotion:
        %HintLayer.show_gamepad_hints()
    elif event is InputEventKey or event is InputEventMouseMotion:
        %HintLayer.show_keyboard_hints()
​

⚠️ 常见坑：物理键位与映射键位混淆。手柄的"映射键位"（南西北东按功能命名）跨厂商稳定，"物理键位"（零一二三按位置编号）只在特定布局下稳定。用映射键位写逻辑，跨设备才不出错——不同厂商手柄的键面排布并不相同。

手感细节：输入层的三处打磨

输入手感的最后一厘米有三处低成本打磨。输入缓冲：跳跃键在落地前一刻按下，落地瞬间自动补跳——把"差一帧没按到"的挫败感变成"响应真快"。土狼时间（5.3 已实践）与缓冲是同一思想的两个方向。连按与长按的区分：攻击轻按轻击、长按重击，用计时器量按压时长再分派动作。三处的共同本质：输入系统与游戏逻辑之间多一层"意图解释"，把玩家的笨拙翻译成角色的敏捷。

# 跳跃缓冲：早按的键存一百二十毫秒
var _jump_buffer := 0.0

func _physics_process(delta: float) -> void:
    if Input.is_action_just_pressed(&"jump"):
        _jump_buffer = 0.12
    _jump_buffer = maxf(_jump_buffer - delta, 0.0)

    if is_on_floor() and _jump_buffer > 0.0:
        velocity.y = JUMP_VELOCITY
        _jump_buffer = 0.0
​

图 1 输入事件的分发路径

本节要点回顾

• 动作抽象是翻译层：逻辑只认游戏动词，设备与键位的组合爆炸压进一张映射表
• 三种时态三个接口：触发用瞬时、状态用持续、模拟量用轴；选错时态是输入 bug 高发区
• 事件自顶向下流：界面先答话、游戏兜底；该拦截的层要明确消费
• 多设备料理清单：手柄管提示与震动、键盘管重映射与冲突、触屏管虚拟控件与命中区
• 映射键位写逻辑：跨厂商稳定；物理键位只用于特殊布局需求
• 意图解释层：缓冲、宽限、按压时长分派——把玩家笨拙翻译成角色敏捷

界面与输入两个维度都收口了。第 8 章进入感官与数据的纵深：动画、音频与资源管线。