README.zh‐CN

Only the original [README] is guaranteed to be up-to-date.

只有原版的 [README] 是保证最新的。其他语言的翻译可能会有滞后。

此 GitHub 仓库 (https://github.com/Genymobile/scrcpy) 是scrcpy的唯一官方下载渠道，为了安全等因素考虑，强烈不建议从其他网站下载scrcpy。

scrcpy (v3.2)

发音为“screen copy”

此程序可将通过 USB 或 TCP/IP 连接的 Android 设备镜像至电脑（视频和音频皆可），且可直接使用计算机的键盘和鼠标进行操作，无需 root 权限，也无需在设备端安装任何应用。支持 Linux、Windows 和 macOS 系统。

特色：

• 简单轻量：原生，仅显示设备屏幕
• 性能高效：30~120fps，取决于设备
• 画质高清：1920×1080 或更高
• 延迟低：35~70ms 低延迟
• 启动迅速：仅需约1秒即可启动
• 非侵入性：无需在 Android 设备上安装应用
• 隐私安全：无需账号、无需联网、无广告
• 自由：scrcpy免费且开源

功能：

• 音频转发
• 屏幕录制
• 支持虚拟显示
• 镜像时设备可息屏
• 跨设备剪切板共享
• 可自定义镜像质量
• 镜像设备摄像头 (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调试的下方），以允许电脑端使用键盘和鼠标控制设备。详见此处。可能需要重启设备才能生效。

也可以使用OTG模式运行scrcpy。此模式无需USB调试，但设备需通过USB连接，无法镜像屏幕和音频，游戏手柄也默认禁用。

下载

• Linux
• Windows（如有需要，可阅读运行教程)
• macOS

食用方法

• 降低分辨率 可以提高性能 (scrcpy -m1024)
• 右键单击 为返回键
• 中键单击 为HOME键
• Alt+f 切换 全屏
• 其他快捷方式

示例

scrcpy还有诸多参数，可以在这里查看。以下列出了一些常见示例。

• H.265（更高质量）格式，尺寸限制为 1920 像素，帧率限制为 60fps，禁用音频，键盘为UHID模式（模拟一个直接插在设备USB口上的键盘）：

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

• OTG模式，可模拟直接插在设备USB口的键盘鼠标来控制设备，无需 USB 调试，但无法镜像设备屏幕：

scrcpy --otg

• 使用接在电脑上的游戏手柄控制器控制设备：

scrcpy --gamepad=uhid
scrcpy -G # 简写

使用手册

scrcpy还有诸多功能和配置选项，可以前往以下页面查阅。

• 连接
• 视频
• 音频
• 控制
• 键盘
• 鼠标
• 手柄
• 设备
• 窗口
• 录制
• 隧道连接
• OTG
• 摄像头
• Video4Linux
• 快捷键

其他资源

• FAQ
• 翻译（不一定最新）
• 编译说明
• 开发者文档

其他文章

• Introducing scrcpy
• Scrcpy now works wirelessly!
• Scrcpy 2.0, with audio

联系我们

如果你遇到什么bug、想要新功能或只是想问问题，都可以开一个issue。

对于bug，请先阅读FAQ，里面可能已经有你的问题了。

其他联系方式：

• Reddit: r/scrcpy
• BlueSky: @scrcpy.bsky.social
• Twitter: @scrcpy_app

捐赠

@rom1v是scrcpy的作者和维护者。

如果你喜欢scrcpy，你可以去支持一下rom1v的开源工作:

• GitHub Sponsors
• Liberapay
• PayPal

许可证

版权所有 (C) 2018 Genymobile
版权所有 (C) 2018-2025 Romain Vimont

根据Apache许可证2.0版（“许可证”）授权；
除非符合许可证，否则你不能使用这个文件。
你可以在以下网址获取许可证副本：

    http://www.apache.org/licenses/LICENSE-2.0

除非适用法律要求或书面同意，按许可证分发的软件
是按“原样”分发的，没有任何明示或暗示的担保。
参见许可证了解管理权限和限制的具体语言。