Fritchii 手柄与输入配置完全手册:键盘、手柄映射与按键解决技巧
Fritchii 手柄与输入配置完全手册:键盘、手柄映射与按键解决技巧
Fritchii(Lichii 系 Switch 模拟器)的手柄与输入配置是新手最常卡住的环节:手柄识别不到、摇杆漂移、按键按了没反应,都可以通过本文的映射与校准技巧一次解决。下面这份 Fritchii 手柄输入配置指南,从默认设置、按键映射、摇杆校准到 Profile 保存,带你快速搞定全部输入问题。
认识 Fritchii 的手柄输入系统
Fritchii 的输入层由 src/common/input.h 定义,它把输入划分为多种类型(见 InputType 枚举):
| 输入类型 | 说明 | 典型用途 |
|---|---|---|
Button |
数字按键 | A/B/X/Y、方向键 |
Stick / Analog |
摇杆 / 模拟量 | 移动、视角 |
Trigger |
模拟扳机 | 油门、变焦 |
Motion |
陀螺仪 / 加速度计 | 体感瞄准 |
Touch |
触摸屏 | 触屏点击 |
Nfc |
近距离通信 | 读取 Amiibo |
好消息是:绝大多数手柄(Xbox、PlayStation、Switch Pro、Steam 虚拟手柄)即插即用,默认就能用。只有识别异常时才需要下面的手动映射。
最快配置手柄的步骤:Emulation > Configure > Input
官方快速上手流程(见 docs/user/QuickStart.md)中,输入设置只需三步:
- 打开 Emulation > Configure > Input(或 Controls)面板;
- 为 Player 1(及需要的 Player 2~10)逐项点击控件,按下你想要绑定的按键或摇杆;
- 点击 OK 保存,启动游戏验证。
💡 小技巧:配置界面里每个玩家最多对应一套输入方案,Fritchii 支持最多 10 名玩家(players 配置 中定义了 10 个
PlayerInput),联机游戏前记得给每个座位都配置好。
键盘按键映射技巧
只用键盘时,建议遵循以下惯例:
- 左摇杆 → WASD,右摇杆 → 鼠标或 IJKL;
- A/B/X/Y → 空格 / 回车 / 数字键 1 / 数字键 2 等顺手键位;
- 扳机键(L/ZL、R/ZR) 尽量选有独立扫描码的键(如 Shift、Ctrl 或 F1~F12),避免与普通字母键冲突;
- 方向键 → 上/下/左/右,菜单确认用 A 键映射。
映射完成后建议保存一份 Profile(见下文),之后切回键盘或换人游玩都能一键切换。
摇杆漂移与死区校准:最关键的 4 个参数
摇杆“自己乱动”(漂移)是手柄最常见的毛病。Fritchii 在 AnalogProperties 结构 中为每个模拟轴提供了 4 个核心校准参数:
| 参数 | 作用 | 建议 |
|---|---|---|
deadzone(死区) |
低于该值视为零,可抵消微小漂移 | 从默认值起步,漂移明显时调到 0.1~0.2 |
range(范围) |
高于该值视为最大,可放大/缩小行程 | 按键“按不满”时调小 |
offset(偏移) |
对原始数据做零点校正 | 摇杆不回中时微调 |
inverted(反向) |
反转传感器方向 | 方向反了才启用 |
🛠 排查口诀:先加大 deadzone 治漂移,再调 range 治行程不足,最后用 offset 修偏移。如果校准后依旧异常,可能是手柄硬件问题,可先用手柄校准工具检测硬件本身。
按键行为进阶:反向、自锁与连发
Fritchii 的按键状态 ButtonStatus 结构 支持三种进阶行为,在输入配置面板中勾选即可:
- inverted(反向):把“按下”解释为“松开”,适合特殊外设;
- toggle(自锁):按一次触发、再按一次释放,适合用无长按能力的外设模拟持续按压(如“持续按住 L 冲刺”);
- turbo(连发):按住时自动快速重复触发,适合需要连点的游戏。
摇杆类输入同样支持 toggle,可以把摇杆当开关按钮使用。
保存手柄 Profile 并按游戏切换
想长期复用一套映射时,按 docs/user/Controllers.md 的步骤创建 Profile:
- 启动 Fritchii,进入 Emulation > Configure...;
- 在左侧菜单选择 Controls,完成你的映射配置;
- 点击 New,输入 Profile 名称并 OK 保存。
再针对特定游戏切换 Profile(Setting Controller Profiles By Game):
- 在主窗口右键游戏 → Properties;
- 打开 Input Profiles 选项卡,为玩家选择指定 Profile;
- OK 应用,之后该游戏会无视全局设置,始终使用这套映射。
⚠️ 注意:选项卡较多时窗口可能需要拉宽或用箭头翻页才能看到 Input Profiles。
Steam Deck:外接手柄与陀螺仪体感
在 Steam Deck 上使用外接手柄有专门的技巧(见 docs/user/Controllers.md):
- 桌面模式下优先使用 Steam Virtual Gamepad 0 作为 Player 1,多个外接手柄时 Player 2 用 Steam Virtual Gamepad 1;
- 从睡眠唤醒时,先开外接手柄、不要碰 Deck 本体按键,让外接手柄抢占 0 号位;
- 想启用陀螺仪体感(如《塞尔达传说:旷野之息》长按 R 触发器体感瞄准),需参考 docs/user/GyroControls.md:通过 SteamDeckGyroDSU 安装陀螺仪驱动,然后编辑
/home/deck/.config/Eden下的qt-config.ini,将player_0_motionleft指向motion:0的 cemuhookudp 引擎条目。
常见按键问题排查清单
| 现象 | 可能原因 | 解决方法 |
|---|---|---|
| 手柄完全没反应 | 未被识别为 0 号位 / 被系统独占 | 重新插拔、按上文调整 Deck 手柄顺序 |
| 摇杆自动漂移 | 硬件漂移或死区不足 | 加大 deadzone,必要时用校准工具修硬件 |
| 按键按了没反应 | 与其他快捷键冲突 | 改用独立键位;删除快捷键需右键该快捷键(见 Settings.md) |
| 方向反了 | 传感器方向问题 | 勾选 inverted |
| 扳机行程不满 | range 偏大 |
调小 range |
| 换游戏后配置丢失 | 未绑定游戏 Profile | 用“按游戏设置 Profile”绑定 |
总结
- 默认映射已能覆盖 90% 的手柄,优先使用 Emulation > Configure > Input 完成绑定;
- 摇杆问题重点调 deadzone / range / offset 三件套(src/common/input.h);
- 需要长期复用或分游戏配置时,保存 Controller Profile 并按游戏绑定;
- Steam Deck 用户记得优先抢占 Steam Virtual Gamepad 0 号位,体感功能需额外配置陀螺仪。
更多输入相关主题可参考官方手册目录 docs/user/README.md,包括 使用 Amiibo(依赖手柄 NFC)与 多玩家联机。
