QtScrcpy 实操笔记从 USB 投屏到 50 台设备群控【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpy周五下午三点演示还有十分钟开始你手里的安卓手机却只有 6 寸小屏演示稿里的细节几乎看不清。QtScrcpy 是一款免费开源的 Android 实时投屏控制软件它能在 1 分钟内把手机画面投到电脑上并用键盘鼠标反向操作。这篇文章从第一次打开软件讲起带你走通无线投屏、手游键鼠映射和多台测试机群控。一句话认识 QtScrcpyQtScrcpy 基于开源项目 scrcpy 重构手机端运行推送过去的 scrcpy-server电脑端用 C 和 Qt 框架编写FFmpeg 解码 H.264 视频流、OpenGL 负责渲染投屏帧率 30~60fps、延迟 35~70ms。它支持 Windows、macOS、Linux 三大桌面平台不需要 root也不会在手机上安装任何常驻软件项目采用 Apache 2.0 协议开源。知道了它是什么下面解决的是怎么把它跑起来。第一次投屏从安装到首帧画面安装Windows 和 macOS 下载 Releases 里的预编译版本解压即可运行包内已带 ADBArch Linux 执行yay -Syu qtscrcpy其他发行版用预编译包。开启 USB 调试手机设置 → 关于手机里连续点击版本号 7 次进入开发者选项打开USB 调试。USB 连接数据线连接手机主界面点击刷新设备列表选中设备再点击启动服务1 秒内出现首帧画面。上图是 Windows 平台下的 QtScrcpy 主界面左侧为设备列表与控制面板每台设备对应一个独立的投屏窗口可自由排列。 这一步容易踩坑刷新后设备列表为空多半是驱动问题先装任意手机助手让驱动装好再回来刷新即可如果报adb server version doesnt match说明机器上存在多个 adb 版本在任务管理器里结束 adb 进程后重试。画面投出后验证最小流程用鼠标点一下手机屏幕上的位置、用键盘敲入一段文字、按Ctrl C把手机选中文字复制到电脑。三步都通过说明环境已完全跑通。USB 通了之后下一步需求通常是把线拔掉。无线投屏的三步配置前提手机和电脑在同一局域网内。仍用 USB 线连接手机刷新设备列表点击获取设备 IPIP 会自动填入无线连接区域点击启动 adbd再点击无线连接再次刷新设备列表选中 IP 开头的新设备点击启动服务完成。 先别急着拔线等无线连接成功、画面稳定后再拔。adbd 启动一次后后续重启软件都不需要再插 USB直到手机端重启才会失效。用键盘鼠标玩手游QtScrcpy 的键鼠映射机制可以把键盘按键、鼠标移动映射成手机屏幕上的触摸位置。映射文件是 JSON 格式keymap/ 目录已内置多款热门游戏配置和平精英gameforpeace.json、第五人格identityv.json、抖音tiktok.json等。使用步骤使用内置预设可跳过此步自定义脚本需把 JSON 文件放入keymap/目录主界面点击刷新脚本并选中对应脚本启动服务后点击应用脚本按~键脚本中定义的 switchKey切换到映射模式再按一次恢复普通控制。上图是启用和平精英映射后的效果开火、切枪、跳跃、地图等按钮全部对应到键盘按键鼠标移动用来控制人物视野操作逻辑接近端游。自己写映射文件时注意两条规则坐标一律用相对位置屏幕宽高都归一化为 1同一份文件在不同分辨率设备上都能准确定位鼠标映射的speedRatio参数控制视角灵敏度数值越大灵敏度越低。完整语法见 docs/KeyMapDes_zh.md。多设备群控做应用兼容性测试或批量部署时QtScrcpy 支持同时连接多台设备每台设备一个独立投屏窗口开启群控后同一操作会同步下发到所有已连接设备——原本逐台操作的 50 台测试机一次配置同步完成。上图是群控演示多个设备窗口显示相同画面在任一窗口执行的操作会实时复现到其他设备上。配合两个实用项启动设置里勾选自动息屏服务启动后自动关闭设备屏幕省电也延长测试机电池寿命主界面的 adb 命令框可以直接输入 adb 指令在设备上执行批量装包、批量执行命令都不用离开界面。录制、截图与文件传输这组功能开箱即用屏幕录制在启动配置里设置比特率、分辨率、格式和保存路径勾选后台录制可不打开投屏窗口静默录制截图一键导出当前帧为 PNG安装 APK把 APK 拖到投屏窗口即触发安装传输文件把任意文件拖到投屏窗口自动推送到设备剪贴板同步Ctrl C手机复制到电脑Ctrl Shift V电脑内容粘贴到手机常用快捷键Ctrl F全屏、Ctrl G1:1 像素显示、左键双击去黑边、中键回主页、右键双击返回。功能够用到这里就够了如果想改代码入口也很明确。从源码到二次开发项目分两端电脑端客户端基于 Qt 信号槽做异步编程解码线程与渲染线程并行工作设备端的 scrcpy-server 是一个启动时推送执行的 jar负责截屏编码与触摸事件注入。关键代码位置界面逻辑QtScrcpy/ui/设备列表、视频窗口、工具表单视频渲染QtScrcpy/render/OpenGL 窗口实现群控调度QtScrcpy/groupcontroller/运行参数config/config.ini语言、解码方式、自定义 adb 路径等自行编译需要 Qt 5.12 以上克隆仓库后用 QtCreator 打开 CMakeLists.txt 编译 Releasegit clone --recurse-submodules https://gitcode.com/GitHub_Trending/qt/QtScrcpyLinux 可直接执行 ci/linux/build_for_linux.sh服务端 APK 需用 Android Studio 编译后替换third_party/scrcpy-server详细说明见 docs/DEVELOP.md。参与方式很直接遇到 bug 或功能建议在项目 Issues 页提交即可代码贡献请把 PR 发往dev分支遵循少量多次、一个功能点一个 PR的原则使用中的疑问可以进项目 QQ 群901736468提问。【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考