Genymobile/scrcpy 源码：https://github.com/Genymobile/scrcpy 此 GitHub 仓库 () 是该项目的唯一官方来源。请勿从随机网站下载发布版本，即使其名称中包含 scrcpy。 # scrcpy (v4.0) 读作 “screen copy” 本应用程序可镜像通过 USB 或 TCP/IP 连接的 Android 设备（视频和音频），并允许使用电脑的键盘和鼠标进行控制。它不需要 root 权限，也不需要设备上安装任何应用。它支持 Linux、Windows 和 macOS。 Linux Windows macOS 截图 它专注于： - 轻量级：原生实现，仅显示设备屏幕 - 高性能：30~120fps，具体取决于设备 - 高质量：1920×1080 或更高 - 低延迟：[35~70ms][lowlatency] - 启动速度快：约 1 秒即可显示第一帧图像 - 无侵入性：Android 设备上不会残留任何安装内容 - 用户受益：无需账户、无广告、无需互联网 - 自由：免费且开源的软件 [lowlatency]: https://github.com/Genymobile/scrcpy/pull/646 其功能包括： - 音频转发（Android 11+） - 录制 - 虚拟显示器 - 在Android 设备屏幕关闭时镜像 - 双向复制-粘贴 - 可配置质量 - 摄像头镜像（Android 12+） - 作为网络摄像头镜像 (V4L2)（仅限 Linux） - 物理[键盘][hid-keyboard]和[鼠标][hid-mouse]模拟（HID） - 游戏手柄支持 - OTG 模式 - 等等… [hid-keyboard]: doc/keyboard.md#physical-keyboard-simulation [hid-mouse]: doc/mouse.md#physical-mouse-simulation ## 先决条件 Android 设备需要至少 API 21（Android 5.0）。音频转发 支持 API >= 30（Android 11+）。确保已在设备上[启用 USB 调试][enable-adb]。 [enable-adb]: https://developer.android.com/studio/debug/dev-options#enable 在某些设备（尤其是小米）上，您可能会遇到以下错误： 注入输入事件需要调用者（或如有，仪器测试的来源）具有 INJECT_EVENTS 权限。 在这种情况下，您需要启用[额外选项][control] USB 调试（安全设置）（这与 USB 调试 是不同的项目），以便使用键盘和鼠标控制。设置此选项后，需要重启设备。 [control]: https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323 注意，在 OTG 模式 下运行 scrcpy 不需要 USB 调试。 ## 获取应用 - Linux - Windows（阅读如何运行） - macOS ## 必知技巧 - 降低分辨率 可以极大提升性能（scrcpy -m1024） - 右键点击 触发 BACK - 中键点击 触发 HOME - Alt+f 切换全屏 - 还有许多其他快捷键 ## 使用示例 有很多选项，在单独的页面中有文档说明。以下是一些常见示例。 - 以 H.265（更好质量）捕获屏幕，限制大小为 1920，限制帧率为 60fps，禁用音频，并通过模拟物理键盘控制设备： bash scrcpy --video-codec=h265 --max-size=1920 --max-fps=60 --no-audio --keyboard=uhid scrcpy --video-codec=h265 -m1920 --max-fps=60 --no-audio -K # 简写版本 - 在新虚拟显示器中启动 VLC（与设备显示器分离）： bash scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc - 使用 H.265 在 16 Mbps 码率的新_灵活_显示器中启动 VLC，同时保持显示器处于活动状态，使其不会关闭： bash scrcpy --new-display -x --keep-active --start-app=org.videolan.vlc --video-codec=h265 -b16M - 录制设备摄像头在 H.265 下 1920x1080（及麦克风）到 MP4 文件： bash scrcpy --video-source=camera --video-codec=h265 --camera-size=1920x1080 --record=file.mp4 - 捕获设备前置摄像头并在电脑上作为网络摄像头暴露（仅限 Linux）： bash scrcpy --video-source=camera --camera-size=1920x1080 --camera-facing=front --v4l2-sink=/dev/video2 --no-playback - 通过模拟物理键盘和鼠标控制设备而无需镜像（不需要 USB 调试）： bash scrcpy --otg - 使用插入电脑的游戏手柄控制设备： bash scrcpy --gamepad=uhid scrcpy -G # 简写版本 ## 用户文档 应用程序提供了许多功能和配置选项。它们在以下页面中有文档说明： - 连接 - 视频 - 音频 - 控制 - 键盘 - 鼠标 - 游戏手柄 - 设备 - 窗口 - 录制 - 虚拟显示器 - 隧道 - OTG - 摄像头 - Video4Linux - 快捷键 ## 资源 - 常见问题 - [翻译][wiki]（可能不是最新的） - 构建说明 - 开发者 - 验证发布签名 [wiki]: https://github.com/Genymobile/scrcpy/wiki ## 文章 - [介绍 scrcpy][article-intro] - [Scrcpy 现在支持无线连接][article-tcpip] - [Scrcpy 2.0，带音频支持][article-scrcpy2] [article-intro]: https://blog.rom1v.com/2018/03/introducing-scrcpy/ [article-tcpip]: https://www.genymotion.com/blog/open-source-project-scrcpy-now-works-wirelessly/ [article-scrcpy2]: https://blog.rom1v.com/2023/03/scrcpy-2-0-with-audio/ ## 联系方式 您可以打开一个 [issue] 来报告 bug、请求功能或提出一般性问题。对于 bug 报告，请先阅读 常见问题，您可能会立即找到解决问题的方法。 [issue]: https://github.com/Genymobile/scrcpy/issues 您还可以使用： - Reddit: r/scrcpy (https://www.reddit.com/r/scrcpy) - BlueSky: @scrcpy.bsky.social (https://bsky.app/profile/scrcpy.bsky.social) - Twitter: @scrcpy_app (https://twitter.com/scrcpy_app) ## 捐赠 我是 @rom1v (https://github.com/rom1v)，scrcpy 的作者和维护者。如果您喜欢这个应用程序，您可以[支持我的开源工作][donate]： - GitHub Sponsors (https://github.com/sponsors/rom1v) - Liberapay (https://liberapay.com/rom1v/) - PayPal (https://paypal.me/rom2v) [donate]: https://blog.rom1v.com/about/#support-my-open-source-work ## 许可证 Copyright (C) 2018 Genymobile Copyright (C) 2018-2026 Romain Vimont Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.