QtScrcpy:3步把安卓手机投屏到电脑,免root低延迟投屏控制
【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpy
你在电脑上打手游,手指在6寸屏幕上又瞄不准又累;运营多个账号时,来回切手机复制粘贴效率极低。QtScrcpy 是一款免费开源的安卓投屏控制软件,通过 USB 或 WiFi 把手机画面实时显示到电脑,并用键鼠直接操作:延迟35~70ms,启动后1秒内看到第一帧画面,全程无需 root,也不在手机上安装任何软件。
项目定位与适用人群
QtScrcpy 基于 Google 开源的 scrcpy 用 C++ + Qt 重构,覆盖 Windows、macOS、Linux 三大平台,专注"只显示设备屏幕 + 低延迟"的轻量投屏控制体验。
- 🎮手游玩家:键盘鼠标接管手机,像玩端游一样打和平精英
- 测试工程师:同时连接多台设备,一键批量同步操作
- 日常用户:大屏幕上刷手机、录屏、截图,电脑手机剪贴板互通
- Qt 学习者:C++/Qt/OpenGL/FFmpeg 全栈音视频实战代码
Windows 平台主界面:左侧面板完成设备连接与服务控制,右侧窗口实时显示手机画面
从零跑通
按下面顺序操作,每一步都给你明确的"成功标志":
- 打开手机开发者选项:设置 > 关于手机连点版本号 7 次,再进开发者选项开启"USB调试";小米等机型还要开启"USB调试(安全设置)",否则有画面但点不动。
- 获取程序:Windows/macOS 用户直接下载预编译包解压即可运行;Linux Arch 用户执行
yay -Syu qtscrcpy;从源码构建则执行:
git clone --recurse-submodules https://gitcode.com/GitHub_Trending/qt/QtScrcpy- 连接设备:USB 线连接手机并在手机上授权"允许 USB 调试"。
- 刷新设备列表:点击界面"刷新设备",看到设备序列号出现即识别成功。
- 启动服务:点击"启动服务",约 1 秒后窗口出现手机画面、鼠标可点击手机,投屏控制就绪。
设备要求:安卓 5.0(API 21)及以上。
核心场景实战
键鼠接管手机:像玩端游一样玩手游
解决什么:FPS 手游靠手指操作,屏幕太小、瞄不准。内置映射脚本把键盘键位映射为屏幕触摸点,鼠标移动映射为视角拖动。
操作步骤:
- 连接设备并启动服务
- 点击"刷新脚本",加载 keymap/ 目录下的映射文件(自带和平精英
gameforpeace.json、抖音tiktok.json等) - 选中目标脚本,点击"应用脚本"
- 按
~键切换到映射模式,再次按~切回普通控制
⚠️ 提示:映射坐标是相对位置(宽高均为 1 的归一化坐标),不会写脚本时可先在开发者选项中开启"显示指针位置",鼠标单击画面控制台会输出当前 pos,直接填入 JSON 即可。
启用和平精英按键映射后的投屏效果,键鼠控制射击与视角
拔掉数据线:WiFi 无线投屏
解决什么:USB 连接限制活动范围,会议演示、躺沙发刷视频都需要无线化。
操作步骤:
- 先用 USB 线连接手机(建立信任)
- 手机与电脑接入同一局域网,点击"获取设备 IP"
- 点击"启动 adbd"(无线连接的前置条件)
- 拔掉 USB 线,点击"无线连接"
- 再次"刷新设备",选择以 IP 地址开头的设备并启动服务
成功标志:设备列表出现IP:端口形式的设备。此后的连接断开都不再需要 USB 线,除非 adbd 停止运行。
多设备群控:一个窗口指挥多台手机
解决什么:电商多店铺、游戏兼容性测试需要对多台手机重复相同操作。
操作步骤:
- 连接全部设备(USB 与 WiFi 可混用)
- 勾选需要同步的设备
- 点击"启用群控"
- 在任意主控窗口执行操作,所有设备实时响应
多设备群控演示:主控窗口的操作同步到所有勾选的手机
文件与 APK 交换:拖拽即完成
解决什么:电脑和手机之间传文件、装应用还要开文件管理器太麻烦。
- 拖拽
.apk到投屏窗口:直接在手机上安装 - 拖拽任意文件到投屏窗口:发送到设备
PushFilePath配置的路径(默认/sdcard/) - 剪贴板互通:
Ctrl+C复制设备内容到电脑,Ctrl+Shift+V把电脑剪贴板作为文本注入设备(不支持非 ASCII 字符),Ctrl+V同步粘贴
进阶调优与效率提升
📝 所有运行时参数集中在 config/config.ini,改完重启程序生效:
[common] UseDesktopOpenGL=-1 # 视频解码:-1自动 0软解 1dx硬解 2opengl硬解 MaxFps=0 # 最大fps,0为不限(仅Android 10以上生效) RenderExpiredFrames=0 # 0=跳过过期帧,延迟更低| 参数 / 快捷键 | 含义 | 推荐取值 |
|---|---|---|
UseDesktopOpenGL | 视频渲染方式,显卡兼容问题时首查项 | -1(自动),卡则改1或2 |
MaxFps | 帧率上限,限制帧率可降低手机发热 | 游戏场景60 |
RenderExpiredFrames | 是否渲染过期视频帧,影响延迟 | 0 |
AdbPath | 指定 adb 可执行文件路径 | 电脑 adb 版本冲突时填写 |
Ctrl+F/Cmd+F | 切换全屏 | 演示时 |
Ctrl+W | 调整窗口去除黑边 | 日常投屏 |
Ctrl+H/Ctrl+B | 模拟主页 / 返回键 | 快速导航 |
Ctrl+O | 关闭手机屏幕但保持投屏 | 省电 |
高频问题自检
| 现象 | 原因 | 解法 |
|---|---|---|
| 刷新设备列表无设备 | 驱动或授权未就绪 | 先用任意手机助手软件连接成功一次,再回 QtScrcpy 刷新 |
| 有画面但无法控制 | 未开启"USB调试(安全设置)" | 开发者选项中打开该项(小米等机型必需) |
| 无法输入中文 | 手机端缺中文输入法 | 安装搜狗/QQ 输入法并设为默认 |
| 可控制但看不到画面 | 显卡不支持当前渲染方式 | config.ini中UseDesktopOpenGL改为1或2 |
adb server version doesn't match | 电脑存在多版本 adb 进程 | 任务管理器结束 adb 进程,或配置AdbPath |
Could not open video stream | 编码流异常,多因分辨率过高 | 在启动配置中降低分辨率 |
| 和平精英上下车后操作失效 | 游戏切换界面导致触摸点失效 | 连续按两次~键恢复映射 |
更多场景见 docs/FAQ.md。
文档与扩展
- docs/KeyMapDes_zh.md:按键映射 JSON 的完整字段规则,覆盖点击、拖拽、方向盘五种映射类型
- keymap/:内置映射脚本目录,可直接抄改为自己的游戏
- docs/DEVELOP.md:源码编译与开发环境搭建说明
- docs/TODO.md:项目后续功能规划
下一步
回到开篇的痛点:小屏瞄不准、多机来回切——现在把手机插上线,按"刷新设备 → 启动服务"跑通第一帧投屏,再打开一个keymap/里的脚本按~启用,键鼠接管手游。提示:首次使用务必确认开发者选项里的"USB调试(安全设置)",它是"有画面却点不动"这类问题的最常见根源。
【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpy
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考