QtScrcpy 键鼠映射完整指南3 分钟把手游变成键鼠操作【免费下载链接】QtScrcpyAndroid实时投屏软件此应用程序提供USB(或通过TCP/IP)连接的Android设备的显示和控制。它不需要任何root访问权限项目地址: https://gitcode.com/barry-ran/QtScrcpy晚上窝在沙发手指挤在手机小屏里搓方向、点技能一局打下来手是酸的。而用 QtScrcpy 把手机画面投到电脑后同一局游戏换成了 WASD 加鼠标左键开枪、空格起跳、移动鼠标转视角。QtScrcpy 是一款免费开源的 Android 投屏软件除投屏和基础控制外它的键鼠映射功能可以把 JSON 脚本里定义的键盘、鼠标动作转换成手机上的触摸事件。读完这篇教程你能独立完成一次投屏连接并写出一份能上手的按键映射脚本。能力速览使用场景QtScrcpy 提供的能力把手机画面放大到电脑屏幕支持 USB 或 WiFi 投屏首帧约 1 秒稳定 30~60 fps用键鼠玩手游用 JSON 脚本把按键、鼠标映射为触摸事件规则见 docs/KeyMapDes_zh.md手里不止一台测试机多台设备同时投屏、分组批量控制日常辅助安装 APK拖进视频窗口即可、传文件、录屏、截图最短上手路径 ⏱️从完全没配置过到亲眼看到手机画面出现在电脑窗口预计 5 分钟。开启 USB 调试手机进入设置 → 关于手机连续点击版本号 7 次解锁开发者选项再回到开发者选项打开 USB 调试开关部分机型还要在USB 调试安全设置里允许模拟点击缺少这步会导致后面能看画面却点不动屏幕。把软件放到电脑从仓库 Release 页下载对应平台的免编译压缩包已内置 adb或用git clone https://link.gitcode.com/i/f4620807b84a19057377e20b15293a04自行编译Windows / macOS / Linux 都支持。插上设备验证数据线连接后点刷新设备设备号出现在列表里即说明 adb 识别成功点启动服务约 1 秒后画面出现。改用 WiFi 连接可选手机与电脑同网段时依次点获取设备 IP → 启动 adbd → 无线连接 → 刷新设备选中 IP 地址对应的设备再启动服务之后数据线可以拔掉。核心功能详解键鼠映射怎么工作原理一句话映射脚本是一个 JSON 文件switchKey定义切换键mouseMoveMap定义鼠标移动对应的视角拖动keyMapNodes把每个按键绑定到屏幕上的一个触摸点。所有坐标都是 0~1 的相对值左上角为原点同一份脚本可以通用不同分辨率的手机。脚本统一放在 keymap 目录点界面上的刷新脚本就是重新扫描这个目录。最小可运行示例下面这份脚本只保留跑通映射所需的最少字段存为keymap/myfirst.json即可{ switchKey: Key_QuoteLeft, mouseMoveMap: { startPos: { x: 0.5, y: 0.25 }, speedRatioX: 3.25, speedRatioY: 1.25 }, keyMapNodes: [ { comment: 单点测试, type: KMT_CLICK, key: Key_Space, pos: { x: 0.5, y: 0.5 } } ] }加载方式选中该脚本 → 连接手机 → 启动服务 → 点应用 → 按一次~即脚本里的 switchKey进入映射模式。预期效果脚本加载成功空格会在屏幕中心点出一个触摸鼠标移动开始转视角再按一次~回到普通触控。获取脚本里的精确坐标最省事的办法应用映射后在投屏窗口里用鼠标左键点一下控制台会直接打印该点的相对坐标 pos填进脚本即可。接入真实场景FPS 游戏的完整映射仓库自带的 keymap/gameforpeace.json和平精英是一个完整范本移动、探头、开火、开镜、蹲、趴、换弹共二十多个节点鼠标左键开火、右键开镜。核心片段长这样{ comment: 方向盘, type: KMT_STEER_WHEEL, centerPos: { x: 0.16, y: 0.75 }, leftOffset: 0.1, rightOffset: 0.1, upOffset: 0.27, downOffset: 0.2, leftKey: Key_A, rightKey: Key_D, upKey: Key_W, downKey: Key_S }预期效果centerPos对准游戏里虚拟摇杆中心WASD 分别把摇杆按对应 offset 幅度拖出人物即向该方向移动配合mouseMoveMap转视角操作节奏就接近端游了。几个值得注意的行为启用mouseMoveMap后鼠标指针会被隐藏移动范围受限所有移动都换算成从startPos出发的虚拟手指拖动。开车场景下游戏会创建新界面导致触摸点失效README 建议把载具设置改为单摇杆模式失效时连续按两次切换键可以恢复。不会手写规则的话可用作者配套的 QuickAssistant 工具做界面化编辑入口见 docs/KeyMapDes_zh.md。典型场景实战FPS / 射击类以 gameforpeace.json 为基准操作按键 / 参数对应类型作用转视角鼠标移动mouseMoveMap从 startPos 拖动手指转视角开火 / 开镜鼠标左键 / 右键KMT_CLICK绑定到开火键、准星位移动WASDKMT_STEER_WHEEL拖动虚拟摇杆跳 / 换弹空格 / RKMT_CLICK单键单点探头Q / EKMT_CLICK_TWICE按下松开模拟双击蹲 / 趴C / ZKMT_CLICK单键单点MOBA / 休闲类适合从 keymap/test.json 起步改操作按键 / 参数对应类型作用滑动地图、切目标方向键KMT_DRAGstartPos 到 endPos 模拟一次滑动dragSpeed 越大滑得越快技能 1~4Q / W / E / RKMT_CLICK各绑一个技能槽坐标互动 / 拾取空格KMT_CLICK通用操作位打开背包、菜单Tab / MKMT_CLICK switchMap点击后释放鼠标方便你继续在界面上操作调优指南 参数含义推荐范围调大 / 调小的效果speedRatioX / speedRatioY水平 / 垂直视角灵敏度最小 0.001只填 speedRatio 时 Y 轴按 2.25 倍折算FPS 参考 3.25 / 1.25MOBA 两轴取相近值调大视角更稳、甩枪变慢调小甩枪跟手、容易飘startPos视角拖动的起始点屏幕上方 1/4 处对准游戏里转视角的自然位置拖动更顺各方向 Offset方向盘按下后的拖动幅度0.1~0.3过小摇杆没吃满、跑不动过大容易失控MaxFps / 启动前配置的分辨率上限帧率Android 10 生效与画质见 config/config.ini按显卡选 30 或 60帧率越高越流畅CPU/GPU 占用越高两条经验FPS 游戏建议水平灵敏度略高于垂直水平数值给得小一些MOBA 和休闲游戏两轴保持同值更不容易打转。手感不对时先动 speedRatioX/Y一次改 0.25 左右试一局startPos 放偏了怎么调灵敏度都不舒服先对齐位置。常见问题快查现象应用脚本后按键毫无反应。排查看是不是还在普通模式。解决按一次 switchKey默认~切进映射模式确认点过应用而不是只刷新了脚本列表。现象USB 插好刷新设备列表却是空的。排查先确认手机侧的调试授权弹窗是否点了允许。解决列表仍为空时装一个手机助手类应用验证连接报adb server version ... doesnt match则结束任务管理器里的 adb 进程或在 config.ini 的AdbPath指向当前用的 adb。现象画面正常但点屏幕没反应。排查小米等机型默认拦截外部模拟点击。解决开发者选项里打开USB 调试安全设置中的允许模拟点击项再重新连接。现象能控制但画面发虚、文字发毛。排查窗口远小于设备原生分辨率或 Windows 高 DPI 缩放在作怪。解决窗口拉大或在QtScrcpy.exe属性 → 兼容性 → 更改高 DPI 设置中把缩放行为设为应用程序。检查清单配置前开发者选项已开启 USB 调试必要时含模拟点击权限映射 JSON 已放入keymap目录且格式校验通过刷新设备后列表能看到设备号配置中switchKey 没有和映射里的 key 撞键每个触摸坐标都用调试坐标或指针位置核对过节点类型选对单点用 KMT_CLICK、双击用 KMT_CLICK_TWICE、滑动用 KMT_DRAG验收时试打一小局按调优建议微调 speedRatioX/Y按切换键能立刻释放鼠标、切回普通模式应用后窗口无报错各节点触摸点位置准确写在最后投屏加键鼠映射本质上就是让你把手机当成一台带触屏的游戏手柄来用先保证连接稳再把坐标和灵敏度打磨到自己顺手。下一步建议翻一翻 docs/KeyMapDes_zh.md 里全部节点类型的字段说明照抄 keymap/ 目录下的 tiktok、identityv 等现成脚本改参数有兴趣了解实现细节再进入 QtScrcpy/QtScrcpyCore/ 源码目录看看映射是怎么被执行的。【免费下载链接】QtScrcpyAndroid实时投屏软件此应用程序提供USB(或通过TCP/IP)连接的Android设备的显示和控制。它不需要任何root访问权限项目地址: https://gitcode.com/barry-ran/QtScrcpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考