企业官网建设流程全解析

QtScrcpy完整指南：5分钟接通手机，用键鼠操控任意手游

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

深夜排位，敌人已经贴脸，你的拇指却还压在虚拟摇杆上——手指操控手游，天花板就这么高。QtScrcpy 把这个问题拆掉了：手机连上电脑后，它实时投屏，并用键盘鼠标接管全部操作，移动和瞄准从此可以同时进行。这篇指南帮你今天就能连上开玩。

先认清QtScrcpy：一张表看全能力版图

QtScrcpy 是一款纯 C++ + Qt 开源的安卓投屏控制软件：不需要 root，也不往手机里装任何 App，画面经 USB 或 WiFi 推到电脑，键鼠输入反向注入手机。它和原版 scrcpy 最大的区别，是支持自定义按键映射和多点触控，界面用 Qt 重写，可定制性高很多。

5分钟跑起来：今天就能上手的最少步骤

前提条件：

• 手机：Android 5.0+（API 21），开启 USB 调试（设置 → 关于手机 → 连点"版本号"7 次 → 开发者选项 → USB 调试）
• 电脑：Windows / macOS / Linux 均可，用官方预编译包（已内置 ADB）；想自己编译需 Qt 5.12+，源码可从https://gitcode.com/GitHub_Trending/qt/QtScrcpy克隆
• 连接：USB 线，或手机与电脑同一 WiFi

接线四步：

1. USB 插好手机，点"刷新设备列表"——列表里出现设备序列号就算成功（若一直为空，先用任意手机助手连一次让系统装好驱动）
2. 点"启动服务"，约 1 秒出画面。动一下鼠标、按几个键，屏幕跟着动，即验证通过
3. 想无线化（手机和电脑同一局域网）：依次点"获取设备 IP → 启动 adbd → 无线连接"，再刷新，选中 IP 开头的设备，启动服务——之后拔掉 USB 也能一直连着
4. 打开"启动配置"可调比特率、最大尺寸、录制路径；"窗口置顶""自动息屏"等选项都在这一栏

拆核心：虚拟手指是怎么落到屏幕上的

整个按键映射就是 keymap/ 目录下的一份 JSON 文件，读懂 4 个机制就能改出自己的配置：

1. 坐标全是相对值。整块屏幕的宽高都记为 1，比如(0.5, 0.5)落在 1920×1080 屏幕上就是像素 (960, 540)。好处：同一份文件在任意分辨率手机上都不跑位。

2. switchKey 是总开关。默认是~（数字键 1 左边）。按一下进入映射模式——所有键变成虚拟按钮；再按一下退回普通控制模式。

3. mouseMoveMap 把鼠标变成"一根手指"。你移动鼠标，它就在startPos处模拟一次手指拖动，FPS 游戏靠它转视角。两个关键参数：

• speedRatioX/speedRatioY：X/Y 轴灵敏度比，数值越大灵敏度越低（最小 0.001），Y 轴默认按 2.25 的比率平移
• smallEyes：按指定键（和平精英配置里是 Alt）后，拖动起点换成一个精细瞄准点，开镜压枪专用

4. keyMapNodes 有 5 种触发动作，一个键对应哪一种：

还有一个易被忽略的字段：switchMap: true表示点下该键后释放鼠标（鼠标指针还给你），专门用于 M 地图、Tab 背包这类需要用鼠标翻菜单的界面。

坐标怎么取？映射开启后，鼠标左键点一下，控制台立刻打印 pos（形如"pos": {"x": 0.753, "y": 0.462}），照抄即可；也可在开发者选项里勾"显示指针位置"核对。编写规则全文在 docs/KeyMapDes_zh.md。

抄作业：3个内置场景，打开就能用

仓库自带的映射文件不用手写，选一个、应用、按~即可。效果如下：

场景一：和平精英（gameforpeace.json）

场景二：第五人格（identityv.json，切换键换成了鼠标右键）

场景三：刷抖音（tiktok.json）——最轻量的映射，适合验证整套流程是否生效：

自定义映射四步走：把 JSON 放进 keymap/ 目录 → 点"刷新脚本" → 选中它 → 手机启动服务后点"应用脚本" → 按~生效。

一台电脑带多台手机：组控

设备多（云手机、多开矩阵、批量验收）时，QtScrcpy 支持同时连接多台设备，一套键鼠输入同步分发到所有投屏窗口，操作哪台就点哪台，也可以整体齐步走。实现代码在 QtScrcpy/groupcontroller/：

调优与排障手册

参数怎么调（只动这几个，别乱碰）：

• 灵敏度：先调speedRatioY（垂直转镜），再调 X。数值越大越钝，细压枪就逐步加大 Y，直到"瞄人不冲过头"为止
• 拖拽速度：KMT_DRAG 的dragSpeed范围 0~1，远距离大滑固定 1.0，小幅滑动可降到 0.5
• 清晰度 vs 流畅度：WiFi 投屏卡顿时，"启动配置"里调低比特率和最大尺寸；USB 一般不用动

出了毛病怎么办（症状 → 排查点 → 解法）：

更多问题见 docs/FAQ.md。

最好的键位，是你自己磨出来的

一份通用映射只能把你送到 70 分，剩下 30 分在你对坐标和灵敏度那 20 分钟的反复校准里。打开你玩得最熟的那个游戏的 JSON，把坐标一个个对准、把 speedRatio 调到手指的肌肉记忆——明天你会发现，手游用手玩真的回不去了。现在就启动 QtScrcpy，插上手机，按~，你的第一根"虚拟手指"已经落在屏幕上了。

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