手柄无法响应或按键错乱需依次排查系统识别、云原神启用手柄、蓝牙配对、START平台替代及USB键位映射。先确认设备被电视系统识别，再在云原神设置中开启本地手柄输入，无线手柄须完成系统级蓝牙配对，兼容性差时可用START平台，按键错乱可借助第三方工具强制映射。
如果您已安装云原神TV版，但手柄无法响应或按键错乱，则可能是由于系统未识别设备、未启用输入通道或键位映射缺失所致。以下是解决此问题的步骤：
一、确认手柄物理连接与系统识别
该步骤旨在验证手柄是否已被电视或电视盒子操作系统底层识别，这是云原神调用外设的前提。若系统未识别，后续所有操作均无效。
1、将手柄通过USB数据线插入电视或电视盒子的USB接口（有线模式）；或按住手柄配对键3秒以上直至指示灯快闪（蓝牙模式）。
2、进入电视/盒子“设置→设备管理”或“蓝牙与外部设备”，查看是否存在新接入设备。若未显示，尝试更换USB接口或重启设备。
3、对于支持ADB调试的安卓TV系统，可使用Adb Shell input devices命令确认设备ID是否列出，含“gamepad”或“joystick”字样即表示已被内核识别。
二、在云原神TV客户端内启用手柄支持
云原神TV版默认可能禁用手柄输入通道，需手动开启以允许信号透传至云端渲染进程。
1、启动云原神TV应用，完成登录并进入游戏大厅界面。
2、点击右上角头像旁的齿轮图标，进入“设置中心”。
3、在“控制设置”或“外设选项”中，找到“启用本地手柄输入”开关，将其切换为开启状态。
4、关闭设置窗口，返回主界面后重新进入游戏，观察手柄是否响应。
三、执行系统级蓝牙配对（适用于无线手柄）
部分非Xbox标准协议手柄（如国产通用手柄、Suileyoo等）需先完成系统级蓝牙配对，云原神方可获取原始输入事件。
1、确保电视或机顶盒蓝牙功能已开启：进入“设置→蓝牙”，确认状态为“已打开”。
2、按A键+HOME键组合（安卓设备通用配对方式），使手柄进入蓝牙配对模式，指示灯呈快速蓝色闪烁。
3、在电视蓝牙设备列表中搜索并选择手柄名称（如“Suileyoo游戏手柄”“Wireless Controller”），点击连接。
4、配对成功后，指示灯转为蓝色常亮，此时可在云原神中测试方向键与确认键是否生效。
四、使用START云游戏平台替代方案
若云原神TV版对手柄兼容性不佳，可通过START云游戏平台间接运行原神，该平台对主流手柄具备更完善的驱动支持。
1、在电视应用商店中搜索并安装START云游戏应用。
2、打开START应用，使用微信扫码登录同一账号，进入游戏库。
3、找到《原神》条目，点击“运行”，等待云端实例加载完成。
4、加载成功后，手柄若已系统级连接，将自动映射为标准Xbox布局，无需额外配置。
五、USB有线直连+键位强制映射（进阶适配）
针对按键错乱或部分按键无响应的情况，可绕过系统默认映射，通过第三方工具实现底层键位重定义。
1、在安卓TV盒子上安装支持USB手柄映射的工具应用（如“USB Gamepad Tool”或“Gamepad Tester”）。
2、运行工具，选择已接入的手柄设备，进入“按键映射”界面。
3、将手柄物理按键逐一映射至标准Android游戏键：A→KEYCODE_BUTTON_A，B→KEYCODE_BUTTON_B，X→KEYCODE_BUTTON_X，Y→KEYCODE_BUTTON_Y，L1→KEYCODE_BUTTON_L1，R1→KEYCODE_BUTTON_R1。
4、保存配置文件为gamepad_config.json，并放置于应用指定路径（如/data/data/com.xxx.gamepadtool/files/）。
