QtScrcpy：30 秒连上手机的安卓投屏完整实操指南

QtScrcpy：30 秒连上手机的安卓投屏完整实操指南

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

QtScrcpy 是一款免费开源的安卓投屏软件，把手机画面实时显示到电脑上，还能用鼠标键盘直接操作手机。它最大的卖点是快：延迟低至 35~70 毫秒，启动后大约 1 秒就能出第一帧画面。无需 root，Windows、macOS、Linux 全平台可用。

30 秒连上第一台手机

准备工作只做一件事：在手机上打开"设置 > 关于手机"，连续点击"版本号"7 次激活开发者模式，再回到"设置 > 系统 > 开发者选项"，开启USB 调试和USB 调试（安全设置）。

然后按你的系统选择安装方式：

• Windows：下载 Releases 里的压缩包，解压，双击QtScrcpy.exe。
• macOS：下载 DMG 文件，把应用拖进"应用程序"文件夹。
• Linux：Arch 用户在终端敲yay -Syu qtscrcpy；其他发行版下载 Releases 预编译包。

装好后：

1. 用数据线连接手机，手机上点"允许 USB 调试"。
2. 打开程序，点刷新设备列表，列表里出现你的设备。
3. 选中设备，点启动服务——画面出来了，鼠标点投屏窗口就能操作手机。

想从源码构建：git clone --recurse-submodules https://gitcode.com/GitHub_Trending/qt/QtScrcpy，然后按 构建文档 装好 Qt 5.12+ 即可。

按场景拆解玩法

手游搬上大屏：投屏 + 按键映射

这个场景你能做到：用键盘 WASD 开车、Q/E 探头，完整键盘化操作手游。

以《和平精英》为例：

1. 连接设备并点启动服务，进入游戏画面。
2. 点刷新脚本，列表会加载keymap/目录下的映射文件，选中gameforpeace.json。
3. 点应用脚本激活映射。
4. 按~键（1 左边的键）切换进映射模式，WASD 控制方向，再按一次~退出。
5. 按键位置不准时，参考 按键映射说明 里的坐标调试方法校准。

内置了抖音、和平精英等预设方案，都在 按键脚本目录 里。

日常办公与演示：拖文件、贴文本

这个场景你能做到：不装任何手机助手，文件和文本直接在电脑手机之间流动。

1. 装应用：把一个 APK 文件直接拖进投屏窗口，自动安装。
2. 传文件：任意文件拖进投屏窗口，自动发送到手机/sdcard/目录。
3. 复制手机里的文字：在手机上选中文字后，电脑上按Ctrl + C（macOS 为Cmd + C），手机剪贴板内容就到了电脑。
4. 把电脑文字发到手机：按Ctrl + Shift + V把电脑剪贴板同步到手机，再按Ctrl + V在输入框粘贴。

注意：中文粘贴需要手机装搜狗或 QQ 输入法并设为默认，Ctrl + V本身不支持非 ASCII 字符。

多设备批量操作：群控

这个场景你能做到：在主控窗口操作一次，所有勾了群控的设备同时响应，适合电商运营和游戏测试。

1. 把多台设备连上电脑（USB 和 WiFi 混连都行），逐一启动服务，每个设备会弹出独立投屏窗口。
2. 在每个要同步的设备窗口上勾选群控。
3. 在其中任意一个窗口做鼠标点击、键盘输入，所有从机设备实时同步。
4. 想退出就取消勾选，或点停止全部服务一次断开所有设备。

调优与快捷键

配置文件在 config/config.ini，最常动的就这三项：

# 解码方式：-1 自动，0 软解，1 dx 硬解，2 opengl 硬解 UseDesktopOpenGL=-1 # 最大 fps（仅 Android 10 以上，0 为不限） MaxFps=0 # 跳过过期帧，延迟更低 RenderExpiredFrames=0

按用途选参数：

快捷键分三组，Windows 用Ctrl，macOS 把Ctrl换成Cmd：

• 窗口：Ctrl + F全屏；Ctrl + W去黑边；Ctrl + G1:1 像素显示
• 设备：Ctrl + H回主页；Ctrl + B返回；Ctrl + P锁屏
• 剪贴板：Ctrl + C复制手机内容到电脑；Ctrl + Shift + V电脑内容到手机；Ctrl + V粘贴

出问题了先看这里

Q：刷新设备列表后看不到手机？

1. 确认开发者选项里 USB 调试和安全设置都开了。
2. 先用任意手机助手软件连接一次（让驱动装好），再回来刷新。
3. 还不行就重启 adb：在 adb 所在目录执行adb kill-server再adb start-server。

Q：投屏画面卡顿？

1. 把分辨率降到 720P（点启动配置里设置）。
2. WiFi 用户切到 5GHz 频段。
3. 显卡支持的话把UseDesktopOpenGL改成 1 或 2 试硬解。

Q：中文输不进去？

1. 手机安装搜狗或 QQ 输入法。
2. 设为默认输入法。
3. 重启 QtScrcpy 重新启动服务。

Q：能控制但看不到画面？

1. 控制台大概率报 shader 相关错误，是显卡不支持当前渲染方式。
2. 打开config/config.ini，把UseDesktopOpenGL从-1改成1。
3. 无效就改成2，再不行更新显卡驱动。

还能往深里玩

• 自定义按键脚本：照着 keymap/gameforpeace.json 的 JSON 结构写自己的规则，丢进keymap/目录即可加载。
• 界面定制：UI 集中在 QtScrcpy/ui/，Qt Designer 打开.ui文件就能改布局。
• 自动化集成：侧栏有adb command输入框，可执行自定义 ADB 命令接进你的自动化流程。

QtScrcpy 把手机变成电脑的外设，从 1 秒出画面开始就没什么使用门槛。git clone https://gitcode.com/GitHub_Trending/qt/QtScrcpy拿源码，或直接下载预编译版——现在就把数据线插上，30 秒后手机上就能看到你的屏幕。

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