几年前我第一次需要把手机画面投到电脑上做演示试过一圈方案厂商自带的多屏协同只认自家生态商业投屏软件要么要装驱动、要么免费版锁在 720p 还带水印。最后是同事丢给我一个压缩包——scrcpy-win64.zip解压、插线、双击 exe手机屏幕就这么躺在显示器上了全程没有登录、没有广告、没有后台常驻进程。从那天起副屏、录教程、调 App 布局这些事我基本都靠它。这篇文章就把 android 开源投屏工具 scrcpy 掰开揉碎讲一遍它是什么、底层怎么跑、Windows 上怎么从零点亮、参数怎么调、无线怎么接、闪退黑屏怎么救。无论你是刚接触 adb 的新手还是天天和 Android Studio 打交道的开发者都能从里面抄到能直接用的东西。1. 先搞清楚 scrcpy 是个什么东西一对进程不是一款 App1.1 电脑上只有一个可执行文件没有安装过程scrcpy 全称 screen copy由 Genymobile 开源维护许可证是 Apache-2.0。它的发行包极简Windows 版就是一个 zip解压出来是scrcpy.exe、adb.exe、SDL2.dll、avcodec-*.dll这些文件Linux 版基本得从源码编译或者用包管理器装macOS 用 Homebrew 一行brew install scrcpy。没有安装向导没有注册表写入没有开机自启。你不想用了直接把文件夹删掉系统里什么都没留下。这个设计取向很关键。它意味着 scrcpy 不会被装到手机里——手机侧不需要你手动安装任何 APK也不需要 root 权限。很多人第一次用会怀疑是不是要装个 App 到手机上答案是不用这也是它和市面上大部分投屏工具最本质的区别。1.2 手机侧那个临时工scrcpy-server手机端确实要跑东西但那是 scrcpy 自己在运行时推过去的一个 jar 包scrcpy-server.jar。它会通过 adb 被推到/data/local/tmp/下面执行投屏结束就退出。你可以理解成电脑雇了个临时工干完活就走了。因为是在 app_process 里以 shell 权限跑起来的所以它能用系统级的屏幕采集和输入注入接口而不需要安装 App、也不需要应用层权限弹窗。这带来一个很实际的好处任何设备只要能连上 adb就能被投屏。不需要在手机上点允许录屏的悬浮窗不需要辅助功能权限公司发的测试机、朋友借的手机、临时插上的平板都能立刻用。1.3 为什么一定要 adb不能用别的通道adbAndroid Debug Bridge是这套方案的地基。scrcpy 靠 adb 做三件事推送并启动服务端 jar、建立 socket 通道视频流、音频流、控制指令各走一条、以及接收设备的日志和退出码。所以USB 调试这个开关是硬性前提它不是 scrcpy 的怪癖而是整个 Android 调试体系的规定。这里有个常见误解有人以为 scrcpy 是远程桌面走的是网络协议。其实 USB 模式下数据只在数据线里跑根本没有经过局域网延迟自然低。无线模式也只是把 adb 通道从 USB 换成了 TCP协议本身没变。1.4 和同类方案摆在一起看方案是否装手机 App是否要 root延迟表现典型短板scrcpy否否USB 下很低命令行起步无 GUI厂商多屏协同是系统内置否低只支持自家品牌商业投屏软件是否一般免费版限画质、带广告系统自带投射无线显示否否偏高部分机型不开放、不能反向控制纯网络串流方案是否波动大依赖局域网质量这个表格我建议你存一下下次有人问投屏用什么的时候直接甩过去。选型的核心就一句话需要低延迟 反向控制 跨品牌scrcpy 基本是唯一不需要妥协的选项。代价是你得接受命令行而这一点后面几节会把它变成优势。2. 画面从手机屏幕到电脑显示器中间到底发生了什么2.1 采集设备侧建了一块影子屏幕scrcpy-server 启动后干的第一件事是通过 Android 的显示管理接口创建一块虚拟显示VirtualDisplay把主屏幕的内容镜像过来。这里不是截屏循环不是每隔几十毫秒抓一张 PNG——那是早期一些玩具工具的做法帧率和 CPU 占用都很惨。虚拟显示的好处是它可以被当成一个正常的 Surface 数据源交给硬件编码器去消费。顺带解释一个很多人撞过的墙为什么某些界面投出来是黑的那是应用主动设置了FLAG_SECURE安全窗口标记比如支付密码输入框、部分银行 App、某些视频 App 的版权保护页。虚拟显示拿不到这些图层的内容编码器只能编出黑色。这是系统的安全设计不是 scrcpy 的 bug也不是参数能绕过的。2.2 编码H.264 硬编是低延迟的根本原因采集到画面之后scrcpy 调用设备的 MediaCodec 硬件编码器把原始帧压成 H.264也支持 H.265/AV1。这个选择非常讲究为什么不用 MJPEGMJPEG 每帧独立压缩压缩率差8 Mbps 的带宽下画质和帧率都撑不住。为什么用硬编而不是软编硬编是手机 SoC 里的专用模块在做几乎不占 CPU也就不会出现投屏一开手机就发烫卡顿的情况。为什么默认 H.264 而不是 H.265H.265 压缩率更高、同画质下码率更低但兼容性和解码开销更敏感。默认 H.264 是所有人都能跑起来的稳妥选择追求画质再手动切 H.265。2.3 传输socket 上的裸流没有封装容器编码后的数据通过 adb 转发的 socket 送到 PC。注意这里传的是裸的编码流没有 MP4 那样的容器封装也不做重传。这么做是为了极致压低延迟——丢一两帧就丢了画面继续往前走而不是卡住等重传。所以你在弱线材或者劣质 USB Hub 上偶尔看到画面撕裂、花屏一闪就是这个机制的代价。2.4 解码与渲染PC 端其实很轻松PC 端拿到流之后交给 FFmpeg就是解压包里那一堆avcodec-*.dll解码再通过 SDL2 渲染成窗口。解码是软解但你不用担心——1080p 的 H.264 对现在的 CPU 来说负担很小一台五年前的笔记本都能轻松扛住。真正会成为瓶颈的通常是三处USB 传输质量、设备的编码器能力、以及 PC 的窗口渲染比如开了缩放又开了高分屏。2.5 反向通道你的鼠标怎么变成手指投屏是单向的用电脑操作手机才是 scrcpy 真正香的地方。控制链路是反向的PC 把鼠标位置、按键事件打包通过另一条 socket 发给设备端的服务服务再通过系统输入管理接口注入触摸和按键事件。这就解释了为什么 scrcpy 的控制是真控制而不是模拟点击注入的是系统级输入事件和你用手指点屏幕在系统看来没有区别。也正因如此某些国产定制 ROM 会额外要求开启USB 调试安全设置这一项否则投屏正常但鼠标点不动原因就在这里后面第 6 节会细说。3. Windows 上从零跑起来下载、解压、连线的完整动作3.1 别漏文件尤其那几个 dllWindows 用户的入口通常是 GitHub Releases 页里的scrcpy-win64-vX.X.zip。下载下来直接解压到一个路径里建议路径不要有中文和空格比如D:\tools\scrcpy就很好。放到C:\Program Files\或者桌面这种带空格的地方某些版本会出奇怪的加载失败。解压完检查一下目录里有没有这些东西scrcpy.exe、adb.exe、AdbWinApi.dll、AdbWinUsbApi.dll、SDL2.dll、avcodec-*.dll、avformat-*.dll、avutil-*.dll、swresample-*.dll。少任何一个是双击就闪退的头号嫌疑因为 Windows 找不到依赖库时会静默退出连报错窗口都不给。提示如果你机器上已经装过 Android Studio 或 platform-tools环境里可能已经有一份 adb。scrcpy 文件夹里自带的那份通常版本更新建议在 scrcpy 目录里执行命令确保用的是它自带的 adb避免版本不匹配导致的协议错误。3.2 手机侧三个开关少一个都不行不同品牌的叫法不一样但本质是这几项开发者选项设置里找到关于手机连续点击版本号七次部分机型是MIUI 版本或软件版本。USB 调试开发者选项里打开。USB 调试安全设置MIUI、部分 ColorOS / OriginOS 里额外存在的一项允许通过 USB 调试修改权限或模拟点击。不做这一步你会遇到能看不能点。连接时手机会弹一个允许 USB 调试吗的对话框勾选始终允许再确定。如果错过了去开发者选项里的撤销 USB 调试授权重置一下再来。3.3 adb devices 这一步才是分水岭别急着运行 scrcpy。先在解压目录里打开命令行地址栏输入cmd回车执行adb devices期望看到的是List of devices attached ABCDEFG123456 device如果看到的是unauthorized说明手机上没点授权看到offline换一根线或者换个 USB 口看到列表是空的那就是驱动或线材问题。这一步不通过scrcpy 再折腾也没用因为它的所有通信都架在 adb 之上。关于线材我可以多啰嗦一句很多投屏连不上的案例最后查出来是那根线只供电不传数据尤其是随手抓的充电线。换一根能传文件的线问题当场消失。3.4 第一次运行建议加上这两个参数设备识别正常后直接scrcpy屏幕就出来了。但我更建议第一次这样跑scrcpy --stay-awake --turn-screen-off--stay-awake让设备在插着 USB 时保持唤醒避免你正在操作它突然息屏--turn-screen-off让手机的物理屏幕立刻关掉只保留镜像输出。后者的实际价值超乎想象一是省电、减少发热二是你在演示或者录屏的时候手机屏幕是黑的旁边的人看不到你正在点什么私密性好很多。4. 参数调优画质、延迟、编码器之间怎么取舍4.1 分辨率和码率是第一优先级scrcpy 的性能调节就三个旋钮参数作用默认值建议--max-size限制长边分辨率1920弱机或无线时降到 1024--video-bit-rate视频码率8M降到 2M 换流畅升到 16M 换清晰--max-fps限制帧率不限制投屏打游戏稳 30 或 60这三者是乘法关系不是加法。你把分辨率从 1080p 降到 720p编码器的负载立刻降一半以上码率需求也跟着降。所以卡顿的第一反应应该是降--max-size而不是降帧率。帧率掉下去操作手感会很怪分辨率降一点大多数人根本看不出来。举个例子我经常用一台老笔记本给测试机做演示命令是scrcpy --max-size1024 --video-bit-rate4M --max-fps30这个配置在 USB 下几乎不可能卡。4.2 编码器切换H.265 和省流量的取舍想在同码率下拿到更好的画质可以切 H.265scrcpy --video-codech265 --video-bit-rate4M代价是设备端的编码器兼容性参差不齐——有些中低端机型根本没有 H.265 硬编切过去会直接报错或者回退。另外你的 PC 得能解 H.265老机器上会很吃力。建议只在网络投屏这种带宽紧张的场景下切 H.265USB 模式下 8M 的 H.264 已经足够清楚了。4.3 音频从 scrcpy 2.0 开始才真正有了声音差一点忘记说音频。2.0 版本之前的 scrcpy 是纯视频投出来的画面是哑的。2.0 开始引入--audio能在 Android 11 及以上把设备音频一起转过来。用法scrcpy --audio-codecopus --audio-bit-rate128K实际用起来有几个坑要提前知道部分定制系统会把音频通道占死导致要么没声音、要么投屏一开手机本地就静音了两种情况都算正常工作范围内的兼容性问题。如果只是想录个带声音的教程--audio-sourcemic采集手机麦克风在一些机型上反而更稳。音频缓冲--audio-buffer50能缓解爆音但会增加延迟用在录屏场景比较合适。4.4 几个高频实用开关# 录屏同时不显示窗口做素材最适合 scrcpy --recorddemo.mp4 --no-playback # 只读模式能看不能操作适合公开演示 scrcpy --no-control # 保持窗口置顶做双屏对照时很顺手 scrcpy --always-on-top --window-titlePixel 测试机 # 裁剪掉状态栏再投画面更干净 scrcpy --crop1080:1920:0:0 --max-size800--record有个细节值得单独讲它录制的是设备编码后的流不是窗口截屏所以哪怕你的电脑卡了、窗口被遮挡了录出来的视频依然干净流畅。用它做操作演示视频比录屏软件效果好一大截。再配合--no-playback后台静默录完就走非常适合批量跑测试用例时留证据。5. 拔掉数据线无线投屏的两条路和顺序问题5.1 Android 11 及以上直接用无线调试配对新系统自带无线调试功能路径是开发者选项里找到它进去选使用配对码配对设备。scrcpy 2.x 也做了适配# 第一步配对会提示输入手机上显示的 6 位配对码 adb pair 192.168.1.20:37123 # 第二步连接端口是无线调试界面上显示的那个不是配对端口 adb connect 192.168.1.20:5555 # 第三步指定设备启动 scrcpy -s 192.168.1.20:5555 --max-size1024最容易搞错的就是两个端口不是同一个。配对用的是随机高位端口比如 37123连接用的是调试端口通常是 5555也可能被系统改过。很多人只看了第一个端口配完对连不上就是这里出的问题。5.2 老设备先用 USB 授权一次再切 TCPAndroid 10 及以下的设备没有无线调试配对只能借 USB 上一次车# 插着 USB先让设备进入 TCP 模式 adb tcpip 5555 # 拔掉线用 IP 连接 adb connect 192.168.1.20:5555 # 确认已连上 adb devices # 启动加 --tcpip 让它自动处理重连逻辑 scrcpy --tcpip192.168.1.20:5555注意adb tcpip 5555这步必须在 USB 连着且已授权的情况下执行它本质上是切换 adbd 的监听方式。执行完就可以拔线了。手机重启之后这个设置会失效需要用 USB 再来一遍。5.3 无线之后卡了不要赖到 scrcpy 头上无线模式延迟明显变高的原因通常有三层Wi-Fi 本身的抖动、路由器把手机和电脑分到了不同频段或做了隔离、以及 TCP 重传。能做的优化很实在手机和电脑连同一个 5GHz 频段别用 2.4G。路由器关掉AP 隔离否则两台设备根本互相看不见。降低--max-size到 1024、码率压到 2M这点带宽对局域网毫无压力。用ping看一下时延抖动超过 20ms 抖动的 Wi-Fi 环境投屏体验就注定一般。我个人经验是无线适合演示和轻量操作真要长时间敲代码调试还是插线。省下那几秒钟的插线时间换来的是完全不同量级的操作手感。6. 打开就闪退、连上黑屏、鼠标点不动几条排查链路6.1 双击闪退九成是依赖或 adb 的问题这个现象在搜索引擎里热度很高——scrcpy 有的电脑打开闪退。排查顺序我固定成这三步命令行启动。不要双击 exe在目录里开 cmd 执行scrcpy --version。命令行会把真正的错误打出来通常是缺 dll 或者找不到 adb。看到报错你就赢了一半。检查杀毒软件。某些安全软件会把adb.exe或者scrcpy-server.jar当成可疑文件直接隔离掉尤其从压缩包里复制出来的 jar。去隔离区看一眼加白名单。检查路径。把整个文件夹挪到D:\tools\scrcpy这种纯英文无空格路径下再试。中文路径、OneDrive 同步目录、带空格的 Program Files都是高发区。还有一种情况是解压不完整——用系统自带解压或者某些第三方工具处理嵌套目录时会丢文件。重新用靠谱工具解压一遍成本最低。6.2 连上了但一片黑先分清是哪种黑黑屏要分三类处理方式完全不同特定界面黑、其他正常这是应用的FLAG_SECURE保护无解也不需要解属于正常行为。全程黑但鼠标有反应多为编码器兼容问题。试试--video-codech264或者加上--no-audio排除音频通道干扰。黑一下就退出看命令行输出。常见是设备端 jar 启动时被系统拦截或者存储空间不足导致推送失败。我有一次遇到全程黑屏折腾半小时最后发现是 USB Hub 供电不足导致传输断断续续。直接插机箱后面的主板 USB 口问题消失。这个经验分享出来是想说排查投屏问题时别只盯着软件物理链路同样值得怀疑。6.3 能看见画面但点不动前面提过的USB 调试安全设置就是主因。路径大概是开发者选项 → USB 调试安全设置→ 打开 → 确认风险提示。小米、红米、部分 OPPO / vivo 机型都需要这一步。还有两个次要原因一是--no-control被误加了检查一下命令二是设备处在某些系统级弹窗状态比如系统更新界面输入注入会被拦截。6.4 多设备同时连接时选错目标同时插着两台设备的时候scrcpy会因为不明确而报错退出。这时候用-s指定序列号adb devices scrcpy -s ABCDEFG123456另一种做法是用--select-usb或者--select-tcpip让它在启动时弹个列表给你选。另外启动脚本时如果反复报端口占用检查一下是不是上一次的 scrcpy 进程还挂在后台没退干净。6.5 排查链路小结把上面这些整理成一张速查表出问题时从上往下走现象首查项次查项双击闪退用命令行启动看报错dll 缺失、杀毒隔离、路径含中文设备列表为空换数据线、换 USB 口驱动、USB 调试开关显示 unauthorized手机上点允许授权撤销授权后重新连接画面全黑是否为安全窗口换 H.264、加 --no-audio鼠标点不动USB 调试安全设置是否误加 --no-control无线连不上配对端口与连接端口混淆同一网段、关闭 AP 隔离画面卡顿降 --max-size降码率、避开 USB Hub7. 用顺手之后的几个进阶玩法7.1 把它变成批处理脚本一键起多个窗口既然 scrcpy 是命令行工具那就意味着它可以被脚本编排。我给自己写过一个start-all.bat插上设备后一键把测试机和演示机同时投出来各自带不同窗口标题和位置start scrcpy -s 序列号A --window-title被测机 --window-x0 --window-y0 --max-size800 start scrcpy -s 序列号B --window-title对照机 --window-x820 --window-y0 --max-size800窗口位置参数在多机对照的场景下特别好用——两台设备并排显示改布局的时候一眼就能看出差异。这种零成本自动化是 GUI 工具给不了的。7.2 录屏当测试证据比截图靠谱得多前面提过--record这里补充一个组合玩法把录制和自动点击脚本结合起来每次跑完回归测试就自动存一份视频文件名带上时间戳。出问题时不用听别人描述我点了但没反应直接看视频谁的问题一目了然。这类用法在需要频繁复现偶现问题的场景里价值极高。7.3 什么时候该换成 GUI 封装的版本scrcpy 本身没有图形界面这是它的取舍不是缺点。但如果你的使用场景满足下面任意一条可以考虑用基于它做的 GUI 封装比如 QtScrcpy 这类项目需要同时管理五台以上设备还要分组。团队里有非技术同事也要用命令行对他们门槛太高。需要鼠标拖拽式的自定义按键映射来玩手游。反过来说如果你只是偶尔投一块屏幕、需要脚本化、需要最干净的延迟表现那原版 scrcpy 就是最优解。GUI 封装本质上是在它外面套了一层壳多一层就多一层出问题的可能。7.4 不投画面只把电脑当键鼠用还有一个容易被忽略的用法。有些场景你根本不需要看手机画面——比如手机连着电视做演示你只想用电脑的鼠标键盘操作手机。这时候可以考虑让 scrcpy 只做输入注入把电脑变成外接键鼠。这类模式的触发和设备的 USB OTG 支持有关属于进阶玩法用之前建议先确认设备是否支持以及在开发者选项里有没有对应的开关。7.5 键盘映射物理键盘直接打中文在投屏窗口里敲键盘输入会同步到手机的输入框包括中文输入法。这一点对写长文本特别友好——你可以在电脑上飞快打字手机上实时看到输入结果。剪贴板也是通的设备上复制的内容默认会自动同步到电脑剪贴板反过来也可以用快捷键把电脑剪贴板内容送进手机。如果不想让剪贴板自动同步比如涉及敏感内容启动时加--no-clipboard-autosync关掉即可。到这里一个从知道它是什么到能调、能修、能扩展的完整闭环就成立了。我个人在实际操作中的体会是scrcpy 这类工具的价值不在于它有多少功能而在于它把一件本来很麻烦的事变得几乎没有成本——插上线敲一个词屏幕就来了。真正的门槛往往不在工具本身而在你愿不愿意花十分钟把 adb 和开发者选项这两件事搞明白。一旦过了这道坎你会发现它能顶替掉一堆臃肿的软件而且用得越久越顺手。
Android 开源投屏 scrcpy 全解析：ADB、无线、参数与排障
几年前我第一次需要把手机画面投到电脑上做演示试过一圈方案厂商自带的多屏协同只认自家生态商业投屏软件要么要装驱动、要么免费版锁在 720p 还带水印。最后是同事丢给我一个压缩包——scrcpy-win64.zip解压、插线、双击 exe手机屏幕就这么躺在显示器上了全程没有登录、没有广告、没有后台常驻进程。从那天起副屏、录教程、调 App 布局这些事我基本都靠它。这篇文章就把 android 开源投屏工具 scrcpy 掰开揉碎讲一遍它是什么、底层怎么跑、Windows 上怎么从零点亮、参数怎么调、无线怎么接、闪退黑屏怎么救。无论你是刚接触 adb 的新手还是天天和 Android Studio 打交道的开发者都能从里面抄到能直接用的东西。1. 先搞清楚 scrcpy 是个什么东西一对进程不是一款 App1.1 电脑上只有一个可执行文件没有安装过程scrcpy 全称 screen copy由 Genymobile 开源维护许可证是 Apache-2.0。它的发行包极简Windows 版就是一个 zip解压出来是scrcpy.exe、adb.exe、SDL2.dll、avcodec-*.dll这些文件Linux 版基本得从源码编译或者用包管理器装macOS 用 Homebrew 一行brew install scrcpy。没有安装向导没有注册表写入没有开机自启。你不想用了直接把文件夹删掉系统里什么都没留下。这个设计取向很关键。它意味着 scrcpy 不会被装到手机里——手机侧不需要你手动安装任何 APK也不需要 root 权限。很多人第一次用会怀疑是不是要装个 App 到手机上答案是不用这也是它和市面上大部分投屏工具最本质的区别。1.2 手机侧那个临时工scrcpy-server手机端确实要跑东西但那是 scrcpy 自己在运行时推过去的一个 jar 包scrcpy-server.jar。它会通过 adb 被推到/data/local/tmp/下面执行投屏结束就退出。你可以理解成电脑雇了个临时工干完活就走了。因为是在 app_process 里以 shell 权限跑起来的所以它能用系统级的屏幕采集和输入注入接口而不需要安装 App、也不需要应用层权限弹窗。这带来一个很实际的好处任何设备只要能连上 adb就能被投屏。不需要在手机上点允许录屏的悬浮窗不需要辅助功能权限公司发的测试机、朋友借的手机、临时插上的平板都能立刻用。1.3 为什么一定要 adb不能用别的通道adbAndroid Debug Bridge是这套方案的地基。scrcpy 靠 adb 做三件事推送并启动服务端 jar、建立 socket 通道视频流、音频流、控制指令各走一条、以及接收设备的日志和退出码。所以USB 调试这个开关是硬性前提它不是 scrcpy 的怪癖而是整个 Android 调试体系的规定。这里有个常见误解有人以为 scrcpy 是远程桌面走的是网络协议。其实 USB 模式下数据只在数据线里跑根本没有经过局域网延迟自然低。无线模式也只是把 adb 通道从 USB 换成了 TCP协议本身没变。1.4 和同类方案摆在一起看方案是否装手机 App是否要 root延迟表现典型短板scrcpy否否USB 下很低命令行起步无 GUI厂商多屏协同是系统内置否低只支持自家品牌商业投屏软件是否一般免费版限画质、带广告系统自带投射无线显示否否偏高部分机型不开放、不能反向控制纯网络串流方案是否波动大依赖局域网质量这个表格我建议你存一下下次有人问投屏用什么的时候直接甩过去。选型的核心就一句话需要低延迟 反向控制 跨品牌scrcpy 基本是唯一不需要妥协的选项。代价是你得接受命令行而这一点后面几节会把它变成优势。2. 画面从手机屏幕到电脑显示器中间到底发生了什么2.1 采集设备侧建了一块影子屏幕scrcpy-server 启动后干的第一件事是通过 Android 的显示管理接口创建一块虚拟显示VirtualDisplay把主屏幕的内容镜像过来。这里不是截屏循环不是每隔几十毫秒抓一张 PNG——那是早期一些玩具工具的做法帧率和 CPU 占用都很惨。虚拟显示的好处是它可以被当成一个正常的 Surface 数据源交给硬件编码器去消费。顺带解释一个很多人撞过的墙为什么某些界面投出来是黑的那是应用主动设置了FLAG_SECURE安全窗口标记比如支付密码输入框、部分银行 App、某些视频 App 的版权保护页。虚拟显示拿不到这些图层的内容编码器只能编出黑色。这是系统的安全设计不是 scrcpy 的 bug也不是参数能绕过的。2.2 编码H.264 硬编是低延迟的根本原因采集到画面之后scrcpy 调用设备的 MediaCodec 硬件编码器把原始帧压成 H.264也支持 H.265/AV1。这个选择非常讲究为什么不用 MJPEGMJPEG 每帧独立压缩压缩率差8 Mbps 的带宽下画质和帧率都撑不住。为什么用硬编而不是软编硬编是手机 SoC 里的专用模块在做几乎不占 CPU也就不会出现投屏一开手机就发烫卡顿的情况。为什么默认 H.264 而不是 H.265H.265 压缩率更高、同画质下码率更低但兼容性和解码开销更敏感。默认 H.264 是所有人都能跑起来的稳妥选择追求画质再手动切 H.265。2.3 传输socket 上的裸流没有封装容器编码后的数据通过 adb 转发的 socket 送到 PC。注意这里传的是裸的编码流没有 MP4 那样的容器封装也不做重传。这么做是为了极致压低延迟——丢一两帧就丢了画面继续往前走而不是卡住等重传。所以你在弱线材或者劣质 USB Hub 上偶尔看到画面撕裂、花屏一闪就是这个机制的代价。2.4 解码与渲染PC 端其实很轻松PC 端拿到流之后交给 FFmpeg就是解压包里那一堆avcodec-*.dll解码再通过 SDL2 渲染成窗口。解码是软解但你不用担心——1080p 的 H.264 对现在的 CPU 来说负担很小一台五年前的笔记本都能轻松扛住。真正会成为瓶颈的通常是三处USB 传输质量、设备的编码器能力、以及 PC 的窗口渲染比如开了缩放又开了高分屏。2.5 反向通道你的鼠标怎么变成手指投屏是单向的用电脑操作手机才是 scrcpy 真正香的地方。控制链路是反向的PC 把鼠标位置、按键事件打包通过另一条 socket 发给设备端的服务服务再通过系统输入管理接口注入触摸和按键事件。这就解释了为什么 scrcpy 的控制是真控制而不是模拟点击注入的是系统级输入事件和你用手指点屏幕在系统看来没有区别。也正因如此某些国产定制 ROM 会额外要求开启USB 调试安全设置这一项否则投屏正常但鼠标点不动原因就在这里后面第 6 节会细说。3. Windows 上从零跑起来下载、解压、连线的完整动作3.1 别漏文件尤其那几个 dllWindows 用户的入口通常是 GitHub Releases 页里的scrcpy-win64-vX.X.zip。下载下来直接解压到一个路径里建议路径不要有中文和空格比如D:\tools\scrcpy就很好。放到C:\Program Files\或者桌面这种带空格的地方某些版本会出奇怪的加载失败。解压完检查一下目录里有没有这些东西scrcpy.exe、adb.exe、AdbWinApi.dll、AdbWinUsbApi.dll、SDL2.dll、avcodec-*.dll、avformat-*.dll、avutil-*.dll、swresample-*.dll。少任何一个是双击就闪退的头号嫌疑因为 Windows 找不到依赖库时会静默退出连报错窗口都不给。提示如果你机器上已经装过 Android Studio 或 platform-tools环境里可能已经有一份 adb。scrcpy 文件夹里自带的那份通常版本更新建议在 scrcpy 目录里执行命令确保用的是它自带的 adb避免版本不匹配导致的协议错误。3.2 手机侧三个开关少一个都不行不同品牌的叫法不一样但本质是这几项开发者选项设置里找到关于手机连续点击版本号七次部分机型是MIUI 版本或软件版本。USB 调试开发者选项里打开。USB 调试安全设置MIUI、部分 ColorOS / OriginOS 里额外存在的一项允许通过 USB 调试修改权限或模拟点击。不做这一步你会遇到能看不能点。连接时手机会弹一个允许 USB 调试吗的对话框勾选始终允许再确定。如果错过了去开发者选项里的撤销 USB 调试授权重置一下再来。3.3 adb devices 这一步才是分水岭别急着运行 scrcpy。先在解压目录里打开命令行地址栏输入cmd回车执行adb devices期望看到的是List of devices attached ABCDEFG123456 device如果看到的是unauthorized说明手机上没点授权看到offline换一根线或者换个 USB 口看到列表是空的那就是驱动或线材问题。这一步不通过scrcpy 再折腾也没用因为它的所有通信都架在 adb 之上。关于线材我可以多啰嗦一句很多投屏连不上的案例最后查出来是那根线只供电不传数据尤其是随手抓的充电线。换一根能传文件的线问题当场消失。3.4 第一次运行建议加上这两个参数设备识别正常后直接scrcpy屏幕就出来了。但我更建议第一次这样跑scrcpy --stay-awake --turn-screen-off--stay-awake让设备在插着 USB 时保持唤醒避免你正在操作它突然息屏--turn-screen-off让手机的物理屏幕立刻关掉只保留镜像输出。后者的实际价值超乎想象一是省电、减少发热二是你在演示或者录屏的时候手机屏幕是黑的旁边的人看不到你正在点什么私密性好很多。4. 参数调优画质、延迟、编码器之间怎么取舍4.1 分辨率和码率是第一优先级scrcpy 的性能调节就三个旋钮参数作用默认值建议--max-size限制长边分辨率1920弱机或无线时降到 1024--video-bit-rate视频码率8M降到 2M 换流畅升到 16M 换清晰--max-fps限制帧率不限制投屏打游戏稳 30 或 60这三者是乘法关系不是加法。你把分辨率从 1080p 降到 720p编码器的负载立刻降一半以上码率需求也跟着降。所以卡顿的第一反应应该是降--max-size而不是降帧率。帧率掉下去操作手感会很怪分辨率降一点大多数人根本看不出来。举个例子我经常用一台老笔记本给测试机做演示命令是scrcpy --max-size1024 --video-bit-rate4M --max-fps30这个配置在 USB 下几乎不可能卡。4.2 编码器切换H.265 和省流量的取舍想在同码率下拿到更好的画质可以切 H.265scrcpy --video-codech265 --video-bit-rate4M代价是设备端的编码器兼容性参差不齐——有些中低端机型根本没有 H.265 硬编切过去会直接报错或者回退。另外你的 PC 得能解 H.265老机器上会很吃力。建议只在网络投屏这种带宽紧张的场景下切 H.265USB 模式下 8M 的 H.264 已经足够清楚了。4.3 音频从 scrcpy 2.0 开始才真正有了声音差一点忘记说音频。2.0 版本之前的 scrcpy 是纯视频投出来的画面是哑的。2.0 开始引入--audio能在 Android 11 及以上把设备音频一起转过来。用法scrcpy --audio-codecopus --audio-bit-rate128K实际用起来有几个坑要提前知道部分定制系统会把音频通道占死导致要么没声音、要么投屏一开手机本地就静音了两种情况都算正常工作范围内的兼容性问题。如果只是想录个带声音的教程--audio-sourcemic采集手机麦克风在一些机型上反而更稳。音频缓冲--audio-buffer50能缓解爆音但会增加延迟用在录屏场景比较合适。4.4 几个高频实用开关# 录屏同时不显示窗口做素材最适合 scrcpy --recorddemo.mp4 --no-playback # 只读模式能看不能操作适合公开演示 scrcpy --no-control # 保持窗口置顶做双屏对照时很顺手 scrcpy --always-on-top --window-titlePixel 测试机 # 裁剪掉状态栏再投画面更干净 scrcpy --crop1080:1920:0:0 --max-size800--record有个细节值得单独讲它录制的是设备编码后的流不是窗口截屏所以哪怕你的电脑卡了、窗口被遮挡了录出来的视频依然干净流畅。用它做操作演示视频比录屏软件效果好一大截。再配合--no-playback后台静默录完就走非常适合批量跑测试用例时留证据。5. 拔掉数据线无线投屏的两条路和顺序问题5.1 Android 11 及以上直接用无线调试配对新系统自带无线调试功能路径是开发者选项里找到它进去选使用配对码配对设备。scrcpy 2.x 也做了适配# 第一步配对会提示输入手机上显示的 6 位配对码 adb pair 192.168.1.20:37123 # 第二步连接端口是无线调试界面上显示的那个不是配对端口 adb connect 192.168.1.20:5555 # 第三步指定设备启动 scrcpy -s 192.168.1.20:5555 --max-size1024最容易搞错的就是两个端口不是同一个。配对用的是随机高位端口比如 37123连接用的是调试端口通常是 5555也可能被系统改过。很多人只看了第一个端口配完对连不上就是这里出的问题。5.2 老设备先用 USB 授权一次再切 TCPAndroid 10 及以下的设备没有无线调试配对只能借 USB 上一次车# 插着 USB先让设备进入 TCP 模式 adb tcpip 5555 # 拔掉线用 IP 连接 adb connect 192.168.1.20:5555 # 确认已连上 adb devices # 启动加 --tcpip 让它自动处理重连逻辑 scrcpy --tcpip192.168.1.20:5555注意adb tcpip 5555这步必须在 USB 连着且已授权的情况下执行它本质上是切换 adbd 的监听方式。执行完就可以拔线了。手机重启之后这个设置会失效需要用 USB 再来一遍。5.3 无线之后卡了不要赖到 scrcpy 头上无线模式延迟明显变高的原因通常有三层Wi-Fi 本身的抖动、路由器把手机和电脑分到了不同频段或做了隔离、以及 TCP 重传。能做的优化很实在手机和电脑连同一个 5GHz 频段别用 2.4G。路由器关掉AP 隔离否则两台设备根本互相看不见。降低--max-size到 1024、码率压到 2M这点带宽对局域网毫无压力。用ping看一下时延抖动超过 20ms 抖动的 Wi-Fi 环境投屏体验就注定一般。我个人经验是无线适合演示和轻量操作真要长时间敲代码调试还是插线。省下那几秒钟的插线时间换来的是完全不同量级的操作手感。6. 打开就闪退、连上黑屏、鼠标点不动几条排查链路6.1 双击闪退九成是依赖或 adb 的问题这个现象在搜索引擎里热度很高——scrcpy 有的电脑打开闪退。排查顺序我固定成这三步命令行启动。不要双击 exe在目录里开 cmd 执行scrcpy --version。命令行会把真正的错误打出来通常是缺 dll 或者找不到 adb。看到报错你就赢了一半。检查杀毒软件。某些安全软件会把adb.exe或者scrcpy-server.jar当成可疑文件直接隔离掉尤其从压缩包里复制出来的 jar。去隔离区看一眼加白名单。检查路径。把整个文件夹挪到D:\tools\scrcpy这种纯英文无空格路径下再试。中文路径、OneDrive 同步目录、带空格的 Program Files都是高发区。还有一种情况是解压不完整——用系统自带解压或者某些第三方工具处理嵌套目录时会丢文件。重新用靠谱工具解压一遍成本最低。6.2 连上了但一片黑先分清是哪种黑黑屏要分三类处理方式完全不同特定界面黑、其他正常这是应用的FLAG_SECURE保护无解也不需要解属于正常行为。全程黑但鼠标有反应多为编码器兼容问题。试试--video-codech264或者加上--no-audio排除音频通道干扰。黑一下就退出看命令行输出。常见是设备端 jar 启动时被系统拦截或者存储空间不足导致推送失败。我有一次遇到全程黑屏折腾半小时最后发现是 USB Hub 供电不足导致传输断断续续。直接插机箱后面的主板 USB 口问题消失。这个经验分享出来是想说排查投屏问题时别只盯着软件物理链路同样值得怀疑。6.3 能看见画面但点不动前面提过的USB 调试安全设置就是主因。路径大概是开发者选项 → USB 调试安全设置→ 打开 → 确认风险提示。小米、红米、部分 OPPO / vivo 机型都需要这一步。还有两个次要原因一是--no-control被误加了检查一下命令二是设备处在某些系统级弹窗状态比如系统更新界面输入注入会被拦截。6.4 多设备同时连接时选错目标同时插着两台设备的时候scrcpy会因为不明确而报错退出。这时候用-s指定序列号adb devices scrcpy -s ABCDEFG123456另一种做法是用--select-usb或者--select-tcpip让它在启动时弹个列表给你选。另外启动脚本时如果反复报端口占用检查一下是不是上一次的 scrcpy 进程还挂在后台没退干净。6.5 排查链路小结把上面这些整理成一张速查表出问题时从上往下走现象首查项次查项双击闪退用命令行启动看报错dll 缺失、杀毒隔离、路径含中文设备列表为空换数据线、换 USB 口驱动、USB 调试开关显示 unauthorized手机上点允许授权撤销授权后重新连接画面全黑是否为安全窗口换 H.264、加 --no-audio鼠标点不动USB 调试安全设置是否误加 --no-control无线连不上配对端口与连接端口混淆同一网段、关闭 AP 隔离画面卡顿降 --max-size降码率、避开 USB Hub7. 用顺手之后的几个进阶玩法7.1 把它变成批处理脚本一键起多个窗口既然 scrcpy 是命令行工具那就意味着它可以被脚本编排。我给自己写过一个start-all.bat插上设备后一键把测试机和演示机同时投出来各自带不同窗口标题和位置start scrcpy -s 序列号A --window-title被测机 --window-x0 --window-y0 --max-size800 start scrcpy -s 序列号B --window-title对照机 --window-x820 --window-y0 --max-size800窗口位置参数在多机对照的场景下特别好用——两台设备并排显示改布局的时候一眼就能看出差异。这种零成本自动化是 GUI 工具给不了的。7.2 录屏当测试证据比截图靠谱得多前面提过--record这里补充一个组合玩法把录制和自动点击脚本结合起来每次跑完回归测试就自动存一份视频文件名带上时间戳。出问题时不用听别人描述我点了但没反应直接看视频谁的问题一目了然。这类用法在需要频繁复现偶现问题的场景里价值极高。7.3 什么时候该换成 GUI 封装的版本scrcpy 本身没有图形界面这是它的取舍不是缺点。但如果你的使用场景满足下面任意一条可以考虑用基于它做的 GUI 封装比如 QtScrcpy 这类项目需要同时管理五台以上设备还要分组。团队里有非技术同事也要用命令行对他们门槛太高。需要鼠标拖拽式的自定义按键映射来玩手游。反过来说如果你只是偶尔投一块屏幕、需要脚本化、需要最干净的延迟表现那原版 scrcpy 就是最优解。GUI 封装本质上是在它外面套了一层壳多一层就多一层出问题的可能。7.4 不投画面只把电脑当键鼠用还有一个容易被忽略的用法。有些场景你根本不需要看手机画面——比如手机连着电视做演示你只想用电脑的鼠标键盘操作手机。这时候可以考虑让 scrcpy 只做输入注入把电脑变成外接键鼠。这类模式的触发和设备的 USB OTG 支持有关属于进阶玩法用之前建议先确认设备是否支持以及在开发者选项里有没有对应的开关。7.5 键盘映射物理键盘直接打中文在投屏窗口里敲键盘输入会同步到手机的输入框包括中文输入法。这一点对写长文本特别友好——你可以在电脑上飞快打字手机上实时看到输入结果。剪贴板也是通的设备上复制的内容默认会自动同步到电脑剪贴板反过来也可以用快捷键把电脑剪贴板内容送进手机。如果不想让剪贴板自动同步比如涉及敏感内容启动时加--no-clipboard-autosync关掉即可。到这里一个从知道它是什么到能调、能修、能扩展的完整闭环就成立了。我个人在实际操作中的体会是scrcpy 这类工具的价值不在于它有多少功能而在于它把一件本来很麻烦的事变得几乎没有成本——插上线敲一个词屏幕就来了。真正的门槛往往不在工具本身而在你愿不愿意花十分钟把 adb 和开发者选项这两件事搞明白。一旦过了这道坎你会发现它能顶替掉一堆臃肿的软件而且用得越久越顺手。
