☰
QtScrcpy:3 步把安卓画面投屏到电脑,键鼠直接操控手机
2026/10/4 1:55:55 网站建设 项目流程

QtScrcpy:3 步把安卓画面投屏到电脑,键鼠直接操控手机

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

在 6 寸小屏上打《和平精英》,视野和操作都很憋屈。把手机接到电脑,QtScrcpy 完成安卓投屏,键盘鼠标就能像端游一样操控手机,全程不需要 Root。

先搞清楚它能干什么

这是一个用 C++ 和 Qt 编写的开源 Android 实时显示与控制工具,复刻重构自 scrcpy(原版的安卓投屏工具),Apache-2.0 协议,Windows、macOS、Linux 三个桌面平台都能跑。官方给出的数字:延迟 35~70ms,帧率 30~60fps,分辨率支持 1920×1080 以上,1 秒内出第一帧画面。

和 scrcpy 比,它的差异点:

  • 自定义按键映射:键盘按键可以变成触摸点
  • 多设备批量操作:同时控制所有连上的手机
  • 多点触控:原版 scrcpy 不支持
  • Qt 界面:信号槽异步编程,界面好定制

最快验证路径

  1. 手机打开开发者选项里的"USB 调试"(要求 Android 5.0 以上)。标志:选项里开关为打开状态。
  2. 获取程序:下载对应平台的预编译版本,或克隆源码:
git clone https://gitcode.com/GitHub_Trending/qt/QtScrcpy

标志:电脑上有可运行的程序。 3. USB 线接入手机,点击"刷新设备"。标志:列表里出现设备号,说明手机被识别。 4. 点击"启动服务"。标志:1 秒内窗口出现手机画面第一帧。

此时按一下Ctrl+H,手机回到桌面,说明双向控制已经通了。

无线连接不用记 adb 命令:USB 连接成功后,依次点"获取设备 IP"→"启动 adbd"(在手机上开启无线调试服务)→"无线连接",再刷新设备列表。标志:多出一个 IP 地址开头的设备。之后 USB 线可以拔掉,只要 adbd 不停止运行就不再需要。

把键鼠映射玩明白

原理一句话:屏幕是一个坐标系,宽高都记作 1,按键盘键模拟在指定坐标点上按一次手指。仓库自带和平精英、抖音的映射脚本,可以直接用;~是切换键,按一次进入映射模式,再按一次恢复普通控制。

自己写脚本分四步:

  1. 把 JSON 文件放进keymap/目录;
  2. 点"刷新脚本"。标志:脚本出现在列表里,选中它;
  3. 连接手机并启动服务后,点"应用脚本";
  4. 按~。标志:画面里出现按键对应的触摸动作。

最常用的是普通点击映射:

{ "switchKey": "Key_QuoteLeft", "keyMapNodes": [ { "type": "KMT_CLICK", "key": "Key_W", "pos": { "x": 0.16, "y": 0.75 } } ] }

坐标怎么填:在投屏画面上用鼠标左键点一下,控制台会输出对应的pos,直接照抄,不用自己算像素。

两个容易踩的坑:和平精英里用方向盘控制载具,先把载具设置切到单摇杆模式;上下车之后映射点可能失效,连按两次~即可恢复。

顺手还能做这些

  • 屏幕录制:启动配置区设比特率、分辨率、格式和保存路径,"仅后台录制"只录屏不开窗口
  • 截图:当前画面一键保存
  • 无线连接:三次点击连上,adbd 跑起来后不再依赖 USB 线
  • 装 apk / 传文件:拖进画面窗口即装、即推
  • 剪贴板双向同步:Ctrl+C从设备复制,Ctrl+Shift+V注入到设备
  • 显示控制:Ctrl+F全屏,Ctrl+O息屏但保持投屏

这三类人会用得上

  • 手游多开党:多设备连接加批量操作,多个账号同步执行相同动作
  • 应用测试同学:拖拽装 apk、推送文件、剪贴板同步,配合录屏留操作记录
  • 演示讲师:窗口置顶加全屏,Ctrl+O让手机息屏但投屏不断

出问题了先查这里

现象常见原因处理办法
有画面但无法控制手机未开启"允许模拟点击"开发者选项里 USB 调试下打开该开关
刷新设备列表后没有设备驱动或 USB 调试未正确开启用手机助手装好驱动,再刷新设备
adb server version 不匹配多个程序的 adb 版本冲突结束 adb 进程,或在config.ini指定AdbPath
可控制但无画面,控制台报 shader 错误显卡不支持当前渲染方式config.ini里UseDesktopOpenGL改 1 或 2
错误:Could not open video stream分辨率设置过高启动配置里调低分辨率
手机端无法输入中文手机没有中文输入法手机端安装搜狗或 QQ 输入法

想深入就看这几处

  • README_zh.md:完整功能列表和全部快捷键速查表
  • docs/KeyMapDes_zh.md:按键映射编写规则全解,涵盖点击、拖拽、方向盘等 5 种类型
  • keymap/:和平精英、抖音等内置映射脚本,改个坐标就能当模板用
  • docs/FAQ.md:常见问题说明,上面表格没覆盖的情况按它排查
  • config/config.ini:语言、解码方式、adb 路径等全局配置
  • docs/TODO.md:音频转发、屏幕旋转、自定义快捷键等计划中的功能

先把 USB 连接跑通,确认键鼠能控制手机。画面稳定后,打开keymap/里的和平精英映射脚本应用上,再开始调你自己的键位。

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

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

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

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

立即咨询