企业官网建设流程全解析

QtScrcpy 五分钟上手：安卓投屏、键鼠映射与多设备组控免装App指南

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

QtScrcpy 是一款开源的安卓投屏工具。它通过 ADB（Android Debug Bridge，也就是电脑和手机之间调试通信的标准通道）把手机画面实时传到桌面，你可以直接用键盘鼠标操作手机。它最实用的功能是键鼠映射：把键盘按键和鼠标动作预先配置成屏幕上的触摸点，玩手游时手指位置不用变，操作习惯接近 PC 游戏。软件免费，手机无需 root，不安装任何 App，支持 Windows、macOS 和 Linux 三个平台。

第一步：把手机画面投出来——从 USB 到第一帧

📱 连上数据线后，第一件要做的事是打开手机的 USB 调试：进"设置 > 关于手机"连点版本号 7 次激活开发者模式，再回开发者选项里打开"USB 调试"，插线并允许电脑调试。然后运行 QtScrcpy，点"一键 USB 连接"，启动服务后 1 秒内就能见到第一帧画面。实测帧率 30~60fps，USB 延迟大约 35~70ms，1080p 以上分辨率下画面细节足够。

不想被线拴住的话可以走无线：先用 USB 临时连一次，点"刷新设备"让设备号出现，接着点"获取设备 IP"和"启动 adbd"，最后点"无线连接"。再刷新一次设备列表，会出现一个以 IP 地址开头的设备，选它、启动服务即可。adbd 启动后 USB 线就可以拔掉，之后断连重连都不用再插。

投屏之后的几个常用快捷键，记住最实用的几个就够：Ctrl+F全屏、Ctrl+B返回、Ctrl+H主页、Ctrl+P电源、Ctrl+Shift+V把电脑剪贴板里的文字发到手机。另外，把 apk 或文件直接拖进显示窗口，就能完成安装或传文件，不用再敲 adb 命令。

需要录屏时，在启动配置里设好比特率、分辨率、格式和保存路径即可。勾"仅后台录制"会只录屏不弹窗口，勾"自动息屏"则顺手关掉手机屏幕省电，适合长时间挂机录像。

第二步：用键盘鼠标玩手游——键鼠映射怎么配

🎮 项目keymap/目录里自带了两个现成脚本：和平精英和抖音。选一个脚本，点刷新脚本让它被检测到，连接手机并启动服务后点"应用脚本"，最后按一次~键（配置文件里定义的 switchKey）进入映射模式，再按一次切回普通控制。

自己写脚本前先理解两件事。一是坐标：配置里全部用 0~1 的相对值表示，(0.5, 0.5) 就是屏幕正中；1920×1080 的屏幕上它对应像素 (960, 540)，换个分辨率也不会跑偏。二是取坐标：开发者选项里打开"显示指针位置"，用手指点在按钮上读数值，再用"像素值 ÷ 屏幕宽高"换算；更省事的做法是直接在 QtScrcpy 里左键单击，控制台会打印出当前 pos，复制过来就能用。

映射节点分四种类型，按操作需求选：

• KMT_CLICK 单击：按下模拟手指落下、抬起模拟手指离开，跳、开枪、放技能都用它，配一个按键加一个坐标就行；
• KMT_CLICK_TWICE 双击：按下和抬起各触发一次完整点击，和平精英里 Q/E 探头就是这么实现的；
• KMT_DRAG 拖拽：按下后从起点拖到终点，抖音脚本里方向键上下左右滚动视频就靠它；
• KMT_STEER_WHEEL 虚拟摇杆：WASD 四个键模拟方向盘拖动，专治 FPS 手游的移动，配合和平精英里把载具设成单摇杆模式使用。

鼠标部分由 mouseMoveMap 接管：鼠标移动被翻译成以 startPos 为起点的手指拖动，用来转视角，speedRatioX 和 speedRatioY 分别调两个方向的灵敏度，手感偏快就调大数值。完整的字段说明在 docs/KeyMapDes_zh.md，写新配置前翻一遍能省不少事。

一个已知的坑：和平精英上下车后会新建界面，触摸点可能失效，此时连按两次~键即可恢复。

第三步：同时控制多台手机——组控怎么用

🖱️ 游戏工作室、应用测试、多账号运营的常见需求是"一套操作，发到所有设备"。QtScrcpy 支持多设备同时连接，组控模式下你的键盘鼠标输入会同步到所有已连接的手机，也可以切回单台单独操作。多台设备接在同一个 USB 集线器上，或都走无线连到同一局域网，依次添加即可。

第四步：出问题去哪里查

🔧 连不上、控制不了、画面糊，这三类问题占绝大多数，基本都能对症处理：

• 刷新后设备列表是空的：先确认 USB 调试真的打开了，换根数据线试试；如果日志报 adb server version 不匹配，说明电脑里混着不同版本的 adb，去任务管理器结束 adb 进程，或在 config.ini 里把 AdbPath 指向你实际用的那个 adb；
• 能看到画面但操作无效：小米等机型需要在 USB 调试里额外打开"允许模拟点击"，这一步漏掉是最常见的"假性失灵"；
• 报错 Could not open video stream：把启动分辨率调低一档，多数情况直接消失；
• Windows 上画面发虚：右键 QtScrcpy.exe > 属性 > 兼容性，把高 DPI 缩放行为改成"应用程序"；
• 想要声音：项目基于 sndcpy 同步设备扬声器，要求 Android 10 以上，README 标注目前不推荐，日常用蓝牙耳机更稳。

更完整的问答在 docs/FAQ.md，遇到没列过的问题可以先截图控制台日志再排查。

想动手扩展：从源码编译

🧩 内置脚本不满足时，改 JSON 是最快的路；想动 UI 或加功能就直接编译源码。项目用 CMake 构建，需要 Qt 5.12 以上（Windows 用 MSVC 2019）：

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

Linux 下跑./ci/linux/build_for_linux.sh "Release"，产物在output/x64/Release。开发流程和分支约定写在 docs/DEVELOP.md。

配置这件事没有标准答案：先拿现成的和平精英脚本跑通流程，再按自己常玩的游戏逐个按钮改坐标，改完存一份自己的 JSON 放进keymap/。等你的映射文件稳定下来，顺手分享出去，下一个卡在这一步的人就能少踩不少坑。

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