QtScrcpy 安卓投屏实操手册:3 分钟上手,再到键鼠映射玩手游
2026/8/18 15:15:26 网站建设 项目流程

QtScrcpy 安卓投屏实操手册:3 分钟上手,再到键鼠映射玩手游

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

写代码写到一半要抓起手机回消息、给客户演示 App 只能凑过去看小屏幕、测试机一多就得来回插拔数据线——这些看似琐碎的日常,其实都可以交给同一款工具解决。免费开源、跨 Windows/macOS/Linux 三大平台的安卓投屏控制软件 QtScrcpy,能在不 root、不往手机里装任何 App 的前提下,把手机画面实时搬到电脑上,并用键鼠直接操控。

别看它轻量,硬指标一点不含糊

第一次用的人,多半会被它的"快"惊到:插上数据线点一下连接,1 秒内出第一帧;官方口径的端到端延迟在 35~70ms,刷新率 30~60fps,分辨率支持到 1920×1080 以上。日常操作和轻度游戏几乎感觉不到延迟。😌

维度表现
延迟35~70ms 端到端
帧率30~60fps
画质1920×1080 以上
启动1 秒内看到第一帧
侵入性无,手机端零安装、零残留
平台Windows / macOS / Linux
开源协议Apache 2.0

之所以又快又省电,靠的是一条分工明确的链路:手机端用 MediaCodec 硬件编码压缩画面,经 ADB 通道双向传输,电脑侧由 FFmpeg 解码、OpenGL 调用 GPU 渲染,整体跑在 Qt 信号槽异步模型上,解码、渲染、输入互不阻塞。

这是 QtScrcpy 安卓投屏的主界面,左侧管理设备,右侧实时显示多台手机的投屏画面

第一次上手:三分钟跑通首连

第一步:拿到软件

想自己编译,或直接查看源码,克隆官方仓库即可:

git clone --recurse-submodules https://gitcode.com/GitHub_Trending/qt/QtScrcpy

不想折腾就直接下载官方发布的二进制包,Windows 解压即用;Arch 系 Linux 用户还能一行命令装好:yay -Syu qtscrcpy

第二步:手机开好调试

  1. 打开"设置 → 关于手机",连点"版本号"7 次激活开发者选项;
  2. 进入"开发者选项",打开"USB 调试";
  3. 小米等部分机型还要打开"USB 调试(安全设置)"或"允许模拟点击",否则会出现"看得到画面却点不动"。

💡 如果刷新后设备列表是空的,可以先装个手机助手让它正常连接一次,再回来刷新,多数驱动问题都能这样解决。

第三步:USB 直连与无线连接

USB 最简单:数据线插上,点"一键 USB 连接"即可。想彻底摆脱线缆,按下面 5 步走:

  1. 手机和电脑连同一 WiFi,数据线先插着;
  2. 点"刷新设备",确认设备出现在列表里;
  3. 依次点"获取设备 IP"→"启动 adbd";
  4. 点"无线连接",再刷新一次,选以 IP 开头的设备;
  5. 点"启动服务"。

启动 adbd 之后数据线就可以拔了,只要 adbd 还活着,随时能无线连回来。连接报 "more than one device" 的话,试着去掉"使用 Reverse"的勾选再连。

连接之后,这 5 个高频操作值得记住

  • 截图与录制:截图一键存 PNG;录制可自定义比特率、分辨率与格式,还有"仅后台录制"模式——不弹窗口默默录屏,录教程特别好用;
  • 剪贴板双向同步Ctrl+C把手机剪贴板复制到电脑,Ctrl+Shift+V把电脑内容注入手机,macOS 上对应Cmd键;
  • 拖拽即装即传:把 APK 拖进投屏窗口直接安装,拖普通文件则秒传进手机,省掉文件管理器;
  • 快捷键控制Ctrl+H主页、Ctrl+B返回、Ctrl+O息屏保持投屏、Ctrl+F全屏、Ctrl+N下拉通知栏;
  • 窗口置顶与自动息屏:开会演示时置顶窗口、启动后自动关掉手机屏幕省电,都是启动配置里的一个勾选。

进阶玩法一:按键映射,用键鼠"玩"手游

手游玩家是 QtScrcpy 最活跃的人群。项目 keymap 目录里预置了针对和平精英、抖音等应用的映射脚本,把键盘按键、鼠标移动翻译成屏幕触摸事件。

和平精英的投屏画面,WASD 方向盘、F 键交互等按键都映射到了对应触摸点

应用映射只需 4 步:把 JSON 脚本放进 keymap 目录 → 点"刷新脚本" → 选中脚本 → 启动服务后点"应用脚本"。然后按~(数字键 1 左边)在"自定义映射"和"正常控制"之间切换,再按一次切回来。

映射脚本本身是 JSON 格式,坐标用相对位置表示(屏幕宽高各记作 1),想自定义也不难:参考 KeyMapDes_zh.md 里的编写规则,或打开开发者选项的"显示指针位置"直接读取触摸点坐标。脚本里能配置普通点击、双击、拖拽,还有专门给 FPS 游戏准备的"方向盘"映射(WASD 走位)和鼠标视野移动映射。

💡 和平精英里上下车会新建界面导致映射短暂失效,连按两次~就能恢复,这是目前最好用的办法。

进阶玩法二:多设备批量控制,一台电脑管所有手机

应用测试、直播展示、工作室批量操作——QtScrcpy 支持同时连接多台设备,启动服务后可以一键对所有手机执行相同动作,统一回到桌面、统一音量、统一截图,再也不用一台台插拔。

右侧多台安卓设备同时在线,可统一执行同步控制与批量管理

高频踩坑与解法速查

现象原因与解法
adb 版本冲突报错电脑存在多个 adb,杀掉多余 adb 进程,或在 config.ini 的 AdbPath 里指定统一路径
看得到画面却点不动部分机型需在 USB 调试里打开"允许模拟点击"
画面发糊Windows 高 DPI 缩放导致,兼容性设置里把"高 DPI 缩放"改为由应用程序执行
无法输入中文手机端装搜狗或 QQ 输入法即可
报错 Could not open video stream多为解码/分辨率问题,把分辨率调低一档再试
提示解码着色器错误显卡不支持当前渲染,改 config.ini 里的 UseDesktopOpenGL 为 1 或 2

谁适合装,以及 3 分钟起步路径

  • 普通用户:文件互传、消息回复、剪贴板同步,把手机和电脑真正拼成一套工作流;
  • 手游玩家:按键映射配合大屏,体验类端游操作;
  • 测试与运维:多设备批量控制,兼容性测试和批量运营效率翻倍;
  • 想学 Qt 的同学:项目用 C++ + Qt + OpenGL + FFmpeg 复刻自 scrcpy,源码按 QtScrcpyCore(核心逻辑)、ui(界面)、util(跨平台工具)、keymap(映射脚本)组织,是很好的异步编程学习样本,二次开发入口见 docs 目录下的 DEVELOP.md。

最低门槛的起步方式:下载 Windows 版 → 手机开 USB 调试 → 插线 → 点"一键 USB 连接"。全程三分钟,无需 root、无残留,试错成本几乎为零。先把手机画面搬上电脑,再慢慢解锁无线连接、后台录制和键鼠映射,你会发现手机和电脑协同这件事,远比想象中简单。

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询