10分钟从USB投屏到多设备群控QtScrcpy跨平台Android投屏与键鼠控制完整指南【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpy手机上发现一个应用 bug屏幕太小看不清界面切回电脑复制一行文本又要重新解锁——这类来回折腾就是 Android 投屏控制软件要解决的问题。QtScrcpy 是一款免费的开源工具通过 USB 或 WiFi 把 Android 手机实时投射到 Windows、macOS、Linux 电脑上让鼠标键盘直接操控手机无需 root手机端也不安装任何 App。一、连接前准备一台手机加三个检查项1. 手机需要满足的条件系统版本Android 5.0 及以上API 21在设置 → 开发者选项里打开USB 调试这是投屏的前提部分品牌如小米还需要在 USB 调试里额外勾选允许模拟点击否则会出现看得到画面、点不动手机的情况。2. 三个平台各自的安装方式| 平台 | 方式 | | -- | -- | | Windows / macOS | 从 Releases 下载预编译包已内置 ADB解压即用 | | Arch Linux | 终端执行yay -Syu qtscrcpy| | 其他 Linux 发行版 | 下载 Releases 的预编译包 |Windows 和 macOS 的包都自带依赖装完不用配环境。3. USB 秒连的第一步用数据线连上手机打开程序点刷新设备列表看到设备号出现后点启动服务约1 秒就能看到第一帧画面。投屏性能指标是 30~60 fps、1920×1080 及以上分辨率、35~70 ms 延迟日常看文档、演示操作完全够用。二、从 USB 切到无线拔线投屏的操作顺序无线投屏适合经常走动演示的场景老师讲课时不用被数据线拴在讲台产品经理在会议室边演示边走动。1. 无线连接四步走前提手机和电脑在同一局域网。先用 USB 连上手机点刷新设备列表点获取设备 IP地址会自动填到无线区域点启动 adbd再点无线连接再次刷新设备列表会出现一个 IP 开头的设备选中它点启动服务。2. 什么时候需要重新插线启动 adbd 之后USB 线就可以拔掉之后无线断开、重连都不需要再插线除非手机重启导致 adbd 停止。如果长时间连不上重启路由器并确认防火墙没有拦截相关端口。三、投屏之后控制、录制、传文件三件事1. 用鼠标键盘操作手机左键点击 触摸鼠标移动 手指拖动右键双击屏幕关闭时开屏开启时相当于返回中键单击 主页键Ctrlb也是返回Ctrls是应用切换Ctrln/CtrlShiftn展开、收起通知栏音量Ctrl↑调大、Ctrl↓调小Ctrlp模拟电源键Ctrlo关屏但保持投屏主播做直播演示时这个组合很实用——手机屏常亮会明显增加耗电窗口技巧Ctrlf全屏Ctrlg按 1:1 像素显示UI 走查时推荐Ctrlw或左键双击黑边去掉黑边剪贴板双向同步Ctrlc把手机剪贴板拷到电脑CtrlShiftv把电脑剪贴板注入手机Android 7 以上。2. 屏幕录制与截图启动配置里可以设置录像的比特率、分辨率、录制格式和保存路径。需要只看手机不显示画面时勾选仅后台录制即可静默录屏适合录 bug 复现步骤勾选窗口置顶则让视频窗口始终浮在最上层边演示边开其他软件。截图一键存为 PNG。3. 拖拽装 APK 和传文件把 APK 文件拖到投屏窗口自动触发安装把任意文件拖进窗口会推送到手机端路径默认/sdcard/可在config/config.ini的PushFilePath里改。测试同学拿一台电脑就能装包、传测试数据不用来回插线拔线。四、把手游玩出端游手感按键映射怎么配1. 直接用现成脚本keymap/目录自带和平精英、第五人格、抖音等映射文件覆盖开火、探头、方向盘、滑动等高频操作。启用流程在脚本下拉框选中脚本连接手机并启动服务后点应用按~键即switchKey切到自定义映射模式再按一次切回普通模式玩和平精英想用车载方向盘记得在游戏里把移动方式设为单摇杆模式。2. 自己写一份 JSON 映射映射文件是 JSON放进keymap/目录即可被识别编写规则见 按键映射说明。三个核心概念相对坐标屏幕宽高都用 1 表示(0.5, 0.5)就是屏幕正中换分辨率也不用改文件mouseMoveMap把鼠标移动映射为手指拖动FPS 游戏用它转视角speedRatioX/speedRatioY调灵敏度数值越大越迟钝keyMapNodes普通按键映射支持单击、双击、多连点、拖拽dragSpeed范围 0-1、四键方向盘KMT_STEER_WHEEL几种类型。写完点刷新脚本选中新脚本再应用即可生效。3. 坐标对不准时怎么调试两个办法左键单击屏幕控制台会打印当前点击的pos直接抄进 JSON或者在开发者选项里打开显示指针位置看触摸点坐标。五、群控落地多台设备同时操作的流程1. 群控怎么用QtScrcpy 支持多设备连接左侧设备列表可以同时挂多台手机每台一个独立窗口单独操作开启群控后你的鼠标键盘输入会同步到所有已连接设备一次操作、多台生效。2. 典型批量场景应用测试同一版本 App 装到不同机型同步滑动页面观察兼容性差异设备初始化新手机批量打开开发者选项、装统一的应用套件直播多号一台电脑同时看几路画面主号操作时副号跟着动。3. 配合命令行做辅助界面里的命令行框可以直接执行自定义 ADB 命令暂不支持shell这类阻塞命令配合启动服务 / 停止所有服务就能搭出连上 → 装包 → 群控 → 断开的批量流程。六、连接不上、画面卡、控制失效逐项排查问题基本集中在连接和画面两类对照 常见问题 自查最快。1. 连接类刷新后看不到设备先用任意手机助手验证数据线能正常通信再回来刷新adb server version doesnt match电脑里同时跑了两个版本的 adb。任务管理器结束 adb 进程或在config.ini的AdbPath里指定你正在用的那个 adb报错more than one device在启动配置里去掉使用 Reverse的勾选再试。2. 画面与控制类看得到画面但点不动小米等机型检查 USB 调试里是否开了允许模拟点击中文输入不了手机上装搜狗或 QQ 输入法即可能控制但没画面控制台出现 shader 相关报错时在config.ini把解码方式改成 1 或 2 再试Could not open video stream把分辨率调低一档Windows 下画面发虚在程序属性里把高 DPI 缩放改为由应用程序执行。七、从这里开始动手1. 安装与下载Windows、macOS、Linux 用户直接从 Releases 下载预编译包解压运行Arch Linux 执行yay -Syu qtscrcpy。2. 克隆源码本地编译想研究或二次开发项目基于 C Qt OpenGL FFmpegApache 2.0 协议可以拉取源码git clone --recurse-submodules https://gitcode.com/GitHub_Trending/qt/QtScrcpy需要 Qt 5.12 以上版本Windows 用 Qt Creator 打开CMakeLists.txt编译 ReleaseLinux 执行./ci/linux/build_for_linux.sh Release产物在output/x64/Release细节见 开发文档。3. 下一步建议今天就可以做的三件事USB 连上手机跑通第一帧勾选仅后台录制录一段操作视频把keymap/里的现成脚本应用到你的手游上。QtScrcpy 把投屏、键鼠控制、录制、传文件、群控收敛进一个免费工具里装好即用接下来怎么用取决于你的手机要替你干多少活。【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考