QtScrcpy：免费开源的安卓投屏控制工具，电脑控制手机 1 秒出画面

QtScrcpy：免费开源的安卓投屏控制工具，电脑控制手机 1 秒出画面

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

QtScrcpy 是一款免费开源的安卓投屏工具：手机画面实时显示在电脑窗口里，鼠标键盘直接操作手机。USB 和无线两种方式都能连，不用 root，延迟 35~70ms，大约 1 秒出首帧，Windows、macOS、Linux 三平台通用。

什么人用得着它

• 手游玩家：想在桌面大屏上打手游，并且用键盘鼠标替代手指。项目自带《和平精英》《抖音》等游戏的映射脚本，装好就能用。
• 电商多账号运营：手上十几台手机要轮流做同样的事。勾选设备后启用群控，一套操作同步播到所有机器上。
• 移动端测试工程师：同一份 UI 要在多块屏上核对、复现。USB 加无线混合连接，最多同时管理 16 台设备。

从安装到第一帧：USB 投屏完整动线

整条动线只有四步，按顺序走完手机画面就出现在桌面上了。

1. 拿软件。各平台都有预编译包，Windows 包里连 ADB 都带了。想自己编译的话，先拉源码：

   git clone --recurse-submodules https://gitcode.com/GitHub_Trending/qt/QtScrcpy

2. 手机侧准备。在「设置 → 关于本机」里连点 7 次「版本号」，把开发者选项放出来，打开 USB 调试。小米等机型还要在「USB 调试（安全设置）」里允许模拟点击，这一步漏掉是后面"能看不能控"的头号原因。

   手机开发者选项中开启 USB调试(安全设置) 的安卓投屏前置设置.jpg)

3. 插线、授权、启动。插上数据线，手机上弹出调试授权就点允许；打开软件点「刷新设备」，选中你的机器，点「启动服务」。

4. 看画面。大约 1 秒后投屏窗口里就是手机实时画面，鼠标点哪里手机就跟手动哪里。

系统要求不高：Android 5.0（API 21）以上即可。

无线投屏怎么开启

第一次老老实实用 USB，之后拔线：

1. USB 连好、授权完成的前提下，点「获取设备IP」拿到手机 IP；
2. 点「启动adbd」，软件会把 adb 切到 5555 端口的无线模式；
3. 拔线，在输入框填刚才的 IP，点「无线连接」。

手机和电脑在同一局域网下，以后重连只需填 IP。USB 和无线设备可以在同一个列表里混用。

按键映射 5 步配置：键盘鼠标接管手游

这是 QtScrcpy 和原版 scrcpy 拉开差距的地方：映射规则写成 JSON 脚本，放进 keymap/ 目录就会被识别。仓库里现成可用的有gameforpeace.json（和平精英）、tiktok.json（抖音）、identityv.json（第五人格）、FRAG.json，脚本写法参考 docs/KeyMapDes.md。

1. 把映射 json 放到keymap/下；
2. 点「刷新脚本」，列表里出现这个文件；
3. 选中它；
4. 连上设备、启动服务后点「应用」；
5. 按~键（脚本里的 SwitchKey）进入映射模式，再按一次切回普通模式。

位置不准就用「调试坐标」功能：在画面上点一下，读出坐标写回脚本，反复几次就能对齐到按钮。

一个已知的小毛病：《和平精英》上下车会新建界面，导致触摸点失效。按两下~键可以恢复，目前没有更优雅的办法。

多设备群控怎么开

在设备列表里勾选要参与同步的手机，启用群控即可。之后在主控窗口上的拖拽、点击、按键输入，会被同步重放到所有被勾选的设备上，USB 和无线连接的设备可以混在一起控。

实战：在电脑上打一把手游

把上面的能力串起来，一次完整的开黑流程长这样：

1. 手机 USB 连好，「刷新设备」+「启动服务」，投屏窗口亮起来；
2. 「刷新脚本」→ 选gameforpeace.json→「应用」；
3. 按~进入映射模式，对着窗口开打：键盘负责移动，鼠标负责瞄准射击，画面就是手机实况；
4. 玩完再按一次~退出映射，手机恢复正常触控模式。

默认键位布局看上面那张game.png，想改哪把枪对应哪个键，编辑 json 里的键名就行。

卡住了先查这里：按症状自查

遇到状况别急着换软件，按症状对号入座：

• 刷新后设备列表是空的：多半是驱动没装好或 USB 调试没真正开启。先用任意手机助手类软件连一次成功，再回 QtScrcpy 刷新；顺手换根确认能传数据的线。
• 画面正常但点不动：查「USB 调试（安全设置）/ 模拟点击」权限，小米等品牌不打开这项就没法注入触控。
• 能控制但看不到画面：控制台出现shader program is not linked一类错误，说明显卡不支持当前渲染方式。把config.ini里的UseDesktopOpenGL改成1（dx 硬解）或2（opengl 硬解）再试。
• 中文输不进去：手机端装搜狗或 QQ 输入法并设为默认，这类输入法对剪贴板文本的支持最稳。
• 报错Could not open video stream：分辨率设高了，挑个低档位。
• 提示 adb server version 不匹配：电脑上多个程序带着不同版本的 adb 打架。杀掉 adb 进程重来，或在config.ini的AdbPath里指定统一用哪个 adb。
• 画面发虚：Windows 高 DPI 缩放惹的祸。QtScrcpy.exe→ 属性 → 兼容性 → 更改高 DPI 设置 → 缩放行为选「应用程序」。

更多条目在 docs/FAQ.md，里面按 adb 问题、控制问题分类列得很细。

手感调优：config.ini 与快捷键

配置文件在config/config.ini，和手感直接相关的三项：

[common] # 视频解码方式：-1 自动，0 软解，1 dx硬解，2 opengl硬解 UseDesktopOpenGL=-1 # 最大fps（仅支持Android 10以上） MaxFps=0 # 是否渲染过期视频帧（不渲染意味着更低的延迟） RenderExpiredFrames=0

追求操作跟手就把RenderExpiredFrames关掉；卡顿时优先降分辨率，其次才是动解码方式。

常用快捷键，投屏窗口聚焦时生效：

接下来做什么

QtScrcpy 干的事一句话就能说完：把手机屏幕搬到电脑上，让你用鼠标键盘当它的手。现在就能做的三步：下载对应平台的预编译包 → 手机打开 USB 调试并插上线 → 一分钟之内看到第一帧画面。之后想把某款手游改成键鼠操作，照着keymap/里现成的脚本抄一份改，就是自己的第一份映射文件。

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