QtScrcpy:免费开源安卓投屏控制工具,USB 或 WiFi 一连即显,免 root 免装 App,键鼠直接操控手机
【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpy
QtScrcpy 是一款免费开源的安卓投屏软件,通过 USB 或 WiFi 把手机画面实时显示到电脑窗口,鼠标键盘就能直接操作手机,全程免 root,也不用在手机上安装任何 App。Windows、macOS、Linux 三大桌面平台都有现成的预编译版本,新手插上线点两下按钮就能看到画面。最适合想在电脑上玩手游、同时管理多台手机,或者单纯想用大屏看手机内容的人。
它凭什么:图形界面 scrcpy,延迟 35~70ms
技术底座:C++ + Qt + OpenGL + FFmpeg,视频解码走 FFmpeg,渲染走 OpenGL,跨平台由 Qt 统一承担。
和原版 scrcpy 的两个实际差别:原版是纯命令行 + SDL 窗口,参数全靠敲命令;QtScrcpy 换成 Qt 图形界面,启动服务前就能在配置面板里勾选分辨率、码率、录制等参数。原版不支持自定义按键映射,QtScrcpy 补上了 keymap 脚本机制和多设备群控。
官方给出的参考指标:延迟 35~70ms,首帧画面约 1 秒内出现,画质 1920×1080 以上,帧率 30~60fps,且不在设备上安装任何软件。
动手前先自查:平台、连接方式、系统门槛
| 维度 | 现状 | 说明 |
|---|---|---|
| 桌面系统 | Windows / macOS / Linux 全覆盖 | 前两者用 Releases 预编译包(已内置 ADB);Arch Linux 可用yay -Syu qtscrcpy,其他发行版用预编译包或源码编译(编译需 Qt 5.12 以上) |
| 连接方式 | USB 优先,WiFi 可用 | 首次建议走 USB;启动 adbd 后即可拔线无线连,手机与电脑需在同一局域网 |
| 设备门槛 | Android 5.0 及以上(API 21) | 需开启 USB 调试;小米等机型还需额外打开「USB 调试(安全设置)」的模拟点击权限 |
| 典型用途 | 键鼠玩手游、多设备群控、装包传文件、录屏截图 | 日常投屏零配置;写按键脚本或二次开发才需要碰keymap/目录和源码(可git clone https://gitcode.com/GitHub_Trending/qt/QtScrcpy获取仓库) |
最轻用法只需要完成下面三步的 USB 投屏;群控和键鼠映射脚本属于进阶玩法,需要时再回来翻对应小节即可。
三步跑起来:USB 安卓投屏零基础上手
第一步:装好程序。从项目发布页下载对应系统的预编译版本:Windows 解压后运行QtScrcpy.exe,macOS 拖进「应用程序」,其他 Linux 发行版下载预编译包。通过标准:程序能打开,界面显示设备列表和「刷新设备」「启动服务」按钮。
第二步:手机打开 USB 调试。进入「设置 > 关于手机」,连续点 7 次「版本号」解锁开发者模式;回到「设置 > 系统 > 开发者选项」,打开「USB 调试」。小米等机型还要进「USB 调试(安全设置)」把「允许模拟点击」打开,否则后面能看画面但点不动。通过标准:开发者选项里能看到这些开关均为开启状态。
第三步:连设备并启动。数据线接好,手机上弹出授权弹窗选「允许」;回程序点「刷新设备」,列表出现设备号后点「启动服务」。通过标准:1 秒内投屏窗口出现手机画面,且鼠标点击、键盘输入能直接操作手机。
WiFi 无线连接(进阶):手机和电脑在同一局域网,先按上面 USB 流程连过一次,然后依次点「获取设备 IP」→「启动 adbd」→「无线连接」,再点「刷新设备」,列表会多出一个 IP 开头的设备,选中它点「启动服务」即可。adbd 启动后 USB 线就可以拔掉,之后断线重连不再需要插线。
核心能力拆解:键位映射、群控、装包传文件、剪贴板与录屏
🎮 键位映射:键鼠像玩端游一样玩手游
- 它是干什么的:用 JSON 脚本把键盘按键、鼠标移动映射成手机上的触摸点击、拖拽和方向盘操作,坐标用相对位置描述,换机型也能用。
- 什么时候用:在电脑上打 FPS 手游,或用方向键上下滑动刷短视频。
- 怎么做:仓库自带 keymap/gameforpeace.json(和平精英,WASD 驱动方向盘)和 keymap/tiktok.json(抖音方向键滑动)。写好的脚本放进
keymap/目录 → 点「刷新脚本」→ 选中脚本 → 启动服务后点「应用脚本」→ 按~键进入映射模式,再按一次~切回普通模式。和平精英里用方向盘控制载具时,记得在游戏内把移动方式设为「单摇杆模式」。编写规则参考 docs/KeyMapDes_zh.md。
📱 多设备群控:一次操作,多台手机同步
- 它是干什么的:同时连接多台手机,主控窗口上的鼠标、键盘、音量、返回等操作会同步分发到其余设备,实现由 QtScrcpy/groupcontroller/ 负责。
- 什么时候用:批量测试、多账号运营、课堂演示。
- 怎么做:把所有设备连上并各自「启动服务」,勾选需要同步的设备后,在任一主控窗口操作即可。
拖拽装包与传文件:把 APK 丢进窗口就完事
- 它是干什么的:把 APK 拖进投屏窗口即触发安装;把普通文件拖进窗口即推送到手机,执行结果会打印在控制台。
- 什么时候用:调试自签包、往手机塞素材或日志。
- 怎么做:拖放即触发,无需额外命令;文件默认落到
/sdcard/,想换位置改config/config.ini里的PushFilePath(路径要以/结尾)。
📋 剪贴板同步与录屏:Ctrl+C / Ctrl+V 双向搬文案
- 它是干什么的:电脑和手机剪贴板双向同步,外加屏幕录制与截图。
- 什么时候用:在电脑与手机之间来回搬文案;录屏留档。
- 怎么做:
Ctrl+C把手机剪贴板复制到电脑;Ctrl+Shift+V把电脑剪贴板注入手机;Ctrl+V以文本事件方式粘贴(暂不支持非 ASCII 字符,这三个快捷键要求 Android 7 以上)。录制在启动前的配置面板勾选,格式可选 mp4 或 mkv(默认 mp4),并自定保存路径;勾选「后台录制」则只录不显示画面,再配合「息屏」选项还能关掉手机屏幕省电。Android 10 以上还能把手机扬声器声音同步到电脑播放(基于 sndcpy)。
画面不顺就调这几个参数:分辨率、码率、帧率、解码
- 最大边长(启动配置面板):投屏画面最长边的分辨率档位,可选 640 / 720 / 1080 / 1280 / 1920 /「原始」,默认 1080。越小越流畅省算力,越大越清晰。
- 码率(启动配置面板):默认 2Mbps,单位可切 Mbps/Kbps。越高细节越多,弱网下别拉太高。
- MaxFps(
config/config.ini):帧率上限,0表示不限制,只对 Android 10 以上生效;想压帧省电设30或60。 - UseDesktopOpenGL(
config/config.ini):解码渲染方式,-1自动、0软解、1DX 硬解、2OpenGL 硬解;界面里另有 FFmpeg 与 VideoToolbox(仅 Apple Silicon 的 macOS)两种解码器可选。
最小可用配置:
[common] PushFilePath=/sdcard/ MaxFps=0 UseDesktopOpenGL=-1 RenderExpiredFrames=0三组场景预设:
- 手游操作:最大边长 720 + 码率 2Mbps + MaxFps 60,跟手优先。
- 看文档看视频:最大边长 1080 + 码率 2Mbps + 不限帧,清晰度优先。
- WiFi 信号一般:最大边长 720 + 码率 1.5Mbps + MaxFps 30,流畅优先。
出问题照这个查:设备不识别、点不动、黑屏排查
现象:刷新设备列表后一台设备都没有。先怀疑:数据线和 USB 口,手机上确认 USB 调试开关和授权弹窗是否处理过。修法:换一根线、换一个口;仍不行就先用手机助手软件连一次,成功后再回程序刷新。
现象:画面正常,但点了没反应。先怀疑:手机品牌,小米等机型需要额外权限。修法:打开「USB 调试(安全设置)」里的「允许模拟点击」,然后「停止服务」重连。
现象:窗口黑屏,控制台打印shader program is not linked。先怀疑:显卡驱动或显卡不支持当前渲染方式。修法:把config/config.ini的UseDesktopOpenGL从-1改成1或2,重启程序。
现象:控制台报Could not open video stream,或画面明显发虚。先怀疑:最大边长选得超过设备或网络承受能力。修法:把分辨率调低一档再启动;Windows 上还可在 QtScrcpy.exe「属性 > 兼容性 > 更改高 DPI 设置」里把高 DPI 缩放行为设为「应用程序」,并把投屏窗口拉大到接近手机实际分辨率(Ctrl+W去黑边)。
更多问题(如和平精英上下车后触摸失效需连按两次~恢复、中文输入要在手机端装搜狗/QQ 输入法)都写在 docs/FAQ.md 里。
新手路线与深入方向
先把上面三步的 USB 投屏跑通,确认键鼠能正常操控手机,再按需求探索 WiFi 无线连和~键位映射。想深入有两个方向:照着 docs/KeyMapDes_zh.md 的编写规则给keymap/目录写自己的 JSON 脚本;或者研究 QtScrcpy/ 下的源码,看 Qt 信号槽机制怎么做视频渲染和群控分发。调参数最快的试错方式永远是:改一处 → 重启程序 → 对照观察。
【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpy
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考