QtScrcpy 实战教程Android 手机投屏与键鼠控制10 分钟上手【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpyQtScrcpy 是一个开源的 Android 投屏工具把手机连到电脑上屏幕上直接显示手机画面用鼠标和键盘就能操作手机。不需要 root也不用在手机上装任何 App支持 Windows、macOS、Linux。本文按先跑通、再用熟、最后排错的顺序走USB 首连 → 无线连接 → 日常操作 → 按键映射 → 批量控制 → 常见故障处理。安装 QtScrcpy三个平台怎么装普通用户建议直接下载官方 Releases 里的预编译包依赖含 ADB都打好了解压即用Windows / macOS下载对应平台的压缩包解压后运行主程序LinuxArch可用 AUR 安装yay -Syu qtscrcpyLinux其他发行版用预编译包或按 README 的 Build 章节自行编译需要 Qt 5.12 以上如果你需要源码一条命令克隆含子模块git clone --recurse-submodules https://gitcode.com/GitHub_Trending/qt/QtScrcpy预期结果本地得到完整项目含keymap/按键映射、config/配置、docs/文档等目录。第一次 USB 投屏4 步看到画面手机端先做两件事设置 → 关于手机连点版本号7 次解锁开发者选项然后在开发者选项里打开USB 调试。接着按顺序操作USB 线连接手机和电脑手机上出现允许 USB 调试弹窗点允许打开 QtScrcpy点左侧刷新设备Refresh devices设备列表出现设备编号后选中它点启动服务Start service约 1 秒内视频窗口出现手机画面。此时移动鼠标、左键点击手机会同步响应。判断成功的标准能打开一个 App 并滑动界面。WiFi 无线连接拔掉 USB 线的 6 步无线投屏的原理先用 USB 建立信任连接再启动手机上的 adbdADB 的网络版调试服务之后走 WiFi 传输画面。前提手机和电脑连同一个 WiFi。别急这一步最关键按钮顺序不能乱USB 连好点刷新设备确认设备出现点获取设备 IPIP 和端口会自动填进无线区域点启动 adbd拔掉 USB 线启动 adbd 后就不需要数据线了点无线连接再点一次刷新设备列表里会多出一台带 IP 地址的设备选中这台带 IP 的设备点启动服务看到画面后后续流程与 USB 完全一致。日常操作快捷键与拖拽传文件投屏窗口里的操作大部分有快捷键Windows 用 CtrlmacOS 对应为 Cmd全屏CtrlF窗口 1:1 像素显示CtrlGHome 键CtrlH返回CtrlB多任务CtrlS音量Ctrl↑ / Ctrl↓熄屏但继续投屏CtrlO展开/收起通知栏CtrlN / CtrlShiftN剪贴板同步Android 7 以上CtrlC把手机剪贴板拷到电脑CtrlShiftV把电脑剪贴板写到手机CtrlV直接把电脑剪贴板文本输入到手机暂不支持非 ASCII 字符。两个拖拽操作很实用注意它们没有确认弹窗把一个 apk 拖进视频窗口 → 自动安装到手机把任意文件拖进视频窗口 → 传输到手机的/sdcard/键鼠映射用键盘鼠标玩手游按键映射就是一个 json 文件把键盘按键对应到手机屏幕上的触摸位置。项目自带和平精英、抖音两套现成映射放在 keymap/ 目录。使用步骤界面映射区点刷新脚本选中目标脚本启动服务后点应用按~键映射里默认的 SwitchKey切到自定义映射模式再按一次~切回普通鼠标控制要自己写映射先拿坐标在投屏窗口里左键点一下屏幕控制台会打印出这个位置的 pos 值直接抄进 json 即可完整编写规则点击、双击、多点、拖拽、方向盘五种类型见 docs/KeyMapDes_zh.md最小示例看 keymap/test.json。群组控制一套操作同步多台手机同时连接多台手机USB 或无线都行分别启动服务后群组控制模式下操作任意一台的窗口点击、滚轮、快捷键会同步发到所有已连接的手机。适合批量跑测试、批量装应用、多台设备同时录屏这类场景。避坑指南6 个高频故障的处理报错 adb server version 不匹配原因电脑里同时跑着不同版本的 ADB。 处理任务管理器结束 adb 进程或在 config/config.ini 里把AdbPath指到你当前用的 adb。USB 插着刷新后列表里没有设备原因驱动没装好电脑不认手机。 处理先用任意手机助手连一次成功后回 QtScrcpy 再刷新设备。画面正常但鼠标控制不了手机原因部分机型如小米的模拟点击权限是单独开关。 处理开发者选项里打开USB 调试安全设置。画面发虚文字尤其糊原因Windows 高 DPI 缩放在干扰渲染。 处理右键 QtScrcpy.exe → 属性 → 兼容性 → 更改高 DPI 设置选由应用程序执行缩放同时把视频窗口拉大。能控制但看不到画面控制台报 shader program is not linked原因显卡不支持当前视频渲染方式。 处理把 config.ini 里UseDesktopOpenGL改成 1 或 2 再试。报错 Could not open video stream原因设定分辨率超出设备能力。 处理在启动配置里选一个更低的分辨率。以上都解决不了先看 docs/FAQ.md再带上控制台日志去仓库提 Issue。进阶方向三个值得深挖的点调参config/config.ini里的关键项——MaxFps0 为不限制帧率、RenderExpiredFrames跳过过期帧可降低延迟、CodecName指定设备的 H.264 编码器。写自己的映射按 docs/KeyMapDes_zh.md 的格式写 json 放进 keymap/刷新脚本即可使用。读懂原理docs/DEVELOP.md 讲清了客户端—服务器架构服务器被推到手机上把屏幕编码成 H.264 流发回客户端解码渲染适合想改代码或自己编译的人。预编译包与源码项目 gitcode 仓库的 Releases 页常见问题docs/FAQ.md按键映射规则docs/KeyMapDes_zh.md问题反馈在仓库开 Issue附控制台日志【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
