scrcpy
更新于 2026-11-04 09:38:22
scrcpy：免 root 的安卓投屏与控制，153k star 的老牌工具
把手机画面投到电脑，这件事在 scrcpy 之前要么装手机端 App、要么 root、要么买商业软件。scrcpy 在 2017 年开源，思路很干净：把一个小 Java server 通过 adb 推到手机上跑，画面用 MediaCodec 编码后走 adb 通道传回电脑，电脑端用 SDL + FFmpeg 解码显示，再把键盘鼠标事件反向注入。所以它不需要 root，不需要在手机上安装任何 App，退出后手机上什么都不留。
现在 153,948 star / 14,139 fork，Apache-2.0，纯 C 写的客户端，最新 v5.0.1（2026-10-08）。README 顶部有一句加粗警告：GitHub 上的 Genymobile/scrcpy 是唯一官方来源，名字里带 scrcpy 的第三方下载站不要信。
官方给的性能口径
- 30–120fps（看设备和编码能力）
- 1920×1080 或更高
- 延迟 35–70ms
- 启动约 1 秒出第一帧
- 不装东西、不要账号、没有广告、不需要联网
这几条基本就是它十几年没被替代的原因：比它功能多的更重，比它轻的没它稳。
上手：三条命令的事
前提是 Android 5.0（API 21）以上，并打开 USB 调试。
Windows 下载 scrcpy-win64-v5.0.1.zip（约 11MB，包里自带 adb）解压双击 scrcpy.exe；macOS 分 aarch64 和 x86_64 两个包；Linux 是 scrcpy-linux-x86_64-v5.0.1.tar.gz。连上手机直接运行：
scrcpy # 默认 1080p 上限、开声音、可控制
scrcpy -m1024 # 卡的时候先降分辨率，比调码率有效
scrcpy --no-audio # 只要画面
小米/红米必看的一个坑：如果报
Injecting input events requires the caller ... to have the INJECT_EVENTS permission.
不是 adb 没开好，而是要去开发者选项里再开一个 「USB 调试（安全设置）」——它和普通的「USB 调试」是两个独立开关，开完要重启一次手机，键鼠控制才生效。
无线投屏
最省事的是自动模式：先插 USB，然后
scrcpy --tcpip # 自动找 IP、开 tcpip 模式、连上、开始投
scrcpy --tcpip=192.168.1.20:5555 # 已经监听端口的设备
手动则是标准 adb 流程：adb tcpip 5555 → 拔线 → adb connect 手机IP:5555。Android 11+ 可以完全不插线，用系统「无线调试」里的配对码 adb pair IP:端口，再用另一组 IP:端口 connect。
多设备时用 -s <serial>、-d（选唯一的 USB 设备）、-e（选唯一的 TCP/IP 设备），或者直接导出 ANDROID_SERIAL 环境变量。
值得抄下来的命令
| 想干的事 | 命令 |
|---|---|
| 画质优先 | scrcpy --video-codec=h265 -b16M --max-fps=60 |
| 当物理键盘用（兼容输入法/游戏） | scrcpy -K（即 --keyboard=uhid） |
| 边投边录 | scrcpy --record=file.mp4 |
| 纯录制、不显示窗口 | scrcpy --no-playback --no-window --record=file.mkv |
| 限时录制 | scrcpy --record=file.mkv --time-limit=20 |
| 只要手机声音 | scrcpy --no-video --no-control |
| 当录音笔 | scrcpy --audio-source=mic --no-video --no-playback --record=file.opus |
| 新开一块虚拟屏跑 App | scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc |
| 虚拟屏跟随窗口大小 | scrcpy --new-display -x --keep-active --video-codec=h265 -b16M |
| 把手机摄像头当电脑摄像头 | scrcpy --video-source=camera --camera-size=1920x1080 --v4l2-sink=/dev/video2 --no-playback（Linux） |
| 完全不碰 adb 的键鼠模式 | scrcpy --otg |
| 把电脑手柄接到手机 | scrcpy -G |
几个细节值得单独说：
- 录制文件是干净的。时间戳在设备端打，网络抖动不会写进文件，所以录出来的东西不会因为 Wi-Fi 卡一下就音画不同步。容器按扩展名自动选，支持 MP4/MKV/OPUS/FLAC/WAV。
- 虚拟显示是这两年被低估的功能：手机主屏该干嘛干嘛，另一个 App 在虚拟屏里跑，窗口关掉就销毁（
--no-vd-destroy-content可以把它挪回主屏）。想拿手机当第二台「安卓小主机」用，这条命令就够了。 - 摄像头模式要求 Android 12+，且会自动把音频源切成麦克风；
--list-cameras可以先看有哪些摄像头和它们声称支持的分辨率。 - OTG 模式连 USB 调试都不需要：手机完全把电脑当成插上去的键鼠，代价是没有画面没有声音。适合给不允许开调试的设备做输入。
快捷键（MOD 默认是左 Alt 或左 Super）
| 操作 | 快捷键 |
|---|---|
| 返回 | 鼠标右键 / MOD+b |
| 主屏 | 鼠标中键 / MOD+h |
| 多任务 | MOD+s |
| 全屏 | Alt+f / MOD+f |
| 关掉手机屏幕但继续投 | MOD+o |
| 电源键 | MOD+p |
| 下拉通知栏 | MOD+n |
| 1:1 像素显示 | MOD+g |
| 去黑边 | MOD+w |
| 双指缩放/旋转 | Ctrl + 按住拖动 |
| 重置视频采集 | MOD+Shift+r |
不习惯 Alt 可以 --shortcut-mod=rctrl（可选 lctrl / rctrl / lalt / ralt / lsuper / rsuper）。
v5.0 带来了什么
- 硬件解码：
--hwdec=auto已是默认，Linux 走 VA-API、macOS 走 VideoToolbox、Windows 走 D3D11VA，解不了自动回落软件解码。硬解只在「有视频播放且不是 V4L2 输出」时可用。 - 重做视频缓冲，弱网下更稳。
- 音频回放采集模式覆盖所有 audio usage。
- 开始发布 Windows ARM64 包。
- v5.0.1 修了 Windows 上 H.265 硬解、VA-API 使用渲染器 GPU、以及 NV12 色度平面接受
DRM_FORMAT_RG88。
声音这块的现实
- 音频转发要求 Android 11+，Android 10 及以下自动静音（画面照常）。
- Android 11 上启动时手机必须解锁，scrcpy 会闪一个假弹窗让系统以为 shell 在前台，否则采集失败。
- Android 12+ 开箱即用。
- 采集失败默认不阻断投屏（除非加
--require-audio）；音频源可选output/playback/mic/mic-unprocessed/mic-camcorder等。
编译与二开
依赖 FFmpeg + SDL3（5.x 已经迁到 SDL3，不是 2）+ meson/ninja。Linux 运行依赖：
sudo apt install ffmpeg libsdl3-0 adb libusb-1.0-0 va-driver-all
编译（别用 root）：
meson setup x --buildtype=release --strip -Db_lto=true
ninja -Cx
只改客户端的话，可以直接用 Release 里的 scrcpy-server-v5.0.1 预编译 server，省掉 Android SDK 和 Java；要连 server 一起编，才需要 ANDROID_SDK_ROOT 和 gradle 那一套。官方发布物带 SHA256SUMS.txt 和 .asc 签名，doc/verify-release.md 写了怎么验。
文档拆得很细：doc/ 下按连接、视频、音频、控制、键盘、鼠标、手柄、设备、窗口、录制、虚拟显示、隧道、OTG、摄像头、V4L2、快捷键各一页，改哪个模块查哪页。
适合谁，以及几个坑
适合：安卓开发/测试要在电脑上点手机、做演示要把手机投到大屏、需要给手机录屏又不想装录屏 App、想拿旧手机当小主机跑虚拟屏的人。
要注意的：
- 只从 GitHub Releases 下载，第三方「scrccpy 中文版」之类站点风险自担。
- 小米系不打开「USB 调试（安全设置）」就只能看不能点。
- 无线模式要求电脑和手机同一网段，开了 AP 隔离或公司网络的客户端隔离会连不上。
- 硬解在 V4L2 输出或关闭播放时不可用，别拿这个判断机器性能。
- 仓库有近 3000 个 open issue，提 bug 前先翻 FAQ，很多是机型/固件问题不是代码问题。
一句话：如果只需要「把安卓投到电脑并用键鼠操作」，scrcpy 基本就是标准答案——零安装、零账号、零广告，延迟能忍，顺带还能录屏、当摄像头、开虚拟屏。153k star 是十几年一版一版磨出来的。