企业官网建设流程全解析

QtScrcpy 入门指南：投屏、无线连接与键鼠映射一次讲清

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

如果你曾经在手机上用两根拇指瞄准，手指挡住屏幕还嫌视野太小，QtScrcpy 值得一试。这是一款开源免费的投屏控制工具，能把安卓屏幕投射到电脑上（Windows、macOS、Linux 均可），并用键盘鼠标操作游戏。本文按"先投屏、再配映射、后多设备"的顺序，把连接方式、键鼠映射文件写法、批量管理逐项讲清楚。

🎮 先看效果：键盘鼠标如何接管游戏

在配置之前，先明确最终效果：映射开启后，键盘按键会被转换成手机屏幕上的点击，鼠标移动会被转换成手指拖动。比如用 WASD 绑住左侧摇杆、用鼠标转向控制视角、用 QWEF 绑住技能键。

坐标是怎么表达的：映射文件里不写像素，而是写比例。整块屏幕视为一个单位正方形，左上角是 (0, 0)，右下角是 (1, 1)，所以 (0.5, 0.8) 表示"横向 50%、纵向 80% 处"。比例制的配置换分辨率不用改。

📍如何拿到精确坐标：在手机开发者选项里开启"显示指针位置"。开启后鼠标在屏幕上移动时，窗口顶部状态栏会实时显示当前 x/y 比例值，直接抄下来即可。

映射模式由哪个键切换：默认是~键。按一下从普通操控切进映射模式，再按一下退出。后文所有按键方案都在映射模式下生效。

第一次投屏：从 USB 线到无线

先拿到软件：到仓库 Releases 页面下载对应系统版本即可；如需自行编译，可克隆仓库：

git clone https://gitcode.com/GitHub_Trending/qt/QtScrcpy

要求：安卓 5.0 以上系统 + 一台电脑。连接前需要在手机上做两件事：设置 → 关于手机，连续点击"版本号"7 次激活开发者模式；然后进入开发者选项，打开"USB 调试"和"显示指针位置"（后者是映射部分取坐标的前提，别漏）。

用 USB 线连接

数据线接上手机，打开 QtScrcpy，在"USB线"区域点"刷新设备列表"。设备序列号下拉框里出现手机型号后，选中它点"启动服务"，投屏窗口弹出，手机画面实时显示在电脑上。

📶 无线连接怎么设置

不想一直插 USB 线的话，手机和电脑连在同一个 Wi-Fi 下，按顺序点三个按钮：

1. "获取设备 IP"——读到手机的 IP 地址；
2. "启动 adbd"；
3. 在"无线"区域填入 IP 和端口（默认 5555），点"无线连接"。

之后拔掉 USB 线，下次直接选无线设备点"启动服务"。注意无线延迟普遍高于 USB；整体投屏延迟通常在 35–70ms 区间，追求跟手就用 USB。

映射文件在哪里改、怎么写

映射配置是 JSON 文件。仓库的 keymap/ 目录自带若干游戏示例（和平精英、第五人格、抖音等），新建自己的 .json 文件放进同一目录，点主界面"刷新脚本"即可被识别。

文件结构：顶层有switchKey（映射切换键，默认~，即Key_QuoteLeft）和keyMapNodes数组，数组中每一项把一个按键绑定一个动作：

{ "switchKey": "Key_QuoteLeft", "keyMapNodes": [ { "comment": "W 绑左侧摇杆", "type": "KMT_CLICK", "key": "Key_W", "pos": { "x": 0.1, "y": 0.8 } } ] }

按键名采用 Qt 的键枚举（如Key_Space、Key_Up），完整清单和字段说明见按键映射格式文档。

常用动作类型：

• KMT_CLICK：普通点击，按下模拟手指落下、抬起模拟抬起，适合摇杆与开火键；
• KMT_CLICK_TWICE：双击，一次按键触发两下连点；
• KMT_CLICK_MULTI：多点连点，在clickNodes里按 delay 和 pos 依次指定，一个键完成一套连招；
• KMT_DRAG：拖拽，指定startPos与endPos，按下即完成一次滑动。

鼠标移动映射：mouseMoveMap段把鼠标移动映射为以固定起点（如角色中心）出发的手指拖动，射击游戏里一般用它调视角。拖动距离由speedRatio控制，也可用speedRatioX/speedRatioY分别调 X、Y 轴，数值越大灵敏度越低。起步可参考speedRatioX: 2.5、speedRatioY: 2.0，Y 轴略低于 X 轴，避免抬头低头幅度被放大，再按手感微调。

文件写好后：点"刷新脚本"选中文件 → 连接设备 → 点"应用脚本" → 游戏里按~进入映射模式即可使用。

射击与 MOBA 的键位参考

以和平精英为例，常见的布法是移动在左、技能在右，开火交给鼠标左键：

绑完后用"显示指针位置"逐点校准，再调mouseMoveMap的灵敏度直到视角转动跟手。

MOBA 游戏（如王者荣耀）更简单：Q/W/E/R 对应四个技能图标，F 绑召唤师技能，空格绑回城，每个键对准对应图标位置即可。

短视频类应用同样适用：↑↓ 上下滑动、←→ 左右切换、空格暂停/播放、Enter 点赞。

多设备同开：多台手机的批量管理

手里有多台手机时，全部接上电脑（USB 或无线），点"刷新设备列表"，逐台启动服务，每台设备对应一个独立投屏窗口，窗口可自由摆放。

游戏多开、批量应用测试等场景常用到三类操作：

• 同步控制：同一套操作下发到所有设备；
• 独立控制：只操作其中一个窗口，其余保持不动；
• 统一配置：启动参数（比特率、尺寸、脚本）一次设定，各窗口复用。

⚠️ 排错与流畅度调优

画面或控制异常：

• 投屏无画面：打开 config.ini，修改UseDesktopOpenGL取值——0 为软解、1 为 DX 硬解、2 为 OpenGL 硬解，逐一试到正常；
• 有画面但控制不了：确认手机开发者选项已允许模拟点击，且"USB 调试（安全设置）"已开启；
• 无线连接失败：确认手机与电脑在同一网络，且 USB 连接状态下执行过"启动 adbd"；
• 映射突然失效：先确认是否处于映射模式，不在的话按~切回；
• 和平精英上下车失效：属于游戏侧机制，连按两次~一般可恢复；
• 无法输入中文：手机上安装搜狗或 QQ 等中文输入法；
• Windows 画面模糊：右键程序属性 → 兼容性 → 更改高 DPI 设置，将高 DPI 缩放行为设为"由应用程序执行"。

延迟偏高怎么办：在"启动配置"区把比特率调到 2–8Mbps 区间、调低"最大尺寸"（分辨率）、改回 USB 连接、关闭占用 CPU 的后台程序。若只录屏不围观，可勾选"录屏屏幕"+"后台录制"降低本机负载。

快捷键速查

普通控制（未进映射模式）下，以下快捷键随时可用：

QtScrcpy 的本质，是把手机屏幕变成一块由键盘鼠标驱动的"大屏"：连接只是几个按钮的事，映射只是一份 JSON，剩下的都是微调。现在就可以把手机用 USB 接上，点一下"刷新设备列表"再点"启动服务"，看到第一个投屏画面。

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