机器翻译正文由机器翻译自项目原始文档（英文），排版经程序统一处理，可能存在偏差，请以原项目仓库为准。

[!警告]
这个 GitHub 仓库（https://github.com/Genymobile/scrcpy）是该项目的唯一官方来源。不要从随机网站下载发布版本，即使他们的名字包含 scrcpy。

scrcpy（v5.0）

发音为“screen copy”

该应用程序通过 USB 或 TCP/IP 镜像连接的 Android 设备（视频和音频），并允许使用计算机的键盘和鼠标进行控制。它不需要 root 权限或在设备上安装应用程序。它支持 Linux、Windows 和 macOS。

它的重点是：

• 轻量：原生，仅显示设备屏幕
• 性能：30~120fps，取决于设备
• 画质：1920×1080 或更高
• 低延迟: 35~70毫秒
• 启动时间短：显示第一帧图像约 1 秒
• 非侵入性：不会在 Android 设备上留下任何安装内容
• 用户利益：无需账号、无广告、不需要互联网
• 自由：自由开源软件

其功能包括：

• 音频转发（安卓 11）
• 录制
• 虚拟显示
• 使用关闭屏幕的Android设备进行镜像
• 双向 复制粘贴
• 可配置质量
• 相机镜像（安卓 12）
• 作为网络摄像头的镜像（V4L2）（仅限Linux）
• 物理 键盘 和 鼠标 模拟（HID）
• 手柄 支持
• OTG 模式
• 以及更多…

先决条件

该 Android 设备至少需要 API 21（Android 5.0）。

API >= 30（Android 11）支持音频转发。

确保您已在设备上启用 USB 调试。

在某些设备上（尤其是小米），您可能会遇到以下错误：

Injecting input events requires the caller (or the source of the instrumentation, if any) to have the INJECT_EVENTS permission.

在这种情况下，您需要启用一个额外选项 USB debugging (Security Settings)（这是与USB debugging不同的项），以便使用键盘和鼠标进行控制。设置该选项后，需要重启设备。

请注意，在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  # short version

• 在新的虚拟显示器中启动 VLC（与设备显示器分开）:

  scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc

• 使用 H.265 以 16 Mbps 的比特率在新的 flex 显示器中启动 VLC，同时保持显示器处于活动状态以防其关闭：

  scrcpy --new-display -x --keep-active --start-app=org.videolan.vlc --video-codec=h265 -b16M

• 以 H.265 格式使用设备摄像头录制 1920x1080（以及麦克风）到 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  # short version

用户文档

该应用程序提供了许多功能和配置选项。它们在以下页面中有文档说明：

• 连接
• 视频
• 音频
• 控制
• 键盘
• 鼠标
• 手柄
• 设备
• 窗口
• 录制
• 虚拟显示
• 隧道
• OTG
• 相机
• Video4Linux
• 快捷键

资源

• 常见问题
• 翻译（可能不是最新的）
• 构建说明
• 开发者
• 验证发布签名

文章

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

联系

您可以为错误报告、功能请求或一般问题提交[问题]。

对于错误报告，请先阅读常见问题，您可能会立即找到问题的解决方案。

您也可以使用：

• Reddit: r/scrcpy
• BlueSky: @scrcpy.bsky.social
• 推特：@scrcpy_app

捐赠

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

如果你喜欢这个应用程序，你可以 支持我的开源工作：

• GitHub 赞助
• Liberapay
• PayPal

许可

版权 (C) 2018 Genymobile
版权 (C) 2018-2026 罗曼·维蒙

根据 Apache 许可证 2.0 版本（“许可证”）授权；
除非符合许可证，否则您不得使用此文件。
您可以通过以下方式获得许可证副本

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

除非适用法律要求或书面同意，否则按许可证分发的软件是按“原样”提供的，
不提供任何形式的明示或暗示的保证或条件。
有关特定语言以管理许可证下的权限和限制，请参阅许可证。