1 分钟投屏 Android:scrcpy 投屏与操控速查教程
【免费下载链接】scrcpyDisplay and control your Android device项目地址: https://gitcode.com/GitHub_Trending/sc/scrcpy
给别人演示手机上刚做的 App 时,你是否也被手机那块小屏幕折磨过:字太小看不清、没法录屏、双手又要点手机又要操作电脑。scrcpy就是为这个场景准备的开源 Android 投屏工具——把手机屏幕的音视频镜像到电脑窗口,让你直接用电脑键盘和鼠标操控手机,手机上不装任何 App、不需要 root。
先记几个硬指标:Android 5.0+ 即可投屏(音频转发需 Android 11+)、Windows / macOS / Linux 全平台支持、约 1 秒出第一帧、操控延迟 35~70ms、30~120fps、完全免费开源。
为什么选它
- 零手机侧残留:scrcpy 只在设备端临时运行一个 server 进程,退出即消失,不安装 App、不需要 root。这是它和各类「手机助手」类投屏软件最大的差异。
- 原生轻快:客户端只做一件事——显示设备画面,没有账号、没有广告、不联网,启动约 1 秒出画面。
- 一条命令干三件事:投屏、操控、录制同时成立。多数投屏工具只能看不能控,或只能控不能录;scrcpy 三者都开箱即用。
- 输入是真注入:支持模拟物理键盘 / 鼠标 / 手柄(HID),不是简单的触屏转点,适合自动化测试和手游操作。
3 分钟跑通
按顺序走这 5 步,每步都有验收标准:
确认系统版本:手机是 Android 5.0 以上即可投屏;想要声音同步到电脑,需要 Android 11+。 你该看到什么:「设置 → 关于手机」里的版本号满足门槛。
开启 USB 调试:手机进入「设置 → 开发者选项」,打开「USB 调试」。 你该看到什么:开关变为开启状态(部分机型需先打开「开发者选项」)。
安装 adb(scrcpy 靠它和手机通信):
- Windows:第 4 步装 scrcpy 时会一并装好,不用单独操心;
- macOS:
brew install --cask android-platform-tools; - Linux:发行版通常自带,或用包管理器安装。 你该看到什么:终端执行
adb version能打印版本号。
安装 scrcpy:
Windows:
winget install --exact Genymobile.scrcpymacOS:
brew install scrcpyArch Linux:
pacman -S scrcpy其他 Linux 发行版(apt 源版本偏旧):从官方 release 下载静态压缩包解压,或从源码安装:
git clone https://gitcode.com/GitHub_Trending/sc/scrcpy cd scrcpy ./install_release.sh
你该看到什么:终端执行
scrcpy --version打印版本号(当前为 v3.3.4)。连接设备:用数据线把手机插到电脑,手机弹出「允许 USB 调试」时勾选始终允许并确认。 你该看到什么:执行
adb devices后设备列表里出现一台设备,状态为device。
全部满足后,打开终端输入:
scrcpy约 1 秒后弹出窗口显示手机画面,看到手机桌面就说明跑通了。Android 11+ 的手机,声音会同时从电脑播出。
试一下这几个无需参数的基本操作:左键点击 = 点按屏幕;右键 = 返回键;中键 = Home 键;Alt+f切换全屏。完整快捷键见 doc/shortcuts.md。
分场景实战
多设备测试机:精准指定一台
同时连了多台手机时,先查序列号再指定:
adb devices scrcpy -s 0123456789abcdef为什么这样配:adb devices列出所有设备及其序列号;-s后面跟序列号即可锁定目标,避免「多台设备」报错。也可以用-d只选 USB 设备、-e只选 TCP/IP 设备,见 doc/connection.md。
无线投屏:拔掉数据线
手机和电脑在同一 Wi-Fi 下,首次用 USB 连一次后执行:
scrcpy --tcpip之后就可以拔掉数据线,直接指定 IP 连接:
scrcpy --tcpip=192.168.1.100为什么这样配:--tcpip(不带参数)会自动找到手机 IP、开启 adb 的 TCP/IP 模式并切换到 Wi-Fi 连接;已知 IP 时用--tcpip=IP一步连上,端口默认 5555。
录屏:在手机上编码,文件永远干净
scrcpy --record=screen.mp4只录视频不录声音:
scrcpy --no-audio --record=file.mp4为什么这样配:编码在手机端完成、时间戳也在手机端打,所以即使投屏窗口卡顿,录出来的文件也是干净的。容器格式按文件名后缀自动选(.mp4、.mkv、.opus、.flac、.wav),详见 doc/recording.md。
手机当录音笔:麦克风直接录到电脑
scrcpy --audio-source=mic --no-video --no-playback --record=file.opus为什么这样配:--audio-source=mic切换为采集麦克风而非系统声音;--no-video --no-playback关掉窗口和画面只留音频通道,文件直接落在电脑本地。需要时Ctrl+C停止。
虚拟显示:主屏之外再开一块屏
scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc为什么这样配:--new-display在手机上新建一块独立屏幕投到电脑,不干扰主屏,退出即销毁;配合--start-app可直接在这块屏上启动指定 App,适合开一个干净的演示窗口。高级用法见 doc/virtual-display.md。
手机当网络摄像头:Linux 下接入视频会议
scrcpy --video-source=camera --camera-size=1920x1080 --v4l2-sink=/dev/video2 --no-playback为什么这样配:--v4l2-sink把视频流写成 V4L2 虚拟摄像头设备,视频会议软件就能把它当成一个摄像头使用(仅 Linux 支持,Android 12+ 才能采摄像头);--no-playback关掉本地播放窗口。见 doc/v4l2.md。
手柄玩手机游戏:物理手柄模拟
scrcpy --gamepad=uhid为什么这样配:uhid模式通过设备端 UHID 内核模块模拟物理手柄,手机端会认为插了一个真手柄,游戏原生识别;需要多个手柄也选它(aoa模式在 Windows 上仅 OTG 可用)。见 doc/gamepad.md。
传文件:拖进去就完事
- APK 文件:直接拖进 scrcpy 窗口,手机上自动弹出安装;
- 其他文件:拖进窗口即推送到手机存储。
不需要敲任何adb命令,见 doc/control.md 的 push 章节。
调优手册
日常调优只需要下面四个参数:
| 参数 | 作用 | 取值建议 |
|---|---|---|
--max-size(-m) | 宽高上限,另一维按比例缩放,不改比例 | 1024~1920,越大越吃带宽 |
--video-bit-rate(-b) | 视频码率,默认 8M | 卡顿先降到 2M~4M |
--max-fps | 帧率上限 | 看文档 30 够,游戏给 60 |
--video-codec | 编码:h264(默认)/h265/av1 | 要更高画质用h265 |
按症状开「处方」:
症状:画面卡顿→ 降分辨率 + 限帧,优先降码率:
scrcpy -m 1024 --max-fps=30 scrcpy --tcpip -b 4M症状:追求画质(录制 / 演示)→ 1080p + 高码率 + h265:
scrcpy -m 1920 -b 8M --video-codec=h265 --record=screen.mp4症状:只看不动作,想画面更平滑→ 牺牲一点延迟换缓冲:
scrcpy --video-buffer=200 --audio-buffer=200日常平衡:scrcpy -m 1280一条命令搞定。
故障自检清单
症状:终端提示找不到设备 /adb devices列为空大概率原因:USB 调试没开、手机没授权,或线只充电不传数据一步解决:确认「允许 USB 调试」弹窗已勾选始终允许;换一根支持数据传输的线;adb devices状态应为device。
症状:报错INJECT_EVENTS permission(小米机型常见)大概率原因:部分厂商需额外开关才能注入按键事件一步解决:开发者选项里再打开「USB 调试(安全设置)」,重启手机一次即可用键盘鼠标控制。
症状:有画面没声音大概率原因:音频转发要求 Android 11+;Android 11 还要求启动时屏幕处于解锁状态;个别设备缺 Opus 编码器一步解决:确认系统版本;启动前点亮并解锁屏幕;换编码scrcpy --audio-codec=aac;不需要声音就加--no-audio。
症状:报错Failed to initialize audio/opus大概率原因:设备没有 Opus 编码器一步解决:scrcpy --audio-codec=aac改用 AAC 编码,见 doc/audio.md。
症状:投屏卡顿大概率原因:分辨率 / 码率太高,或网络 / 线材带宽不够一步解决:先scrcpy -m 1024 --max-fps=30试;无线连接降码率scrcpy --tcpip -b 4M;有线确认用的是 USB 3.0 以上的线。
症状:Windows 下双击 scrcpy.exe,窗口一闪就没了大概率原因:直接运行 exe 时错误信息来不及看一步解决:解压目录里的scrcpy-console.bat从终端启动,能看到完整报错;固定参数可写进一个myscrcpy.bat里双击运行。
延伸阅读
- doc/shortcuts.md:完整快捷键列表,做剪贴板同步、截图、音量键等进阶操作前读它
- doc/connection.md:USB 与无线连接详细配置、多设备选择的 4 种方式
- doc/video.md 与 doc/audio.md:显示、编码、方向、缓冲的全部音视频参数
- doc/recording.md:录制容器格式选择、时长限制
- FAQ.md:官方高频问题汇总,排查故障前先翻一遍
回到开头那个场景:演示 App 时,把手机插上电脑,执行scrcpy——1 秒后你的「大号显示器」就出现在桌面,键盘鼠标接管一切,手机侧零残留。下一步就可以试试scrcpy --record=screen.mp4,把这次演示直接录成干净的视频。
【免费下载链接】scrcpyDisplay and control your Android device项目地址: https://gitcode.com/GitHub_Trending/sc/scrcpy
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考