QtScrcpy：Android 实时投屏与电脑端控制工具

QtScrcpy 是一款基于Qt / C++开发的开源 Android 实时投屏与电脑端控制软件的 GUI 版本，该项目在著名的scrcpy架构基础上进行了改进。

一、平台介绍

1. 支持系统：涵盖 Windows、macOS、Linux (Ubuntu / Arch Linux)。
2. 支持设备：Android 5.0 (API level 21)及以上设备，连接时无需 Root。
3. 核心特性：

• 极轻量（免在手机安装任何 App）。
• 高帧率（稳定在 30~60 fps）。
• 高画质（支持 1920x1080 及以上分辨率）。
• 超低延迟（控制在 35~70ms）。
• 启动速度极快（通常约 1 秒内完成连接）。

二、主要功能

1. 实时投屏与双向操控：使用电脑键盘和鼠标直接对手机画面进行点击、滑动以及文本输入。
2. 自定义按键映射 (Keymap)：支持将键盘/鼠标按键映射为手机屏幕触摸操作，内置吃鸡（PUBG）、抖音等常用脚本，并支持用户手写脚本扩充。
3. 多设备群控：同时连接并一键批量控制多台不同型号的手机设备。
4. 无线/有线双模式：既支持通过 USB 线缆稳定连接以获得高画质，也支持在同一局域网下的 WiFi 无线投屏。
5. 快捷文件传输与安装：直接拖拽 APK 文件到投屏窗口即可自动安装应用；拖拽普通图片或文档可直接发送至手机侧存储目录。
6. 屏幕录制与截图：允许用户设定比特率、分辨率及录屏格式，甚至支持后台无界面隐藏投屏模式进行录制。
7. 声音同步：针对 Android 10+ 设备，支持将音频流传输到电脑端直接播放音效或语音通话录音。
8. 剪贴板同步：利用快捷键（如 Ctrl+C / Ctrl+V）实现电脑与手机之间文本内容的双向复制粘贴。

三、适用人群

1. 手游/娱乐玩家：希望在电脑大屏显示器上，利用键鼠顺畅体验移动游戏或滑动浏览短视频应用。
2. 开发者/测试人员：需要在电脑上批量测试应用程序功能、进行多机联动调试以及录制 App 演示画面（Demo）。
3. 办公/效率人群：工作场景中无需频繁拿起手机，直接在电脑侧边屏幕接收通知消息回复及互相传文件传输任务。

四、免费付费情况

1. 开源授权：QtScrcpy项目本身完全免费且开源，遵循 Apache-2.0协议，无任何功能限制或强制收费行为。
2. 衍生服务说明：作者同时开发了针对大批量投屏控机的专业商业级工具（如 QuickMirror），但这不影响 QtScrcpy 本身的免费性质；若需学习项目架构原理，提供的视频课程属于自愿购买范畴。

五、如何使用

1. 准备工作

1. 开启 USB 调试：在手机系统设置中找到开发者选项并开启"USB 调试"开关。
2. 下载软件：在电脑上访问官方 Releases 页面 https://github.com/barry-ran/QtScrcpy/releases 进行下载解压，安装包内已内置 ADB 工具。

2. USB 有线连接步骤

1. 物理连接：使用数据线将手机连接到电脑，若手机端弹出弹窗提示时选择"允许这台计算机进行 USB 调试"并勾选不再询问（可选）。
2. 启动设备：打开 QtScrcpy 软件界面，点击顶部的 “刷新设备”。
3. 开始投屏：在左侧列表中找到手机型号，选中后点击右侧的 **“启动服务”**按钮即可显示画面。

3. WiFi 无线连接步骤

1. 建立有线基础通道：先用 USB 线连上电脑，进入软件选中现有设备依次点击“获取设备 IP"和“启动 adbd”。
2. 切换至无线模式：在界面中点击 **“无线连接”**按钮。
3. 断开物理连线：等待片刻直到列表中出现带 IP 地址的新设备条目，拔掉 USB 数据线后，选中该 IP 设备并点击 **“启动服务”**即可实现纯 WiFi 投屏。

六、注意事项

1. 授权权限检查：若软件中点击“启动”无反应或无法连接，请务必确认手机端是否弹出 ADB 调试许可提示，必要时需重启 USB 连接线。
2. 映射模式切换技巧：在开启游戏等需要自定义按键时，需在键盘左上角的 ~ (波浪键) 上进行操作，以在 “普通鼠标点击”与“按键映射操作”两种模式下互相切换激活脚本功能。
3. 网络环境要求：启用无线投屏模式时，手机和电脑必须处于同一 WiFi 局域网网段内才能保持连接稳定不丢包断连现象发生频繁出现的情况请确保路由信号良好。
4. 合规风险提醒：使用按键映射玩部分对外挂/外接设备检测严格的竞技手游（如和平精英等）时，需严格遵循游戏官方规范操作，避免因判定为违规模拟器而面临账号封禁风险。