scrcpy 使用笔记
是什么
scrcpy(screen copy)— 在电脑上显示和控制 Android 设备的免费开源工具。USB 或 Wi-Fi 连接,设备端无需安装任何 App,无需 root。
解决的问题:低延迟、高质量地将 Android 屏幕镜像到 PC 并进行完整键鼠控制。
142k+ Stars,当前版本 v3.3.4,Apache 2.0 协议。
| 指标 | 数值 |
|---|---|
| 延迟 | 35–70ms(USB) |
| 帧率 | 30–120fps(设备决定) |
| 分辨率 | 最高设备原生(1080p+) |
| 启动速度 | ~1 秒出首帧 |
| 最低要求 | Android 5.0(音频需 11+,摄像头需 12+) |
安装
Windows
# 方法1:winget(推荐)
winget install Genymobile.scrcpy
# 方法2:Scoop
scoop install scrcpy
scoop install adb # 如果没装过 adb
# 方法3:Chocolatey
choco install scrcpy
# 方法4:手动下载
# 从 https://github.com/Genymobile/scrcpy/releases 下载 scrcpy-win64-vX.X.X.zip
# 解压即用,内含 adb.exe
macOS
brew install scrcpy
Linux
# Debian/Ubuntu
sudo apt install scrcpy
# Arch
sudo pacman -S scrcpy
# Fedora
sudo dnf copr enable zeno/scrcpy && sudo dnf install scrcpy
基本用法
# 即插即用,USB 连接后直接运行
scrcpy
# 降低分辨率提升性能
scrcpy -m1024
# 高质量模式:H.265 + 1920 宽 + 60fps + HID 键盘
scrcpy --video-codec=h265 -m1920 --max-fps=60 -K
# 自定义比特率
scrcpy -b2M # 2 Mbps(Wi-Fi 推荐)
scrcpy -b16M # 16 Mbps(高质量录制)
设备选择
scrcpy -d # 仅 USB 设备
scrcpy -e # 仅 TCP/IP 设备
scrcpy -s 0123456789abcdef # 指定序列号
无线连接
自动模式(推荐)
# USB 连接后执行一次,scrcpy 自动完成 IP 发现 → 切 TCP/IP → 连接 → 镜像
scrcpy --tcpip
手动模式
# 1. USB 连接,获取设备 IP
adb shell ip route | awk '{print $9}'
# 2. 启用 TCP/IP 模式
adb tcpip 5555
# 3. 拔掉 USB,无线连接
adb connect DEVICE_IP:5555
scrcpy
# 4. 结束后切回 USB
adb disconnect
adb usb
Android 11+ 无线调试(免 USB)
设置 → 开发者选项 → 无线调试 → 配对设备,然后 adb connect DEVICE_IP:PORT && scrcpy。
[!warning] Wi-Fi 性能提示 原始视频流走 TCP,Wi-Fi 丢包会触发队头阻塞。建议降低参数:
scrcpy --tcpip -b2M -m800
常用快捷键
MOD = 左 Alt 或 左 Super(可配置)
| 操作 | 快捷键 |
|---|---|
| 退出 | MOD+q |
| 全屏 | MOD+f / F11 |
| 返回 | MOD+b / 鼠标右键 |
| HOME | MOD+h / 鼠标中键 |
| 应用切换 | MOD+s / 鼠标第四键 |
| 电源 | MOD+p |
| 屏幕关闭(继续镜像) | MOD+o |
| 屏幕开启 | MOD+Shift+o |
| 旋转设备 | MOD+r |
| 通知面板 | MOD+n |
| 音量 +/- | MOD+↑/↓ |
| 捏合缩放 | Ctrl+点击拖动 |
| 复制 / 粘贴 | MOD+c / MOD+v |
| FPS 计数器 | MOD+i |
| 暂停显示 | MOD+z |
屏幕录制
# 录制视频 + 音频到 MP4
scrcpy --record=file.mp4
# MKV 格式
scrcpy --record=file.mkv
# 无头录制(无窗口)
scrcpy --no-display --record=file.mp4
# 简写
scrcpy -Nr file.mkv
# 仅录制音频
scrcpy --no-video --record=file.opus
# 限制录制时长
scrcpy --record=file.mkv --time-limit=20
# 录制时关闭设备屏幕
scrcpy --turn-screen-off --record=file.mp4
格式自动按扩展名选择:MP4、MKV、OPUS、FLAC、WAV。
高级功能
摄像头镜像(Android 12+)
# 列出设备摄像头
scrcpy --list-cameras
scrcpy --list-camera-sizes
# 前置摄像头
scrcpy --video-source=camera --camera-facing=front
# 指定分辨率录制
scrcpy --video-source=camera --camera-size=1920x1080 --record=video.mp4
虚拟显示器(v3.0+)
在独立于设备屏幕的虚拟显示器中运行 App:
scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc
OTG 模式(无需 USB 调试)
触摸屏损坏时用键鼠控制设备:
scrcpy --otg
音频控制
# 音频源选择
scrcpy --audio-source=output # 媒体音频(默认)
scrcpy --audio-source=mic # 麦克风
# 自定义编解码器和比特率
scrcpy --audio-codec=opus --audio-bit-rate=128K
V4L2 网络摄像头(仅 Linux)
把 Android 摄像头变成 PC 摄像头:
scrcpy --video-source=camera --camera-size=1920x1080 \
--v4l2-sink=/dev/video2 --no-playback
鼠标映射
| 鼠标按键 | Android 操作 |
|---|---|
| 左键 | 触摸 |
| 右键 | 返回 |
| 中键 | HOME |
| 第四键 | 应用切换 |
| 第五键 | 通知面板 |
注意事项
[!bug] 小米设备 需额外开启「USB 调试(安全设置)」选项并重启。
[!warning] 特殊字符输入 默认文本注入仅支持 ASCII。输入中文等 Unicode 字符需用 HID 模式:
scrcpy --keyboard=uhid # 或 -K
[!warning] adb 版本冲突 Android Studio 等工具自带 adb,可能与 scrcpy 的 adb 冲突。解决:
set ADB=C:\path\to\your\adb.exe # Windows export ADB=/path/to/adb # Linux/macOS
[!warning] Windows Defender 可能误报可执行文件,需添加排除项。
与其他工具对比
| 工具 | 延迟 | 设备安装 | 价格 | 亮点 |
|---|---|---|---|---|
| scrcpy | 35–70ms | 无需 | 免费 | 最低延迟,功能最全 |
| Vysor | 较高 | 需要 App | 免费增值 | 有 GUI,上手简单 |
| AirDroid | 高 | 需要 App | 免费/付费 | 文件传输、短信等附加功能 |
| QtScrcpy | 低 | 无需 | 免费 | scrcpy 核心加 GUI,中文友好 |
| Samsung DeX | 低 | 无需 | 免费(仅三星) | 桌面体验最流畅 |
适用场景
- 开发调试:在 PC 上测试 App,不用低头看手机
- 演示 / 截屏:大屏展示 App 功能
- 屏幕录制:教程、Bug 复现视频
- 无屏设备管理:屏幕损坏的设备当服务器用
- 远程支持:IT 远程排查 Android 设备问题
- 手机当摄像头(Linux):视频通话用手机画质
相关链接
- 仓库:https://github.com/Genymobile/scrcpy
- Releases:https://github.com/Genymobile/scrcpy/releases
- QtScrcpy(GUI 前端):https://github.com/nicehash/QtiASL