如何把手游键位完整搬上键鼠QtScrcpy 键鼠映射配置实战笔记【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpyQtScrcpy 是一款安卓实时投屏与控制工具通过 USB 或局域网连接手机后可以把键盘、鼠标的输入转换成屏幕上的触摸事件核心扩展能力就是键鼠映射一份 JSON 文件定义哪个键位对应屏幕上的哪个动作。下面按让一个映射文件真正跑起来的思路讲清楚从连接设备、应用脚本到坐标校准、灵敏度调优和常见故障排查的完整流程。一、映射文件的三部分结构映射文件是 JSON 格式放在 keymap/ 目录下才会被识别完整编写规则见 docs/KeyMapDes_zh.md。一份完整的文件由三部分组成switchKey普通镜像控制与映射模式之间的切换键预设文件大多取Key_QuoteLeft即~键。mouseMoveMap可选把鼠标移动转成连续的手指拖动用于 FPS 类游戏的视角控制包含拖动起点startPos、灵敏度比例speedRatioX/speedRatioY以及辅助微调的小眼睛smallEyes。keyMapNodes通用按键数组把每个键盘键对应到一次触摸动作。坐标体系要先说清楚所有坐标都是相对值以屏幕左上角为原点宽高各归一化为 1(0.5, 0.5) 就是屏幕中心。这意味着同一份文件在不同分辨率的设备上通用也是后面调参的基础。keyMapNodes中可用的节点类型共五种type行为KMT_CLICK按键按下时手指按下抬起时手指抬起KMT_CLICK_TWICE快速完成两次点按适合双击类操作KMT_CLICK_MULTI一个按键按 delay 间隔依次点按多个位置KMT_DRAG从 startPos 拖拽到 endPos可配 dragSpeed 与 startDelayKMT_STEER_WHEEL四个按键通常 WASD模拟摇杆走位一个最小可用的片段长这样switchKey: Key_QuoteLeft, keyMapNodes: [ {type:KMT_CLICK,key:Key_Space, pos:{x:0.5,y:0.5}} ]按键名使用 Qt 的键枚举如Key_W、Key_Shift、LeftButton可以在 Qt 文档的 Key enum 中查询。二、让映射生效连接、应用、切换三步手机端开启开发者选项中的 USB 调试小米等机型还需要在 USB 调试子菜单里打开模拟点击否则会出现有画面但无法控制的状况见 docs/FAQ.md。连接设备USB 连接后点击刷新设备列表走局域网则需先通过 USB 启动 adbd再选择以 IP 开头的那台设备。点击启动服务正常情况下约 1 秒内视频窗口出画面。点击刷新脚本确认目标文件出现在列表中选中后点击应用脚本。按下~即文件里定义的 switchKey进入映射模式再按一次回到普通触控。注意切换键不是固定为~。预设文件中也有把 switchKey 设为鼠标右键的写法如第五人格以文件内定义为准。三、坐标与灵敏度两个最常调错的地方取坐标的三种途径手机开发者选项中打开显示指针位置触摸屏幕时直接读出坐标再除以屏幕宽高得到相对值开启鼠标移动映射后鼠标左键单击会把当前 pos 打印到 QtScrcpy 控制台可直接照抄以预设文件为参照只替换自己游戏里的按钮位置。灵敏度方向是最容易记反的一处speedRatioX/speedRatioY的数值越大鼠标需要移动的距离越长手感越沉两者均要求不小于 0.001整体 speedRatio 需大于 0.00225。瞄准发飘就调大数值感觉拖不动就调小。自带的和平精英配置取 X3.25、Y1.25可作为起点参照。smallEyes则用于微调按下指定键后拖拽起点切换到smallEyes.pos处且活动范围缩小相当于给准星加了一档低速档。建议一次只改一个参数并在游戏内验证。自己的映射文件按上述格式编写后放入 keymap 目录用自带预设当模板比从零写要快得多。四、按品类看键位以《第五人格》为例预设目录里除了射击类还有 keymap/identityv.json 这份移动 视角 技能混合布局的完整样例摘录如下键位动作类型位置WASD摇杆走位KMT_STEER_WHEEL中心 (0.16, 0.70)左键 / 空格动作开门、交互KMT_CLICK(0.907, 0.842)Z / E / Q技能与道具KMT_CLICK见文件对应 pos1 / 2 / 3拖拽类操作KMT_DRAGstartPos → endPosAlt小眼睛微调视角smallEyes(0.801, 0.244)这份文件里有两个值得留意的做法走位用KMT_STEER_WHEELcenterPos加四个方向的 offsetWASD 四键即覆盖八向移动比逐方向单独点击更接近摇杆手感菜单类按键如 Esc 退出设置了switchMap: true按下时释放鼠标锁定方便在菜单里用指针导航用完切回映射即可。其他品类同理FPS 参考 gameforpeace.jsonApex 手游参考 FRAG.json短视频类参考 tiktok.json方向键模拟上滑下滑翻页。品类不同布局逻辑不同但文件结构完全一致。五、多开与批量控制时的注意点QtScrcpy 支持同时打开多个设备的视频窗口键鼠操作可同步下发到所有已连接设备。多开场景下建议先固定窗口布局与窗口置顶再逐台应用脚本避免操作串窗口批量使用前适当降低分辨率与比特率投屏负载是单台电脑可带设备数的主要瓶颈每台设备的映射文件可以不同按设备单独选择脚本即可。六、排查清单映射看起来没生效按顺序检查这四点能覆盖绝大多数情况当前不在映射模式再按一次 switchKey 切换和平精英等在上下车后会出现触摸点偏移连续按两次切换键可恢复设备已断开或无线连接掉线后 adbd 未重新启用机型缺少模拟点击授权有画面、无响应典型于小米等品牌adb 版本冲突控制台出现 version 不匹配报错时结束 adb 进程或在 config/config.ini 中把 AdbPath 指向当前使用的 adb。更多问题记录在 docs/FAQ.md其中画面不清晰Could not open video stream等条目分别对应 DPI 缩放与分辨率设置可按图索骥。【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考