企业官网建设流程全解析

QtScrcpy：Android 投屏控制，1 秒出第一帧

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

QtScrcpy 是一款开源的 Android 投屏控制工具，适合多机测试、手游键鼠操作和教程录制的人。开启 USB 调试、数据线一插，手机无需 Root、不装任何应用：画面实时投到电脑，键鼠直接点按操控，还支持多设备、后台录制、拖拽安装和批量群控。

它做什么

• 多设备投屏：多台手机同时连接，各自独立窗口，非侵入、手机端零安装
• 键鼠实时控制：点击、拖拽、多点触控均可，主页、返回、切后台等按键都有对应快捷键
• 后台录制：勾选「仅后台录制」后不弹出窗口，只录屏幕
• 拖拽传文件与装 APK：文件、安装包直接拖进投屏窗口即完成传输或安装
• 群控：一套键鼠操作同步发送到所有已连接设备
• 声音同步：基于 sndcpy 把设备扬声器声音传到电脑，仅 Android 10 以上

出画面的路径

1. 拿到程序：Windows / macOS 下载编译好的可执行包；Arch Linux 在终端执行yay -Syu qtscrcpy（版本可能偏旧）；其他 Linux 发行版用编译好的版本 → 得到可运行程序
2. 手机「开发者选项」打开 USB 调试（Android 5.0 / API 21 以上）→ 连接前置条件就绪
3. 数据线接好后点「刷新设备列表」→ 设备号出现在列表里
4. 点「启动服务」→ 1 秒内出第一帧，延迟 35~70ms

不想一直插线：首次 USB 连上后依次点「获取设备 IP」→「启动 adbd」→「无线连接」，再刷新一次列表，会多出一个 IP 开头的设备，选中它启动服务即可拔线。adbd 只要不停止，后续连断都不再需要数据线。

出画面之后

🖱️ 鼠标直接触控

• 做法：窗口内点一下就是触摸手机；鼠标中键或Ctrl+H回主页，右键双击或Ctrl+B返回，Ctrl+S切后台
• 场景：全程不碰手机，导航、点选、切应用都交给键鼠
• 坑：窗口带黑边时，左键双击黑色区域或按Ctrl+W自动裁掉黑边

🎬 后台录制与截图

• 做法：在「启动配置」里先设好比特率、分辨率、录制格式与保存路径，再勾选「仅后台录制」启动服务
• 场景：录教程素材、bug 复现录像，画面外不出现软件窗口
• 坑：长时投屏记得同时勾选「自动息屏」，省电且不中断录制

🎮 手游键位映射

• 做法：脚本放进keymap/目录 → 点「刷新脚本」→ 选中 → 连接后点「应用脚本」→ 按~进入映射模式，再按一次切回
• 场景：内置《和平精英》、第五人格、抖音等映射；开抖音时方向键即可模拟上下滑动
• 坑：《和平精英》想用车盘控制，载具设置里改成单摇杆模式

真实任务组合

• 手游录像：输入是投屏窗口 + 「启动配置」里的录制参数 → 勾选「仅后台录制」启动服务并游玩 → 产出指定目录下的录屏文件，窗口不出现在画面里
• 多机并行调试：输入是多台 USB 手机和一个新包 → 包拖到各窗口即装，键鼠并行操作 → 产出同一功能在多个机型上的表现对照
• 展示设备批量铺设：输入是成排设备 + 一条要执行的指令 → 用群控或「命令行」执行自定义 adb 指令 → 一次操作，全部设备同步完成

参数与坑位

• Q：设备列表刷新后是空的？A：先随便找个手机助手把设备连成功一次，再回软件点「刷新设备列表」。

• Q：画面能看，但点不动手机？A：查 USB 调试里是否开了「允许模拟点击」，小米等机型常见。

• Q：报 adb server version doesn't match？A：任务管理器里结束 adb 进程；或在 config.ini 的 AdbPath 指向当前在用的 adb。

• Q：中文输不进去？A：手机端装搜狗或 QQ 输入法即可。

• Q：能控制，画面却出不来？A：显卡不支持当前渲染方式，把 config.ini 里的解码方式改成 1 或 2 再试。

• Q：提示 Could not open video stream？A：在分辨率设置里换一个更低的分辨率。

• Q：《和平精英》上下车操作突然失效？A：上车会新建界面导致触摸点丢失，连续按两次~键（数字键 1 左边）恢复。

完整排查见 docs/FAQ.md。

再深入一层

技术栈一句话：C++ + Qt + OpenGL + FFmpeg，手机端 scrcpy-server 推 H.264 码流，电脑端解码渲染，Qt 信号槽做异步控制，因此能支持多点触控。

• 源码构建：git clone https://gitcode.com/GitHub_Trending/qt/QtScrcpy拉取代码，Qt 5.12 以上 + CMake 即可编译，Linux 直接跑./ci/linux/build_for_linux.sh "Release"，产物在output/x64/Release，详见 docs/DEVELOP.md
• 扩展键位映射：keymap/目录自带和平精英、第五人格、抖音等示例脚本，规则写法参考 docs/KeyMapDes_zh.md
• 社区约定：PR 推向 dev 分支，提交前先变基原项目，一个功能点一个 PR

从单台投屏到多机群控，上面这些能力开箱就能用——装好程序、插上手机，今天就能跑起来。

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