HandheldCompanion 完整指南：一台掌机玩遍 PC、Steam 与模拟器的免费配置方案

【免费下载链接】HandheldCompanionA touch optimized GUI to increase your handheld gaming computer experience.项目地址: https://gitcode.com/gh_mirrors/ha/HandheldCompanion

手握 ROG Ally、Steam Deck 或 AYANEO，本想打开游戏就能畅玩，结果常常遭遇这样的尴尬：Steam 上摇杆一切正常，换到 Epic 启动器却完全没反应；玩《地平线》想用体感瞄准，游戏却只认 Xbox 手柄；开个模拟器，又要去找一套 Cemuhook 配置。HandheldCompanion正是为解决这类"手柄兼容性碎片化"而生的免费开源工具——它把虚拟手柄模拟、陀螺仪运动控制、TDP 调校和快捷覆盖层整合进一个为触屏优化的界面，堪称掌机游戏体验的"万能翻译器"。

为什么掌机玩 PC 游戏总差一口气？

问题并不出在硬件上，而是出在"游戏各说各话"上。主流 PC 游戏默认只认 XInput（Xbox 手柄协议）；Steam 原生对 DualShock 4 支持最好；老派模拟器则偏爱 DirectInput 或专门的 UDP 体感协议。你的掌机内置控制器只有一套输入信号，却要面对三种以上"语言"的游戏，自然处处碰壁。

打个比方：这就像你只会讲中文，却要在三个分别只说英语、日语、法语的服务窗口办业务——办不办得成，全看有没有人帮你翻译。

HandheldCompanion 要做的，就是当好这个翻译。它通过ViGEmBus 虚拟驱动在系统里"伪造"出标准的手柄设备，再把你掌机上的真实按键映射过去。游戏以为是 Xbox 360 手柄插了进来，自然言听计从。

上表（项目根目录的 FAQ.png）是官方给出的选择逻辑：现代 PC 游戏优先虚拟 Xbox 360 手柄，Steam 游戏改用虚拟 DualShock 4，模拟器场景则按协议需求两者皆可。记住这条主线，后面配置时就不会晕。

HandheldCompanion 到底能帮你做什么？

虚拟手柄：把输入"翻译"成游戏听得懂的语言

项目在Controllers/目录里定义了统一的控制器抽象层，物理手柄、虚拟手柄都实现同一套接口。核心的按键和轴映射写在IController基类中，所有下游设备共用一份标准：

protected readonly List<ButtonFlags> TargetButtons = [ ButtonFlags.B1, ButtonFlags.B2, ButtonFlags.B3, ButtonFlags.B4, ButtonFlags.DPadUp, ButtonFlags.DPadDown, ButtonFlags.DPadLeft, ButtonFlags.DPadRight, ButtonFlags.Start, ButtonFlags.Back, ButtonFlags.Special, ButtonFlags.L1, ButtonFlags.R1, ButtonFlags.LeftStickClick, ButtonFlags.RightStickClick, ];

这段代码的作用是声明一套"所有手柄都应该具备的通用按键表"，让不同设备的按键能映射到同一个目标上。基于这套设计，Xbox 360 与 DualShock 4 两种虚拟控制器可以按场景随意切换，甚至在 PS Remote Play 里连触摸板都能模拟出来。

陀螺仪运动控制：让掌机拥有"Switch 式"体感

运动控制是项目最亮眼的功能。它读取设备内置的 IMU（惯性测量单元，包含陀螺仪和加速度计），把晃动数据换算成摇杆移动，让你在赛车、FPS 和第三人称游戏里都能体感瞄准或转向。支持的传感器包括 Bosch BMI160 以及常见的 USB IMU（GY-USB002）。

GamepadMotion类负责这部分数据处理，内置多种校准模式与滤波算法，摇杆死区、灵敏度曲线都可逐项微调。更贴心的是，陀螺仪输出还能通过 UDP 协议转发给 Dolphin、Cemu 这类模拟器，让 Wii、Wii U 和 Switch 游戏的体感操作在掌机上一并复活。

QuickTools 覆盖层：游戏内一键调校

不用退出游戏，按下设定好的组合键就能呼出快捷面板：TDP 功耗、屏幕刷新率、分辨率、亮度、音量、电池状态，统统在手边。部分设备还支持 OEM 特殊按键直达，窗口位置也能左右或悬浮摆放，非常符合掌机"随时随地拿起就玩"的调性。

设备覆盖：主流掌机几乎一网打尽

项目在Devices/目录下按品牌组织了各自的驱动实现，下面只是部分清单：

新手上路：5 步完成安装与首次配置

整个流程比想象中简单，跟着走一遍大约十分钟：

1. 准备驱动环境：安装 ViGEmBus 虚拟总线驱动和 HidHide 隐藏过滤器驱动，这是虚拟手柄能否工作的根基。
2. 以管理员身份安装：下载项目发布页的整合安装包，右键"以管理员身份运行"，一路下一步即可。需要管理员权限是因为要注册内核级驱动。
3. 选定目标控制器：按前文速查表，为你的主力游戏场景选好默认虚拟手柄（Xbox 360 或 DualShock 4）。
4. 建立游戏专属配置：在"Profiles"里新增配置，关联到具体的游戏可执行文件，之后每次启动游戏，HandheldCompanion 会自动套用对应的映射方案。
5. 调校陀螺仪与死区：运行传感器校准，按手感调整摇杆死区、触发阈值和灵敏度曲线，保存即可。

建议：第一次配置前先创建系统还原点。虽然安装程序很成熟，但驱动级操作多一份保险总是好的。

开发者在意的延伸

对想改源码的开发者，仓库结构非常清晰：Controllers/放控制器抽象与虚拟设备，Devices/按品牌存放硬件适配，Sensors/是 IMU 相关实现，Managers/则统一管理设置、配置、控制器等模块。克隆命令：

git clone https://gitcode.com/gh_mirrors/ha/HandheldCompanion

陀螺仪失灵、手柄不识别？3 个高频问题的自查清单

• 设备没被识别：先在 Windows 设备管理器确认手柄是否正常枚举；再检查 HidHide 是否把设备"藏"了起来，必要时在它的界面里勾选显示；最后在 HandheldCompanion 里手动刷新设备列表。
• 运动控制没反应：确认机型在支持列表内，且传感器驱动已就绪；跑一遍校准工具；再检查 Universal Motion Control（UMC）开关是否打开，以及当前游戏配置是否应用了陀螺仪映射。
• 虚拟手柄冲突：先关闭 Steam 输入、DS4Windows 等同类模拟软件，再检查 ViGEmBus 驱动服务是否在运行，最后重启应用让虚拟设备重新注册。

写在最后

HandheldCompanion 的价值在于：它把"兼容性碎片化"这个掌机玩家绕不开的难题，收敛成了几分钟的图形化配置。虚拟手柄让每个游戏都认识你，陀螺仪让体感不再是 Switch 专属，QuickTools 让功耗与屏幕调校随叫随到。更重要的是，它是免费开源项目，社区持续在为新型号设备补充适配。

想立刻体验？去仓库下载最新安装包，或者直接 clone 源码参与贡献。如果它解决了你的痛点，不妨给项目点个 Star，也欢迎把使用中遇到的问题反馈给社区——你的设备信息，很可能就是下一款新机型适配的关键。🎮

【免费下载链接】HandheldCompanionA touch optimized GUI to increase your handheld gaming computer experience.项目地址: https://gitcode.com/gh_mirrors/ha/HandheldCompanion