Only the original [README] is guaranteed to be up-to-date.
只有原版的 [README] 是保证最新的。
此 GitHub repo (https://github.com/Genymobile/scrcpy) 是该项目的唯一官方来源。请勿从随机网站下载版本，即使其名称包含 scrcpy。
scrcpy (v3.1)
发音为“screen copy”
此应用程序镜像通过 USB 或 通过 TCP/IP 连接的 Android 设备（视频和音频），并允许使用计算机的键盘和鼠标控制设备。它不需要任何 root 访问权限。它适用于 Linux、Windows 和 macOS。
它专注于：
- 轻量：原生，仅显示设备屏幕
- 高效：30~120fps，取决于设备
- 优质：1920×1080 或更高
- 低延迟：[35~70ms][低延迟]
- 高速：~1 秒显示第一张图片
- 非侵入性：Android 设备上没有安装任何内容
- 安全：无需帐户、无广告、无需互联网
- 自由：免费开源软件
[低延迟]：https://github.com/Genymobile/scrcpy/pull/646
它的功能包括：
- 音频转发 (Android 11+)
- 屏幕录制
- 虚拟显示
- 在 Android 设备屏幕关闭 的情况下镜像
- 跨设备剪切板共享
- 可选镜像质量
- 摄像头镜像 (Android 12+)
- 镜像为网络摄像头 (V4L2) (仅限 Linux)
- 物理 键盘 和 鼠标 模拟 (HID)
- 游戏手柄 支持
- OTG 模式
- 等等…
先决条件
Android 设备至少需要 API 21（Android 5.0）。
API >= 30（Android 11+）支持 音频转发。
确保您在设备上 启用 USB 调试。
在某些设备上（尤其是小米），您可能会遇到以下错误：
java.lang.SecurityException: Injecting input events requires the caller (or the source of the instrumentation, if any) to have the INJECT_EVENTS permission.
在这种情况下，您需要启用[附加选项][控制]USB调试（安全设置）（这是与USB调试的额外选项）以使用键盘和鼠标对其进行控制。设置此选项后，可能需要重启设备。
[控制]：https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323
请注意，在OTG模式下运行scrcpy不需要USB调试。
获取应用程序
必知技巧
使用示例
有很多选项，记录在单独的页面中。 以下只是一些常见示例。
- 以 H.265（更高质量）格式捕获屏幕，将尺寸限制为 1920，将帧速率限制为 60fps，禁用音频，并通过模拟物理键盘来控制设备：
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：
scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc
- 以 1920x1080 的 H.265 格式将设备摄像头（和麦克风）录制到 MP4 文件中：
scrcpy --video-source=camera --video-codec=h265 --camera-size=1920x1080 --record=file.mp4
- 捕获设备前置摄像头并将其作为电脑上的网络摄像头公开（在 Linux 上）：
scrcpy --video-source=camera --camera-size=1920x1080 --camera-facing=front --v4l2-sink=/dev/video2 --no-playback
- 通过模拟物理键盘和鼠标来控制设备而无需镜像（无需 USB 调试）：
scrcpy --otg
- 使用插入电脑的游戏手柄控制器来控制设备：
scrcpy --gamepad=uhid
scrcpy -G # 简写
用户文档
该应用程序提供了很多功能和配置选项。它们记录在以下页面中：
资源
文章
联系我们
你可以为bug报告、功能请求或一般问题打开一个issue。
对于bug报告，请先阅读FAQ，你可能会立即找到问题的解决方案。
你也可以使用以下方式联系我们：
- Reddit:
r/scrcpy - Twitter:
@scrcpy_app
捐赠
@rom1v是scrcpy的作者和维护者。
如果你喜欢这个应用程序，你可以支持rom1v的开源工作：
许可证
版权所有 (C) 2018 Genymobile
版权所有 (C) 2018-2025 Romain Vimont
根据Apache许可证2.0版（“许可证”）授权；
除非符合许可证，否则你不能使用这个文件。
你可以在以下网址获取许可证副本：
http://www.apache.org/licenses/LICENSE-2.0
除非适用法律要求或书面同意，按许可证分发的软件
是按“原样”分发的，没有任何明示或暗示的担保。
参见许可证了解管理权限和限制的具体语言。