企业官网建设流程全解析

RetroArch Android TV 控制器配置指南：3 步搞定手柄不识别与按键映射

【免费下载链接】RetroArchCross-platform, sophisticated frontend for the libretro API. Licensed GPLv3.项目地址: https://gitcode.com/GitHub_Trending/re/RetroArch

手柄刚插到 Android TV 的 USB 口，RetroArch 的菜单却纹丝不动，连遥控器都像"失灵"了。先别怀疑硬件——十有八九只是 RetroArch 这一层的控制器配置没调对。往下读，你会走通 Android TV 上控制器配置的最短路径：设备被认出、按键绑对位、设置永久生效。

30 秒看懂原理：你的按键卡在哪一层

一次按键从指尖到画面要经过三棒接力：

• Android TV 系统：负责"收件"的快递员，把手柄或遥控器的按键变成系统信号；
• RetroArch 输入层：负责"派单"的调度员，决定这条信号交给谁、触发什么动作——绝大多数配置问题出在这一棒；
• 模拟器（运行具体游戏的核心程序）：负责"跑腿"的跑单员，只管执行动作。

判断方法很简单：在 Android 系统设置里按一下遥控器确认键或手柄任意键，系统有反应而进 RetroArch 后没反应，就能排除系统层——问题出在"调度员"这棒，本文接下来的步骤都是在这一层解决。

首次配置三步走：从不识别到正常

第一步：让 RetroArch 认出控制器

关键在确认输入通道。Android TV 上，输入与手柄驱动都应指向 android 驱动——"驱动"在这里相当于 RetroArch 和系统硬件之间的"翻译官"。在配置文件里加上：

input_driver = "android" input_joypad_driver = "android" input_autodetect_enable = "true"

前两行..._driver这一行控制"用哪个翻译官读设备"，在 Android 上必须都设为 android；input_autodetect_enable控制插上手柄时是否自动匹配一份现成映射，设为 true 后，大部分"手柄不识别"就在这一步解决了。

第二步：把按键绑对

开了自动识别后多数手柄直接可用；若出现按键映射错乱（A 键变 B 键、摇杆失灵），进 RetroArch 的"设置 → 输入 → 绑定"，按确认键重绑全部按键，或直接套一次 RetroPad 标准映射。想手动固定某个设备时，只有这一行要紧：

input_player1_joypad_index = "0"

这一行控制"玩家 1 用哪个物理设备"，设成 0 就是第一注册的设备（Android TV 上常常是遥控器）；想改用蓝牙手柄当主力，就改成列表里手柄对应的编号。

平台跳跃游戏里摇杆走不动，是另一个高频问题，补一行：

input_analog_dpad_mode = "1"

这一行控制"是否让摇杆模拟十字键"，设成 1 之后左摇杆输入能驱动方向移动，只认十字键的游戏就会重新"听"摇杆的话了。

第三步：把配置存下来

改完别急着关机，config_save_on_exit控制程序退出时是否自动把设置写回配置文件，设为 true，RetroArch 退出即自动存档，下次开机不会打回原形。

想逐条翻查输入系统的完整实现，可以进源码目录 input/；偏好官方手册的，可以查看 docs/retroarch.6。

按场景选配置：单人、遥控器还是双人

三种典型用法对应的关键参数如下，每格只给"哪个设备 + 哪一两个参数"，照抄即可：

补两句：遥控器的方向键在系统里通常以 hat（方向帽）形式注册，直接绑方向键就行；双人同屏前，两只手柄都要先在系统里注册成功，RetroArch 才会给它们各自分配编号，否则第二人会"抢"玩家的键。

控制器配置高频卡点速查

以下六条按"现象 → 原因 → 一招解决"整理，都是 Android TV 上最常踩的：

• 手柄插了没反应→ 驱动没设为 android 或接触不良。解决：确认input_joypad_driver = "android"，重新插拔。
• A/B 键对调→ 旧自动映射文件与新设备冲突。解决：到绑定菜单重选 RetroPad 标准映射覆盖。
• 平台游戏摇杆失灵→ 核心只认十字键。解决：设input_analog_dpad_mode = "1"。
• 输入延迟明显→ 蓝牙干扰或系统省电模式限制了轮询。解决：换 USB 接收器或有线连接，并关掉手柄省电模式。
• 双人开启后 2P 按键触发 1P 动作→ 两人指向同一设备编号。解决：把input_player2_joypad_index改成 2P 手柄的编号。
• 重启后设置全丢→ 没写回磁盘。解决：设config_save_on_exit = "true"后正常退出一次。

离场前记住这一件事

别用删除 retroarch.cfg 的方式"重置"——所有映射会一起丢，重建要花很长时间；真要重置，先把文件复制一份留着。以后每接入一只新控制器，花 30 秒确认它被识别、A/B/X/Y 绑对了位置，这套控制器配置就会一直稳下去。

【免费下载链接】RetroArchCross-platform, sophisticated frontend for the libretro API. Licensed GPLv3.项目地址: https://gitcode.com/GitHub_Trending/re/RetroArch