企业官网建设流程全解析

QtScrcpy 按键映射实战指南：3 步让手游支持键鼠操作

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

用 QtScrcpy 把安卓手机投屏到电脑上之后，很多人下一步就是想用键盘鼠标去操控它——比如在《和平精英》里用 WASD 走位、鼠标瞄准。本文带你走通 QtScrcpy 的核心能力按键映射：从连接手机、启用现成脚本，到读懂并手写自己的映射文件，再到把坐标和灵敏度调到贴合你的屏幕。读完并按步骤操作，约 10 分钟内就能让一部手机支持键鼠操作。

准备工作：连接手机并打开调试

按键映射建立在"投屏 + 控制"之上，先确保设备能正常连接。

1. 手机开启开发者选项，并打开USB 调试。
2. 用数据线连接手机，或改用 Wi-Fi / 网络方式连接。
3. 在 QtScrcpy 中选中设备，点击启动，1 秒左右即可看到第一帧画面。

提示：映射脚本依赖 ADB 通道把指令发回手机，连接不稳定时映射会时灵时不灵，优先排查这一步。

3 分钟启用第一个按键映射

项目自带了几套映射脚本，放在 keymap/ 目录下，适合先跑起来体验效果。

1. 🔧 把需要的脚本放进keymap/目录（默认已内置 gameforpeace.json、tiktok.json 等）。
2. 🔧 点击刷新脚本，让程序检测到新文件。
3. 🔧 在下拉框中选择对应脚本。
4. 🔧 连接手机并启动服务后，点击应用脚本。
5. 🔧 按~键（脚本里的switchKey）切换到自定义映射模式，映射生效。
6. 🔧 再按一次~，切回普通控制模式。

启用后，gameforpeace.json会接管一组常用键位：WASD 走位、空格跳跃、鼠标左右键分别对应射击与开镜、M开地图、Tab开背包。

注意：玩《和平精英》这类用"方向盘"控制载具的映射时，记得在游戏载具设置里选单摇杆模式，否则移动会失灵。

读懂映射文件：坐标、类型与按键码

想改自己的键位，先看懂 JSON 的结构。完整的字段说明见 docs/KeyMapDes_zh.md。

坐标是相对值。屏幕宽高都归一化为 1，(0.5, 0.5)就是屏幕正中心。就像给屏幕建了张"网格地图"，无论手机分辨率是 720p 还是 1080p，同一个坐标指向的位置不变，换机器不用重新标定。

每个映射节点必须带一个type，常见类型如下：

按键码用 Qt 枚举表示，如Key_Space、Key_Up、LeftButton。以 keymap/tiktok.json 为例，方向键被映射为四段KMT_DRAG拖动，实现上/下/左/右滑切换视频。

mouseMoveMap则用于 FPS：把鼠标移动映射为以startPos为起点的手指拖动，用来转视角，是"像端游一样玩手游"的关键。

调试与调优：让映射贴合你的屏幕

预设坐标未必正好压住你手机上的按钮，需要微调。

抓坐标的两种办法：

1. 🔧 开启手机开发者选项里的显示指针位置，手指点一下就能看到触点坐标。
2. 🔧 在投屏画面里用鼠标左键单击，控制台会直接打印出此时的pos，直接照抄进脚本即可。

调灵敏度：mouseMoveMap下的speedRatioX/speedRatioY控制鼠标转视角的快慢，数值越大手感越"沉"，越小越"飘"，两个轴可以分开调。

提示：调灵敏度时小步长修改（每次 ±0.1 左右），进游戏实测再改，比一次拉满更省心。

常见问题排查

注意：映射文件必须是 JSON 且位于keymap/目录才会被扫描到，多设备建议各自维护独立脚本，避免串键。

小结

按键映射让 QtScrcpy 从"能投屏"进阶到"能像端游一样操作"。建议按这条路径走：先用预设脚本跑通~切换，再读懂坐标与类型、手写一份自己的映射，最后用坐标抓取和灵敏度微调把它调到顺手。完整字段定义见 docs/KeyMapDes_zh.md，更多预设可参考 keymap/ 目录下的示例文件。

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