This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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

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