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 界面:信号槽异步编程,界面好定制
最快验证路径
- 手机打开开发者选项里的"USB 调试"(要求 Android 5.0 以上)。标志:选项里开关为打开状态。
- 获取程序:下载对应平台的预编译版本,或克隆源码:
git clone https://gitcode.com/GitHub_Trending/qt/QtScrcpy标志:电脑上有可运行的程序。 3. USB 线接入手机,点击"刷新设备"。标志:列表里出现设备号,说明手机被识别。 4. 点击"启动服务"。标志:1 秒内窗口出现手机画面第一帧。
此时按一下Ctrl+H,手机回到桌面,说明双向控制已经通了。
无线连接不用记 adb 命令:USB 连接成功后,依次点"获取设备 IP"→"启动 adbd"(在手机上开启无线调试服务)→"无线连接",再刷新设备列表。标志:多出一个 IP 地址开头的设备。之后 USB 线可以拔掉,只要 adbd 不停止运行就不再需要。
把键鼠映射玩明白
原理一句话:屏幕是一个坐标系,宽高都记作 1,按键盘键模拟在指定坐标点上按一次手指。仓库自带和平精英、抖音的映射脚本,可以直接用;~是切换键,按一次进入映射模式,再按一次恢复普通控制。
自己写脚本分四步:
- 把 JSON 文件放进
keymap/目录; - 点"刷新脚本"。标志:脚本出现在列表里,选中它;
- 连接手机并启动服务后,点"应用脚本";
- 按
~。标志:画面里出现按键对应的触摸动作。
最常用的是普通点击映射:
{ "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),仅供参考