README.zh‐CN

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调试。

获取应用程序

• Linux
• Windows（阅读 如何运行)
• macOS

必知技巧

• 降低分辨率 可大幅提高性能 (scrcpy -m1024)
• 右键单击 触发 BACK
• 中键单击 触发 HOME
• Alt+f 切换 全屏
• 还有许多其他快捷方式

使用示例

有很多选项，记录在单独的页面中。 以下只是一些常见示例。

• 以 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 # 简写

用户文档

该应用程序提供了很多功能和配置选项。它们记录在以下页面中：

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

资源

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

文章

• 介绍scrcpy
• Scrcpy现在可以无线工作
• Scrcpy 2.0，带音频

联系我们

你可以为bug报告、功能请求或一般问题打开一个issue。

对于bug报告，请先阅读FAQ，你可能会立即找到问题的解决方案。

你也可以使用以下方式联系我们：

• Reddit: r/scrcpy
• Twitter: @scrcpy_app

捐赠

@rom1v是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

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