escrcpy 完整指南:把 Android 投屏到电脑并远程操控
【免费下载链接】escrcpy📱 Display and control your Android device graphically with scrcpy.项目地址: https://gitcode.com/GitHub_Trending/es/escrcpy
手机用 USB 线插在电脑上,你却不知道怎么把画面"搬"到桌面上?escrcpy 解决的就是这件事:它是一个基于 Electron 的 scrcpy 图形界面工具,负责 Android 投屏、反向操控和设备管理,默认参数下可跑到 30~120 FPS、延迟约 35~70ms,比命令行好用得多。
谁适合用 escrcpy
做 App 开发、经常要在真机上调试的工程师,用它替代一部分模拟器操作;录教程、做演示的创作者,靠它把手机画面直接喂给录制软件;手里管着几台甚至十几台安卓设备的用户,批量镜像和分组管理能省不少事。
安装 escrcpy 的三种方式
Windows 和 Linux 用户:从项目的发布页面下载对应平台的安装包,双击安装,无需准备运行环境。
macOS 用户多一个选择,在终端执行一行命令即可:
brew install homebrew-escrcpy/escrcpy/escrcpy想改代码的开发者则克隆仓库后跑起来:
git clone https://gitcode.com/GitHub_Trending/es/escrcpy cd escrcpy corepack enable pnpm pnpm install && pnpm dev从连接手机到第一次投屏
先在手机"开发者选项"里打开开发者模式和 USB 调试,然后用数据线连电脑。首次连接时手机上会弹出调试授权窗口,点一下"允许"。
打开 escrcpy,设备列表里出现你的手机后,点一下"开始镜像",画面和鼠标、键盘控制权就都到手了。不想用线?开发者选项里进入"无线调试",用二维码配对,或直接在 escrcpy 里填设备的 IP 和端口(默认 5555)连接。
到这里,第一次投屏就完成了。
用得好:进阶操作
- 同时盯多台设备:打开"窗口排列"(快捷键
Ctrl+Shift+A),多个镜像窗口会按网格自动摆正;右键设备还能建组,之后批量镜像、批量截屏、批量装包一次做完。 - 把延迟压下来:依次调三处——偏好设置→视频→最大尺寸(分辨率)、比特率(默认 8Mbps)、帧率上限(60 左右就够稳);编码器卡的话换 H.265 试试。
- 一键直达的快捷操作:设备交互栏里集成了音量、截图、返回、启动应用、文件管理、脚本执行等按钮,常用动作不用翻菜单。
- 让手机用上电脑的网络:点设备控制栏的 Gnirehtet 按钮即可反向共享网络,Windows 和 Linux 内置支持,macOS 需手动安装该组件。
- 定时自动镜像:在计划任务(cron)里设一条"每天 09:00 镜像设备 xxx",到点自动执行,适合固定场景。
排查速查
- 设备连上却不显示→ 多半是 USB 调试未授权或线只能充电 → 手机上点"允许"授权,换端口、换数据线,或先在设置里撤销 USB 调试授权再重新插拔。
- 画面卡顿、掉帧→ 码流超过了链路或编码能力 → 按"最大尺寸 → 比特率 → 帧率"的顺序依次调低,编码器换 H.265 再观察。
- 录制不出文件→ Android 10 以下不支持内部音频录制,或保存路径没有写权限 → 换一个有权限的目录重试,旧系统只录画面。
- Electron 启动报安装错误→ 依赖没装完整 → 项目根目录执行
pnpm electron-fix,不行就删掉node_modules/electron后重装依赖。
更多参数细节可查 快速上手文档。
现在就可以把手机连上,打开镜像试一次。发现 bug 或有功能想法,直接到仓库的 issue 区反馈,一起把 escrcpy 做得更好。
【免费下载链接】escrcpy📱 Display and control your Android device graphically with scrcpy.项目地址: https://gitcode.com/GitHub_Trending/es/escrcpy
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考