企业官网建设流程全解析

5分钟把手机接上电脑：QtScrcpy 的 Android 投屏与操控速成

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

插上数据线，打开 QtScrcpy，1 秒后手机画面出现在电脑窗口里：鼠标点击变成手指点按，键盘输入直接打到设备上，全程延迟约 35~70ms。这就是 Android 投屏控制的完整效果——手机端不用 root，不用装任何 App，只依赖 ADB 调试通道。

🎯 什么情况下你需要它

• 痛点：手动测 App，总得盯着手机点屏幕。验证流程要按住手机反复点，QtScrcpy 把键鼠事件直接映射到手机上，你在电脑端连续操作，还能同时录制屏幕——复现问题时录像直接可交差。
• 痛点：玩手游屏幕小，打久了手指发酸。想用键鼠玩手游，不用自己研究协议：keymap 目录自带和平精英、抖音等脚本，套用后 WASD 走动、鼠标瞄准，编写自定义映射的规则见 docs/KeyMapDes_zh.md。
• 痛点：装包、传文件还得翻文件管理器。把 apk 或任意文件拖进投屏窗口，自动完成安装或传输，一条命令都不用敲。
• 痛点：手里几台手机，每台都得有人盯。程序可以同时开多个投屏窗口并做批量操作，一人盯多机的场景基本够用。

⚡ 5分钟跑起来

• 装好依赖：Qt 5.12 以上（Windows 用官方安装器勾 MSVC 2019；Linux 用包管理器装 qt5-base、qt5-multimedia、qt5-x11extras）
• 拉取代码（注意带子模块）：

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

• 编译：Linux 直接跑仓库自带的脚本，产物在output/x64/Release；Windows 用 Qt Creator 打开CMakeLists.txt编译 Release 即可

./ci/linux/build_for_linux.sh "Release"

• 连设备：手机"设置 > 关于手机"连点版本号 7 次进开发者选项，打开"USB 调试"，插线后在程序里点"刷新设备"，选中设备点"启动服务"

预期结果：约 1 秒后手机画面出现在窗口中，动一下鼠标就能操作手机。

📱 照着做，两个高频场景

场景一：从 USB 切到 WiFi，拔掉数据线

1. 手机开 USB 调试、插线，点"刷新设备"。预期：列表出现带序列号的新设备
2. 点"获取设备 IP"，再点"启动 adbd"。预期：IP 填入无线连接区域
3. 点"无线连接"，再刷新设备列表。预期：多出一台 IP 开头的设备，选中它"启动服务"，拔掉数据线，画面不中断

[!TIP] adbd 启动后就不再需要数据线了，之后断线重连都走 WiFi，除非 adbd 被停止。

主界面：左侧设备列表，中间投屏窗口，右侧是刷新设备、启动服务、无线连接等控制按钮

场景二：键鼠操作和平精英

1. 游戏内把载具操控设为"单摇杆模式"
2. 点"刷新脚本"，选中gameforpeace.json；连接手机并启动服务后点"应用脚本"
3. 按~键切到映射模式。预期：WASD 控制移动，鼠标转视角、射击
4. 再按一次~回到普通控制模式

套用 keymap 脚本后，手游可以用 WASD 加鼠标像端游一样操作

🔧 问题速查

• 设备列表刷不出设备→ 驱动缺失或 adb 服务异常 → 执行adb kill-server && adb start-server后重试
• 能看到画面但无法控制→ 小米等机型需额外权限 → 在"USB 调试(安全设置)"里勾选允许模拟点击
• 报 adb server version 不匹配→ 电脑上混用了多个 adb 版本 → 任务管理器杀掉 adb 进程，或在 config.ini 指定 AdbPath
• 能控制但画面出不来→ 显卡不支持当前渲染方式 → config.ini 里把解码方式改成 1 或 2
• Could not open video stream→ 启动配置里分辨率设得太高 → 换更低分辨率重启服务
• 键盘输不进中文→ 注入文本要求设备端输入法支持 → 手机装搜狗或 QQ 输入法

适合需要频繁调设备的开发者、要复现问题的测试，以及想把手游搬上大屏的玩家。更多细节可查 docs/FAQ.md。现在就插上数据线，把第一次投屏跑起来吧。

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