企业官网建设流程全解析

QtScrcpy：免费安卓投屏控制，USB 插线 1 秒出画面

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

QtScrcpy 是一款免费开源的安卓投屏控制工具：手机通过 USB 或同局域网连接，屏幕实时显示在电脑窗口里，直接用键鼠操作，无需 root、手机上不装任何软件。Windows、macOS、Linux 三个平台都有预编译版，启动服务后 1 秒内出第一帧画面，官方参考延迟 35~70ms。适合想在电脑上玩手游的人、需要批量管理多台设备的人，以及单纯想用大屏看手机内容的普通用户。

QtScrcpy 和 scrcpy 差在哪

QtScrcpy 是对 Genymobile 的 scrcpy 用 C++ + Qt + OpenGL + FFmpeg 的复刻重构：投屏原理相同，实现全换，差别集中在三点。

两者性能参考值一致：延迟 35~70ms、30~60fps、1920×1080 以上画质、1 秒内首帧，投屏窗口只显示设备屏幕本身、无多余边框；QtScrcpy 额外补上了多设备连接与批量操作能力。

开跑前确认这几项

分流：只想把画面弄上电脑，做到下一章三步即可；想键鼠玩手游或批量控制多台设备，才需要翻能力章的按键映射和群控。

把手机画面弄上电脑的 3 步

第一步：拿到程序。从项目发布页下载对应系统的预编译包并运行（Windows 解压后运行QtScrcpy.exe，macOS 拖进应用程序）。 ✅ 这步做对了的样子：程序打开，能看到设备列表区域和「启动服务」按钮。

第二步：打开 USB 调试。手机进「设置 > 关于手机」，连点「版本号」7 次解锁开发者选项，再到「开发者选项」里打开「USB 调试」。 ✅ 这步做对了的样子：插数据线后手机弹出调试授权弹窗，点「允许」。

第三步：连接并启动。点「刷新设备列表」，设备号出现后点「启动服务」。 ✅ 这步做对了的样子：投屏窗口 1 秒内出现手机画面，鼠标点击能操作手机。

有线跑稳后再切无线：手机与电脑连同一局域网，依次点「获取设备 IP」→「启动 adbd」→「无线连接」，刷新设备列表会出现一个 IP 开头的设备，选中它再「启动服务」。adbd 启动后 USB 线即可拔掉，之后断开重连直接无线。

它干的 4 件核心事

自定义按键映射：键鼠玩 FPS 手游

• 能干啥：把键盘鼠标映射成屏幕点击、拖拽、方向盘操作。脚本是 JSON 文件，keymap/目录自带和平精英gameforpeace.json和抖音tiktok.json两套方案。
• 用在哪儿：像端游一样键鼠玩和平精英，或用方向键刷短视频。
• 怎么做：脚本放入 keymap/ 目录 → 点「刷新脚本」→ 选中脚本 → 启动服务后点「应用脚本」→ 按~进入映射模式，再按一次切回普通控制；玩和平精英记得把游戏里载具设置改成单摇杆模式。编写规则见 按键映射文档。

多设备群控：一处操作分发到所有设备

• 能干啥：同时连接多台手机，主控窗口上的鼠标、键盘、音量、返回操作同步分发到其余设备。
• 用在哪儿：批量测试、多账号运营、课堂演示。
• 怎么做：把所有设备连上并各自启动服务，点设备工具条上的群控按钮指定主控与同步对象；分发逻辑在群控源码里。

拖拽装包与传文件

• 能干啥：APK 拖进投屏窗口即触发安装；普通文件拖进窗口推送到手机，默认存/sdcard/，可在config/config.ini的PushFilePath改。
• 用在哪儿：调试自签包、往手机塞素材和日志。
• 怎么做：拖放即触发，不用敲命令，控制台打印执行结果。

剪贴板同步与录制

• 能干啥：Ctrl+C把手机剪贴板复制到电脑，Ctrl+Shift+V把电脑文本注入手机，Ctrl+V以文本事件粘贴（不支持非 ASCII 字符）；支持前台/后台录屏和截图。
• 用在哪儿：两端来回搬文案、录屏留档。
• 怎么做：录制比特率、分辨率、格式、保存路径在启动服务前的「启动配置」区设置；勾「仅后台录制」可以不开画面只录屏。

参数怎么调、坏了怎么救

先给四个决定"清晰、流畅、省电"取舍的参数，都在一处生效：

# config/config.ini MaxFps=0 RenderExpiredFrames=0 UseDesktopOpenGL=-1

再给 5 条高频故障，每条都是可执行动作：

1. 刷新设备列表后一台设备都没有→ 先怀疑数据线和 USB 口；依次试：换线换口、确认手机 USB 调试开关与授权弹窗；仍无设备就用任意手机助手软件连一次成功再回来刷新；报adb server version doesn't match是多版本 adb 冲突，任务管理器结束 adb 进程，或在config/config.ini的AdbPath里指定你要用的 adb。
2. 画面正常，点了没反应→ 先怀疑手机品牌（小米等需要额外权限）；依次试：打开「USB 调试（安全设置）」里的允许模拟点击，停止服务后重连。
3. 能操作手机，窗口黑屏，日志报 shader program is not linked→ 先怀疑显卡不支持当前渲染方式；依次试：把config/config.ini的UseDesktopOpenGL从 -1 改成 1 或 2，重启程序。
4. 启动报 Could not open video stream，或画面明显发虚→ 先怀疑分辨率选得超过设备或网络承受力；依次试：max size 降一档；Windows 下仍发虚就设「QtScrcpy.exe 属性 > 兼容性 > 更改高 DPI 设置」为应用程序缩放，或放大窗口、Ctrl+W去黑边。
5. 无法输入中文→ 先怀疑手机端输入法；给手机装搜狗或 QQ 输入法即可输入中文。

其余问题（比如和平精英上下车失效要连按两次~恢复）见 docs/FAQ.md。

跑通之后想深入有两个方向：照着按键映射文档给keymap/目录写自己的 JSON 脚本，或者读QtScrcpy/目录源码看 Qt + 异步信号槽怎么做视频渲染与群控分发。参数拿不准时，改一处 config/config.ini、重启程序、对照观察，就是最快的试错方式。

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