QtScrcpy 上手指南:免费开源的安卓投屏控制工具,USB 三步完成连接
【免费下载链接】QtScrcpyAndroid实时投屏软件,此应用程序提供USB(或通过TCP/IP)连接的Android设备的显示和控制。它不需要任何root访问权限项目地址: https://gitcode.com/barry-ran/QtScrcpy
手机插进电脑 USB 口,在 QtScrcpy 里点一下"启动服务",约 1 秒后手机画面就出现在电脑窗口里——这就是这款免费开源的安卓投屏控制工具最基础的用法:投屏与控制并存,不需要 root,也不会在手机上安装任何东西。
QtScrcpy 基于 Genymobile 的 scrcpy 项目,用 C++、Qt、OpenGL 和 FFmpeg 重写,支持 Windows、macOS 和 Linux 三个平台。它的几个硬指标:帧率30~60 fps,分辨率1920×1080 及以上,投屏延迟35~70ms,首帧显示约 1 秒。设备端要求 Android 5.0(API 21)及以上。
把软件装到电脑上:三种系统都有现成方案
大多数用户不需要自己编译,Releases 页面提供了三大平台的预编译包,解压即可运行,Windows 版本还内置了 ADB。想从源码构建的话,流程也不复杂:
git clone https://gitcode.com/barry-ran/QtScrcpy然后按系统执行对应脚本:Windows 运行ci/win/build_for_win.bat,macOS 运行ci/mac/build_for_mac.sh,Linux 运行ci/linux/build_for_linux.sh。
USB 三步完成首次投屏
- 手机上打开开发者选项,启用USB 调试(连续点击"关于手机"里的版本号 7 次可进入开发者选项)
- 数据线连接电脑,在手机上确认 USB 调试授权
- 在 QtScrcpy 中点击刷新设备,设备出现后点击启动服务
画面出来后,鼠标点击和拖拽会直接变成手机上的触摸操作。左侧是设备列表,中间是参数设置区,右侧窗口显示手机画面。启动配置里可以调整比特率、分辨率、录屏格式和视频保存路径,还有几个实用开关:
- 后台录屏:投屏窗口不显示,只在后台录制
- 窗口置顶:投屏窗口始终保持在最上层
- 关闭屏幕:启动后自动熄灭手机屏幕省电,画面照传
- 反向连接:遇到
more than one device报错时可以取消勾选重试
无线连接为什么要先走一次 USB 配对
无线投屏要求手机和电脑在同一局域网,但首次必须借助 USB 完成一次配对,因为要先在手机上拉起 adbd 服务。完整步骤:
- 手机保持 USB 调试开启,插上数据线
- 点击刷新设备,确认设备已出现
- 点击获取设备 IP,再点击启动 adbd
- 点击无线连接,再刷新一次设备,列表里会出现一个带 IP 地址的新设备,选中它
- 点击启动服务,这时可以拔掉数据线了——adbd 起来之后不再需要 USB 保持连接
之后每次连接直接选 IP 设备即可,不必再走 USB。
投屏之外:录屏、传文件和剪贴板同步
录屏:启动配置里选好保存路径和格式后启动服务,画面会持续录制成本地视频;勾上后台录屏则可以边用手机边录,完全不占屏幕。
传文件与装应用:把 apk 文件拖进投屏窗口就触发安装;拖普通文件过去则推送到手机的/sdcard/目录,省去了反复传文件的麻烦。
剪贴板同步(Android 7+ 双向可用):
Ctrl + C:把设备剪贴板内容复制到电脑Ctrl + Shift + V:把电脑剪贴板内容注入到设备Ctrl + V:把电脑剪贴板作为文本输入事件发送到设备
其他常用快捷键:Ctrl + F切换全屏,Ctrl + N展开通知栏,Ctrl + B或右键模拟返回键,Ctrl + O熄屏但保持投屏。完整列表见 README.md 的 Shortcuts 部分。
声音同步方面,仓库的sndcpy/目录提供了基于 sndcpy 的方案(仅 Android 10+):把sndcpy.apk装到设备上,再运行sndcpy.sh(Linux/macOS)或sndcpy.bat(Windows),手机外放声音就会传到电脑。
键鼠玩手游和多设备分组控制
键位映射:把键盘变成游戏手柄
QtScrcpy 内置了键位映射功能,映射脚本是 JSON 格式,放在 keymap/ 目录下就会被自动识别。仓库预置了抖音、《和平精英》等应用的脚本,以和平精英为例,A/D/W/S 四个键映射为屏幕左下区域的方向盘拖拽,Q/E 对应左右探头,鼠标移动映射为视角拖动。
使用流程:把自定义脚本放进keymap/目录 → 点击刷新脚本→ 选中脚本 → 启动服务后点击应用→ 按~键(数字键 1 左边)切入自定义映射模式,再按一次切回普通模式。
自己写脚本不麻烦:脚本里的坐标用相对位置表示,屏幕宽高归一为 1;在投屏画面上按鼠标左键,控制台会直接打印出该位置的坐标,复制进脚本即可。完整的类型说明(单击、双击、多点点击、拖拽、方向盘)参考 docs/KeyMapDes.md。
分组控制:一次操作多台手机
QtScrcpy 支持同时投屏多台设备,分组控制可以把同一份点击、拖动、按键操作批量下发到组内所有手机,适合批量测试、矩阵号管理等场景。
作者另有一款商业版 QuickMirror,支持 500+ 台设备同时投屏、WiFi/OTG 投屏和企业级批量自动化,免费版可投 10 屏,适合有超大规模设备管理需求的用户。
遇到问题时:常见投屏问题排障
| 现象 | 处理方法 |
|---|---|
| 刷新后设备列表为空 | 先用任意手机助手 App 连一次手机(相当于装好驱动),回来再刷新 |
| 有画面但无法控制 | 小米等机型需在 USB 调试里额外打开允许模拟点击 |
| 能控制但无画面 | 多为显卡不支持当前渲染方式,在 config/config.ini 把UseDesktopOpenGL改为1或2 |
报错Could not open video stream | 在分辨率设置里选一个更低的值 |
| adb 版本号不匹配报错 | 在任务管理器结束 adb 进程后重试,或在 config.ini 的AdbPath指向当前使用的 adb |
| 和平精英上下车后映射失效 | 连续按两次~键恢复映射 |
| 无法输入中文 | 手机端安装搜狗或 QQ 输入法 |
config.ini 里几个常用参数长这样:
; 最大帧率(仅 Android 10 以上生效) MaxFps=60 ; 解码方式:-1 自动,0 软解,1 dx 硬解,2 opengl 硬解 UseDesktopOpenGL=-1Windows 上如果画面发虚,多半是高 DPI 缩放问题:在 QtScrcpy.exe 属性 → 兼容性 → 更改高 DPI 设置里选择"由应用程序执行缩放"。更多问题可以先翻 docs/FAQ.md,项目文档入口在 docs/ 目录。
一句话总结:投屏、控制、录屏、传文件、键位映射、多机群控,QtScrcpy 把 scrcpy 的能力装进了一个图形界面里,开源免费,源码就在仓库里,遇到问题也能顺着 docs/FAQ.md 和 README.md 找到答案。
【免费下载链接】QtScrcpyAndroid实时投屏软件,此应用程序提供USB(或通过TCP/IP)连接的Android设备的显示和控制。它不需要任何root访问权限项目地址: https://gitcode.com/barry-ran/QtScrcpy
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考