QtScrcpy 完整使用指南：如何在电脑上免费投屏并键鼠操控安卓手机-育师

QtScrcpy 完整使用指南：如何在电脑上免费投屏并键鼠操控安卓手机

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

QtScrcpy 是一款基于 Qt 开发的安卓实时显示与控制软件，通过 USB 或 Wi-Fi 把手机画面传到电脑，并用键盘鼠标操作手机，支持 Windows、macOS、Linux 三大平台，无需 Root。下面讲清它适合谁、怎么连上、能做什么，以及键位配置的方法。

它是什么，为什么值得用

一句话定位：把手机屏幕低延迟地搬到电脑上，并让键鼠直接控制手机。它基于 scrcpy 二次开发，用 C++ 重写，配合 OpenGL 渲染，实测延迟在 35~70ms，首帧显示约 1 秒，画面可达 1080P、30~60fps。

和普通投屏工具相比，它有两个明显差异：

可自定义键位：把键盘任意按键映射到屏幕任意位置，这是它区别于原版 scrcpy 的核心能力，适合手游玩家。
跨平台开箱即用：依赖由 Qt 统一管理，Windows 提供含 ADB 的预编译包，下载即可跑。

项目采用 Apache 2.0 开源，免费且无需在手机上安装任何东西。

准备工作：先让手机能被电脑识别

连接的前提只有一条：手机系统为 Android 5.0（API 21）及以上，并开启USB 调试。开启路径是「设置 → 关于手机 → 连续点击版本号 7 次进入开发者模式 → 打开 USB 调试」。

拿到软件后，根据平台选择：

Windows / macOS：从 Releases 下载预编译压缩包，解压即运行。
Linux：优先用发行版预编译包，或按 docs/DEVELOP.md 用 CMake 自行编译。
想从源码构建，执行：

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

最快的连接步骤

USB 直连（推荐）：用数据线连手机和电脑 → 点「刷新设备」→ 选中设备 → 点「开始服务」，手机画面立刻出现在视频窗口。

Wi-Fi 连接：手机和电脑需在同一局域网。先 USB 连一次，然后依次点「获取设备 IP」→「启动 adbd」→「无线连接」，此时会多出一个带 IP 地址的设备，选中它再点「开始服务」。启动 adbd 后即可拔掉数据线。

小提示：如果连不上，多半是没开 USB 调试，或电脑端已运行了别的 adb 进程，先结束再试。

能帮你做成哪些事

实时显示与键鼠控制。画面实时同步，鼠标移动、点击、拖拽都会映射到手机。常用快捷键：Ctrl+F全屏、Ctrl+H回主页、Ctrl+B返回、Ctrl+S应用切换（macOS 用Cmd或对应按键）。

录像与截图。支持本地录制，可在「开始配置」里设置比特率、分辨率、保存路径与格式；支持一键截图存为 PNG。开启「后台录制」后可只在后台录、不弹画面。

多设备组控。同时连接多部手机，一次操作同步到所有设备，适合批量测试、演示或手游多开。

文件与剪贴板。把 APK 拖进视频窗口即可安装；拖入其他文件可直接传到手机。电脑与手机双向同步剪贴板：Ctrl+C取手机内容到电脑，Ctrl+Shift+V注入电脑内容到手机（中文输入需手机端装搜狗/QQ 输入法）。

声音同步。基于 sndcpy，Android 10 以上可把手机外放声音传到电脑。

键位配置方法：把键盘按到屏幕任意位置

这是 QtScrcpy 最有用的功能。所有映射文件是 JSON，放在 keymap/ 目录下，坐标用相对值表示——屏幕宽高都记为 1，(0.5, 0.5)即屏幕中心。

拿到准确坐标的两条路：一是手机开发者选项里打开「显示指针位置」，点屏幕就能看到坐标；二是用鼠标左键点视频窗口，控制台会直接打印当前pos，直接填进配置即可。

最小可用示例。在 keymap 目录新建一个 JSON，按下W键就在屏幕(0.16, 0.75)处点一下：

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

保存后点「刷新脚本」→ 选中该脚本 → 连接手机并「开始服务」→ 点「应用」。之后按切换键（默认~，即数字 1 左边）进入自定义映射，再按一次切回普通模式。

支持的动作类型：KMT_CLICK单击、KMT_CLICK_TWICE双击、KMT_CLICK_MULTI连点、KMT_DRAG拖拽、KMT_STEER_WHEEL方向盘，以及mouseMoveMap鼠标移动映射（用于 FPS 里转视角）。完整字段规则见 docs/KeyMapDes_zh.md。仓库已自带和平精英、身份、抖音等游戏的映射模板，可参考或直接改。

遇到问题怎么办：避坑指南

刷不出设备：确认 USB 调试已开；换个数据线/接口；或先装个手机助手连一次驱动再刷新。
有画面但无法控制：部分机型（如小米）需在 USB 调试里额外勾选「允许模拟点击」一类的控制权限。
adb 版本冲突：提示adb server version doesn't match时，去任务管理器结束 adb 进程，或在config.ini的AdbPath指向当前用的 adb。
画面不清晰：视频窗口别拉得太小；Windows 下可给QtScrcpy.exe设置高 DPI 缩放为「应用程序」；若报Could not open video stream，先选低一档分辨率。
能控制但看不到画面：控制台出现shader program is not linked，通常是显卡不支持当前渲染方式，把config.ini里的解码/渲染方式改成 1 或 2。
和平精英上下车失效：上车会新建界面导致触摸点失效，连按两次~键即可恢复。
输入不了中文：手机端装搜狗或 QQ 输入法。