设备端采集与编码
通过 ADB 启动临时服务端,调用 Android 的 MediaCodec 完成屏幕采集与硬件编码,输出 H.264 视频流。
这一页回答四个问题:它从哪里来、由谁维护、以什么协议发布、以及本站与这个项目是什么关系。 所有信息均可在公开仓库与发布页中核对。
QtScrcpy 并非从零发明。它以上游 scrcpy 的核心机制为基础,用另一套技术栈重新实现了桌面端。
scrcpy 由 Genymobile 开发, 是目前最广为人知的 Android 投屏控制开源工具。它的核心思路是:把一个小型服务端程序通过 ADB 推送到设备上运行, 由设备端负责屏幕采集与硬件编码,电脑端接收视频流并渲染,同时把输入事件回传给设备。
QtScrcpy 复用了这一套思路,但把桌面端换成了 C++ + Qt + OpenGL + FFmpeg: 用 Qt 构建跨平台界面与事件循环,用 OpenGL 完成视频渲染,用 FFmpeg 解码,并在其上补充了图形化设备管理、 自定义按键映射、多设备群控等能力。
作者在官方 README 中说明了开发动机,按重要程度排序为:在学习 Qt 的过程中需要一个真实项目练手; 本身具备音视频技能并对此感兴趣;希望巩固 Android 开发经验;以及在接触 scrcpy 之后,决定用新的技术栈复刻一遍。
理解这条链路,有助于判断问题出在手机、线材、电脑还是网络。
通过 ADB 启动临时服务端,调用 Android 的 MediaCodec 完成屏幕采集与硬件编码,输出 H.264 视频流。
USB 模式下走 ADB 的端口转发,无线模式下走 TCP。画面质量与稳定性直接受这条通道的带宽影响。
桌面端用 FFmpeg 解码,用 OpenGL 渲染;macOS 自 v4.1.0 起支持 Metal 硬件解码以降低 CPU 占用。
鼠标键盘事件被转换为 Android 的触摸与按键事件,经同一通道注入设备,形成“看到即能操作”的闭环。
服务端程序被推送到设备的临时目录并以调试权限运行,停止服务后进程结束,不会作为普通应用常驻。这也是官方强调“无需 root、不在设备上安装任何软件”的技术依据。
按官方发布记录整理,仅列出有明确说明的版本,完整日志请查看 Releases 页面。
| 版本 | 日期 | 主要内容 |
|---|---|---|
| v4.2.1 | 2026-09-19 | 全新 UI 布局;MediaTek 编码器优化以减少画面突然模糊;新增编码器预设;强制单实例运行;新增“关闭即退出”选项;配置与按键脚本改存于应用包外;新增高级配置页;macOS 包加入 ad-hoc 签名。 |
| v4.1.1 | 2026-08-13 | 新的界面布局。 |
| v4.1.0 | 2026-08-09 | 新 UI 主题;更新至 scrcpy server 4.1;支持摄像头镜像、虚拟显示与柔性显示;macOS 支持 Metal 硬解。 |
| v3.3.3 | 2025-11-06 | 更新 scrcpy-server 3.3.1;新增 Linux AppImage;移除配置中的 ServerVersion;无线连接端口支持历史记录;工具栏新增剪贴板按钮。 |
| v3.3.1 | 2025-07-21 | 更新 scrcpy-server 3.3.1;修复 macOS 上 sndcpy 启动错误。 |
| v3.2.0 | 2025-05-14 | 更新 scrcpy-server 3.2。 |
| v3.1.3 | 2025-03-09 | 配置支持设置界面语言。 |
| v3.1.0 | 2025-01-12 | 更新 scrcpy-server v3.1;新增可配置的拖拽速度与延迟;支持 macOS arm64;修复无线设备录制与截图失败。 |
v4.2.1 的 i18n 更新涉及中文、英文、日文与韩文翻译资源。
由于 QtScrcpy 基于 scrcpy 复刻,它沿用了上游的许可协议。官方 README 中的版权声明为 Copyright (C) 2025 Rankun。
完整条款见 Apache License 2.0 原文 与仓库中的 LICENSE 文件。
以下文字引自项目 LICENSE,用于说明权利归属:
Copyright (C) 2025 Rankun
Licensed under the Apache License, Version 2.0
(the "License"); you may not use this file
except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed
to in writing, software distributed under the
License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
either express or implied.
项目欢迎外部贡献,但对提交方式有明确要求。以下整理自官方 README 的 DEVELOP 章节。
dev 分支,而不是 master。遇到问题时,建议先在官方 FAQ 中查找,再在 GitHub Issues 中搜索是否已有相同问题。
提交 Issue 时请附上:操作系统与版本、手机型号与 Android 版本、QtScrcpy 版本号,以及控制台打印的日志——缺少日志的问题往往无法定位。
官方 README 中公开了 QQ 交流群与 Telegram 群组,具体群号与链接请以仓库页面为准,本站不代为发布。
官方 README 中提到了作者开发的另外两款产品(极限投屏 QuickMirror、极限手游助手 QuickAssistant), 它们与 QtScrcpy 是相互独立的软件,采用各自的授权方式。QtScrcpy 本身仍然完全开源免费, 商业产品不影响你使用开源版本。本站在此说明,是为了避免读者把两者混淆。
qtscrcpy.net.cn 是一个由第三方独立维护的中文资料站,用于整理 QtScrcpy 的功能说明、 使用教程、常见问题与版本信息,帮助中文用户更快上手。
它不是 QtScrcpy 项目作者的官方网站,也不代表项目方发言。软件的全部著作权归原作者 Barry(Rankun)所有。
本站内容依据公开资料整理,并在页面标注了采集日期。软件功能与版本会持续变化, 若本站描述与官方仓库不一致,请以官方仓库与 Releases 页面为准。 发现错误可通过站点底部渠道反馈,我们会核对后更正。
本站内容均以下列一手资料为依据,读者可自行核对。
使用手机 App 扫描下方任一二维码,即可识别对应网盘中的 QtScrcpy 安装包。 本站不提供直链下载,请以网盘页面展示的文件名与版本信息为准。
提示:请勿从来源不明的第三方站点下载“绿色版”“破解版”,此类安装包可能被植入恶意程序。
需要官方原版安装包?可前往 GitHub Releases 或 Gitee Releases 获取。