QtScrcpy 投屏控制实操手册：USB 与无线连接、多设备批量操作、键鼠映射一次讲透
【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpy
QtScrcpy 是一款跨平台（Windows / macOS / Linux）的 Android 投屏控制软件：USB 或 Wi-Fi 连上手机后，画面实时上屏，键鼠即可反向控制设备。全程免 root、手机上不装任何 App，实测帧率 30~60 FPS，延迟约 35~70 毫秒。下面按"先跑通、再稳定、后提速"的顺序，带你把它用起来。
把第一帧画面上来：QtScrcpy 投屏的最小路径
场景：手机第一次接电脑，什么都还没动。按这个顺序走，三分钟出画面。
- 解锁开发者选项：设置 → 关于手机，连点"版本号"7 次，直到出现"开发者选项"入口。
- 打开两个开关：进入开发者选项，同时开启"USB 调试"与"USB 调试（安全设置）"。插线后手机弹出授权弹窗就点允许，少开安全设置很多机型只出画面、无法控制。
- 插线后点"刷新设备"：左侧列表出现设备序列号即识别成功；如果列表一直空着，在下方 adb 命令行框输入
devices执行，重点看是否unauthorized——是的话回手机上点一次授权。 - 选中设备点"启动服务"：约 1 秒内出第一帧，USB 链路即打通。
一个省电习惯：启动配置区勾上"自动息屏"（命令行参数--turn-screen-off），或投屏后按Ctrl+O。手机侧黑屏、电脑侧画面持续刷新，说明设置生效。
无线连接的设置要点
场景：线太长碍事，想纯 Wi-Fi 投屏。前提是手机与电脑在同一个 Wi-Fi 下——尽量都接 5GHz 频段、靠近路由器，2.4GHz 频段在高码率下容易先糊后卡。
- 在界面点"获取设备 IP"，再点"启动 ADBD"：这一步让手机在局域网内开放 ADB 服务，默认端口 5555；
- 把 IP 与端口 5555 填入"无线"区域，点"无线连接"，再"刷新设备"。
成功判断：设备列表里多出一条以 IP 开头的记录，选中它点"启动服务"，画面出来即成。之后可以拔掉数据线。
网络本身偏弱时，在启动配置区把分辨率压到 720p、比特率降到 2Mbps 以下、帧率定在 30fps，稳定性会立刻好起来；防火墙记得放行 5555 的 TCP 入站，Linux/macOS 一条命令sudo ufw allow 5555/tcp。如果只想把一台 USB 设备快速投到另一台电脑上，直接用"快速镜像"功能，免去手填 IP：
多设备批量操作与多开省电
场景：测试机上十来台设备跑同一流程，逐台窗口点按不现实；另外同时开多个投屏窗口时，软解码会让 CPU 迅速拉满。
- 在设备列表按住
Ctrl多选设备，加入群组；群组控制界面里执行安装 APK、配置、截图等操作，整组设备同步响应。 - 解码方式在
config/config.ini的[common]段调整：UseDesktopOpenGL默认-1自动，可设2（OpenGL 硬解）、1（DX 硬解）或0（软解），多开设备时优先硬解。 RenderExpiredFrames=0表示跳过过期帧，用一点流畅度换更低延迟，多开时建议保持。- 窗口太多时把
MaxFps从0（不限）降到30，帧率上限仅 Android 10 以上生效，单台卡顿的设备单独降它的帧率与比特率即可，不必全局降画质。
成功判断：一次操作整组完成，任务管理器里 CPU 曲线平稳。
键鼠映射 JSON 编写：让手游在电脑上像端游
场景：FPS 手游里虚拟摇杆给不了精细瞄准，多指操作也靠不住。QtScrcpy 的按键映射就是为此设计的：JSON 文件放进keymap/目录即被识别，仓库自带keymap/gameforpeace.json、keymap/FRAG.json等可直接抄结构。
- 切换键：
switchKey（默认~）按住才进入自定义映射，松开回到普通鼠标模式，防止误触。 - 鼠标映射：
mouseMoveMap把鼠标移动映射为以startPos为起点的手指拖屏，用来转动人物视角；speedRatio数值越大灵敏度越低（下限 0.00225），也可以分别写speedRatioX/speedRatioY。FPS 玩法建议再加一个smallEyes键，开镜后切换到小范围微调。 - 按键节点：
keyMapNodes是映射数组，共五种类型——KMT_CLICK点击、KMT_CLICK_TWICE双击、KMT_CLICK_MULTI多点、KMT_DRAG拖拽、KMT_STEER_WHEEL方向盘（WASD 四键配合）。坐标都是相对值，(0.5, 0.5) 即屏幕中心。
坐标不用手算：投屏进行中用鼠标左键点一下屏幕，控制台会直接打印该点的pos相对坐标，复制进 JSON 即可：
成功判断：~按住后 WASD 走位、鼠标开镜开火，手感接近端游。
投屏故障速查
| 症状 | 排查方向 |
|---|---|
| 设备列表刷不出来 | 先跑devices看是否unauthorized；是则回手机点授权，否则adb kill-server后重启 ADB 再刷新 |
| 黑屏或花屏 | 多与解码兼容有关，UseDesktopOpenGL在 0 与 2 间切换；再降分辨率、压比特率排除带宽因素 |
| 无线失败但 USB 正常 | 确认同一 Wi-Fi、防火墙已放行 5555 入站，重新"启动 ADBD"后再连 |
| 键鼠无反应 | 确认投屏窗口有焦点、~没被卡住；adb shell input tap 500 500可验证手机端输入链路 |
| 只有某台设备卡 | 单独给它降MaxFps与比特率，其余设备维持高画质 |
画面不清晰、adb 版本冲突等细节问题，继续看 常见问题；想自己写映射规则，参考 按键映射编写说明；需要源码级理解则读 开发指南。
现在去下载对应平台的编译包，插上手机——画面几分钟内就会出现在你的桌面上。
【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpy
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
