手柄无法操作鲸云漫游时，需依次完成配对识别、启用输入开关、配置键位映射、校准延迟及处理兼容异常：先确保手柄被系统识别为HID设备，再在App内开启“启用手柄输入”，借助GameKeyboard等工具映射按键，调低摇杆死区并验证响应，最后通过ADB或XOutput解决协议兼容问题。
如果您在使用鲸云漫游时无法通过手柄进行操作，可能是由于手柄未正确连接或未启用映射功能。以下是开启手柄操控的具体操作路径与配置方法：
一、确认手柄已成功配对并被系统识别
鲸云漫游依赖系统级手柄支持，需确保设备底层已将手柄识别为标准HID输入设备。部分蓝牙手柄需进入特定配对模式才能被安卓系统正确枚举。
1、长按手柄上的电源键与X键（或A键+Mode键）约5秒，直至指示灯快速闪烁，进入配对模式。
2、进入手机“设置→蓝牙”，开启蓝牙并搜索新设备，选择对应手柄名称完成配对。
3、配对成功后，返回桌面，打开“设置→辅助功能→物理键盘与游戏控制器”，查看是否列出已连接的手柄设备。
4、若未显示，请尝试重启手机或更换USB-C转接器（如有线连接），部分杂牌手柄需开启XInput模拟模式才可被识别。
二、在鲸云漫游内启用手柄控制开关
鲸云漫游默认可能关闭手柄输入通道，需手动激活该功能以允许按键事件透传至远程画面。
1、启动鲸云漫游App，登录账号并进入主界面。
2、点击右上角“个人中心”图标，进入“设置中心”。
3、向下滚动找到“操控设置”分类，点击进入。
4、开启“启用手柄输入”开关，此选项必须开启，否则所有手柄按键均无响应。
5、若开关为灰色不可用状态，请先检查系统是否授予“无障碍服务”权限。
三、配置手柄键位映射关系
鲸云漫游本身不提供内置映射编辑器，需借助第三方映射工具桥接手柄信号与触控指令。推荐使用兼容性稳定的GameKeyboard或Octopus Engine进行中转。
1、前往应用商店下载安装“GameKeyboard Pro”（非小米商店蓝色官方版，需选绿色图标定制版）。
2、安装后首次启动，点击“跳过教程”，进入主界面后立即点击右下角“⚙️设置”。
使用 gh project CLI 管理 GitHub Projects v2。在代理需要列出待办事项、设置项目字段（如状态、迭代、优先级等）时使用此技能。
3、依次开启“启用悬浮窗”“允许显示在其他应用上方”“允许修改系统设置”三项权限。
4、返回主界面，点击“添加新配置”，选择“鲸云漫游”作为目标应用。
5、进入映射编辑页，长按屏幕任意位置呼出虚拟按键面板，拖动L1/R1等按键图标至屏幕对应区域，建议将左摇杆映射为方向键，A键映射为屏幕中心点击。
6、全部配置完成后点击右上角“✓保存”，返回鲸云漫游并启动云游戏实例。
四、验证手柄响应与校准延迟
映射生效后仍可能出现按键失灵或响应滞后，需排除信号干扰与帧同步问题。
1、在鲸云漫游游戏运行中，同时按下手柄的Start键与Select键（或菜单键+Back键），调出实时状态浮层。
2、观察浮层中“输入延迟(ms)”数值，若持续高于80ms，需切换至5GHz Wi-Fi频段或关闭后台视频流应用。
3、进入“设置→操控设置→手柄灵敏度”，将摇杆死区调低至15%，提升微操响应精度。
4、测试ABXY键是否触发对应触控动作：轻点A键应模拟一次短按，长按2秒应触发长按事件，若仅部分按键生效，说明映射未覆盖全部HID报告描述符。
五、处理常见兼容性异常
部分手柄型号存在协议解析缺陷，导致鲸云漫游无法完整读取按键状态，需采用绕过式方案强制注入。
1、卸载当前手柄驱动，通过ADB命令重置输入设备：adb shell su -c "echo 1 > /sys/bus/hid/drivers/hid-generic/unbind"
2、重新插入手柄，执行“adb shell getevent -l | grep -i joystick”，确认输出中包含BTN_A、ABS_X等事件字段。
3、若仅显示“EV_MSC”无按键事件，需启用XOutput虚拟设备桥接：下载XOutput.exe，加载预设配置“Xbox360_for_WhaleCloud.xml”，勾选“独占原设备”。
4、启动XOutput后，在鲸云漫游设置中将手柄类型手动指定为“Xbox Controller”，此操作可绕过安卓原生hid-sony/hid-logitech等驱动限制。
