企业官网建设流程全解析

三步把键盘变成手游控制器：QtScrcpy 按键映射实战教程

【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpy

想在电脑上用键盘鼠标操控手游，QtScrcpy 的按键映射（keymap）功能是最直接的路径之一：一份 JSON 文件就能把按键绑到屏幕触摸点上，鼠标转视角、WASD 移动、方向键刷短视频都能实现。这篇教程带你走完"量坐标 → 写文件 → 调手感"的完整流程，照着做就能得到一份可直接上手的映射配置。

第一步：找到要摸的屏幕位置 📍

映射文件的核心是"位置"。QtScrcpy 使用 0~1 的相对坐标，手机分辨率怎么换它都不变——(0.5, 0.5) 永远是屏幕中心。拿坐标不用猜，三种办法：

1. 手机开发者选项里打开"显示指针位置"，摸一下目标位置，就能看到像素值
2. 直接点 QtScrcpy 视频窗口里的目标位置，控制台会打印出 pos，直接抄
3. 抄不到就用 像素值 ÷ 屏幕宽/高，手动算出相对坐标

坐标获取和开发者选项的完整说明，可看官方文档 docs/KeyMapDes_zh.md。

第二步：写一份映射文件

把 JSON 文件放进keymap目录，QtScrcpy 会自动识别。目录里已自带和平精英、FRAG、抖音等现成示例，可以直接抄改：keymap/。最简单的节点只需"按键 + 位置"，比如让空格键跳：

{ "type": "KMT_CLICK", "key": "Key_Space", "pos": { "x": 0.96, "y": 0.7 } }

五种映射类型基本覆盖手游全部场景：

• KMT_CLICK普通点击，使用频率最高
• KMT_CLICK_TWICE双击，适合探头这类操作
• KMT_CLICK_MULTI一键多点连击，适合搓连招
• KMT_DRAG拖拽，方向键刷短视频就靠它
• KMT_STEER_WHEEL方向盘，一套 WASD 控制移动，FPS 专用

第三步：微调鼠标灵敏度 🎯

FPS 游戏里要让鼠标移动变成手指拖拽（调视角），用mouseMoveMap这一段搞定：

"mouseMoveMap": { "startPos": { "x": 0.57, "y": 0.26 }, "speedRatioX": 3.25, "speedRatioY": 1.25 }

调参建议：

• speedRatio 数值越大、灵敏度越低，先调低再逐步加
• 横竖方向手感不一致时，分别用 speedRatioX / speedRatioY 单独设
• 需要开镜压枪时配置 smallEyes，按对应键切换成小幅度拖拽，瞄起来更稳

避坑清单 🛠

• 坐标总差一点：回到开发者选项开"显示指针位置"重新校准一次
• 部分小米等机型点不出反应：在 USB 调试里勾选"允许模拟点击"
• 改配置只需动对应节点的 pos 字段，不用整份重写，改完进游戏实测即可

【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpy