手柄自动配置 RetroPad 映射和常见品牌的一键识别
RetroPad 映射
RetroArch 使用一种统一的手柄映射叫 RetroPad——不管你插的是 PlayStation 手柄、Xbox 手柄、Switch Pro、还是第三方手柄，RetroArch 都会把它们的按键翻译成 RetroPad 标准：
| RetroPad 按钮 | 物理按钮示例（因手柄而异） |
|---|---|
| A | 确认键 |
| B | 取消键 |
| X / Y | 副功能键 |
| L / R | 肩部按键 |
| L2 / R2 | 扳机 |
| L3 / R3 | 按下摇杆 |
| Start | 开始 |
| Select | 选择 |
| D-Pad 四方向 | 十字键 |
| 左右摇杆 | 模拟摇杆 |
你只需要关心 RetroPad 映射，不用管物理按钮在哪——RetroArch 的自动配置会帮你翻译。
自动配置怎么工作
RetroArch 内置了几百款常见手柄的配置文件，存在 config/controller profiles/ 目录下：
- 当你插入/配对一个新手柄时，RetroArch 读手柄的 USB Vendor ID / Product ID
- 匹配到配置文件 → 自动完成按键映射，手柄立即可用
- 没匹配到 → 需要手动配置一次，之后 RetroArch 会记住
配置文件可以在 Online Updater → Update Controller Profiles 里更新——新手柄出来后社区会添加对应配置。
开启自动配置
Settings → Input → Auto Config → Enable Auto Config：确保开关打开。
Settings → Input → Auto Config → Show Inputs When Auto Configured：打开后手柄自动配置成功时会在屏幕上显示一行提示（"Gamepad #1 configured: Xbox Controller"）。
自动配置了一个手柄后
配置成功后可以做几件事：
- 测试按键：进游戏试玩，看按键手感对不对
- 菜单确认/取消反了？：Settings → Input → Menu Controls → Menu Swap OK & Cancel Buttons——打开后菜单里 A 和 B 的功能互换
- 整体手感不对？：进游戏后 Quick Menu → Controls → 手动改个别按键映射，然后 Save Core Override 或 Save Game Override
多个手柄
RetroArch 支持最多 16 个手柄同时连接（但日常 4 人联机常见）：
- 每个手柄自动独立配置
- Quick Menu → Controls 里可以切换"Player 1 / Player 2 / ..."
- 联机对战时需要两台机器各接一个手柄（或一台机器分屏）
自动配置没匹配上怎么办
症状：插上手柄后按键全乱、或完全没反应。
排查：
- 先确认系统层面能用——Windows 设置里的游戏控制器、macOS 系统设置里的手柄连接、Android 系统设置里已配对
- Online Updater → Update Controller Profiles 更新配置表
- 手动配置：Settings → Input → Player 1 Binds → 逐个按键映射（按一次物理键，RetroArch 就录下它）
- 手动配置完 Save Core Override 或 Save Game Override 保存
触屏设备的虚拟"手柄"
Android / iOS 上没有实体手柄时，RetroArch 会显示触屏覆盖层（Touch Overlay）——屏幕上叠加虚拟按键。这也是一种输入设备，可以改布局、透明度、大小，或在 Quick Menu → Controls → Touchscreen Overlay 里关掉（如果外接了实体手柄）。