QtScrcpy 按键映射实战指南3 步让手游支持键鼠操作【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpy用 QtScrcpy 把安卓手机投屏到电脑上之后很多人下一步就是想用键盘鼠标去操控它——比如在《和平精英》里用 WASD 走位、鼠标瞄准。本文带你走通 QtScrcpy 的核心能力按键映射从连接手机、启用现成脚本到读懂并手写自己的映射文件再到把坐标和灵敏度调到贴合你的屏幕。读完并按步骤操作约 10 分钟内就能让一部手机支持键鼠操作。准备工作连接手机并打开调试按键映射建立在投屏 控制之上先确保设备能正常连接。手机开启开发者选项并打开USB 调试。用数据线连接手机或改用 Wi-Fi / 网络方式连接。在 QtScrcpy 中选中设备点击启动1 秒左右即可看到第一帧画面。提示映射脚本依赖 ADB 通道把指令发回手机连接不稳定时映射会时灵时不灵优先排查这一步。3 分钟启用第一个按键映射项目自带了几套映射脚本放在 keymap/ 目录下适合先跑起来体验效果。 把需要的脚本放进keymap/目录默认已内置 gameforpeace.json、tiktok.json 等。 点击刷新脚本让程序检测到新文件。 在下拉框中选择对应脚本。 连接手机并启动服务后点击应用脚本。 按~键脚本里的switchKey切换到自定义映射模式映射生效。 再按一次~切回普通控制模式。启用后gameforpeace.json会接管一组常用键位WASD 走位、空格跳跃、鼠标左右键分别对应射击与开镜、M开地图、Tab开背包。注意玩《和平精英》这类用方向盘控制载具的映射时记得在游戏载具设置里选单摇杆模式否则移动会失灵。读懂映射文件坐标、类型与按键码想改自己的键位先看懂 JSON 的结构。完整的字段说明见 docs/KeyMapDes_zh.md。坐标是相对值。屏幕宽高都归一化为 1(0.5, 0.5)就是屏幕正中心。就像给屏幕建了张网格地图无论手机分辨率是 720p 还是 1080p同一个坐标指向的位置不变换机器不用重新标定。每个映射节点必须带一个type常见类型如下类型作用典型场景KMT_CLICK按下手指按下抬起手指抬起跳、蹲、换弹、开镜KMT_CLICK_TWICE一次按键触发两次点击左/右探头KMT_CLICK_MULTI一次按键依次点多个位置一键多点KMT_DRAG按下并拖动一段距离上滑切视频KMT_STEER_WHEEL四方向键模拟摇杆FPS 走位方向盘按键码用 Qt 枚举表示如Key_Space、Key_Up、LeftButton。以 keymap/tiktok.json 为例方向键被映射为四段KMT_DRAG拖动实现上/下/左/右滑切换视频。mouseMoveMap则用于 FPS把鼠标移动映射为以startPos为起点的手指拖动用来转视角是像端游一样玩手游的关键。调试与调优让映射贴合你的屏幕预设坐标未必正好压住你手机上的按钮需要微调。抓坐标的两种办法 开启手机开发者选项里的显示指针位置手指点一下就能看到触点坐标。 在投屏画面里用鼠标左键单击控制台会直接打印出此时的pos直接照抄进脚本即可。调灵敏度mouseMoveMap下的speedRatioX/speedRatioY控制鼠标转视角的快慢数值越大手感越沉越小越飘两个轴可以分开调。参数含义调整方向speedRatioXX 轴水平灵敏度偏大更稳偏小更跟手speedRatioYY 轴垂直灵敏度同上dragSpeed拖动速度0~1默认 1.0越大拖得越快提示调灵敏度时小步长修改每次 ±0.1 左右进游戏实测再改比一次拉满更省心。常见问题排查现象可能原因处理办法按了键没反应ADB 连接异常重新连接设备重启服务触点偏了一点坐标未对准用上面的两种办法重新抓pos转视角太快/太慢灵敏度不合手微调speedRatioX/Y移动失灵FPS 载具摇杆模式不对游戏内改单摇杆模式新脚本没被识别文件没放对目录确认放在keymap/并点刷新脚本注意映射文件必须是 JSON 且位于keymap/目录才会被扫描到多设备建议各自维护独立脚本避免串键。小结按键映射让 QtScrcpy 从能投屏进阶到能像端游一样操作。建议按这条路径走先用预设脚本跑通~切换再读懂坐标与类型、手写一份自己的映射最后用坐标抓取和灵敏度微调把它调到顺手。完整字段定义见 docs/KeyMapDes_zh.md更多预设可参考 keymap/ 目录下的示例文件。【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考