README.zh Hans

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

只有原版的 README 是保证最新的。

Translation based on version 2.7

本文根据 2.7 版本进行翻译。

这个GitHub仓库 (https://github.com/Genymobile/scrcpy) 是该项目唯一的官方来源。不要从随机网站下载发布版本，即使它们的名称包含 scrcpy。

scrcpy (v2.7)

发音 "screen copy"

这个应用程序可以镜像通过USB或通过TCP/IP连接的安卓设备（视频和音频），并允许使用电脑的键盘和鼠标控制设备。它不需要任何_root_权限。它可以在_Linux_、_Windows_和_macOS_上运行。

它的重点是：

• 轻量: 原生，仅显示设备屏幕
• 性能: 30~120fps，取决于设备
• 质量: 1920×1080或更高
• 低延迟: 35~70ms
• 启动时间短: ~1秒显示第一张图片
• 无侵入性: 不会在安卓设备上留下任何安装痕迹
• 用户受益: 无需账户，无广告，无需网络
• 自由: 免费和开源软件

其功能包括：

• 音频转发 (Android 11+)
• 录制
• 在安卓设备屏幕关闭情况下镜像
• 双向复制粘贴
• 可配置质量
• 摄像头镜像 (Android 12+)
• 作为网络摄像头镜像 (V4L2) (仅限Linux)
• 物理键盘和鼠标模拟 (HID)
• 游戏手柄支持
• OTG模式
• 以及更多…

前提条件

安卓设备至少需要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调试。

获取应用

• Linux
• Windows
• macOS

使用示例

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

• 以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  # 简短版本

• 以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  # 简短版本

用户文档

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

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

资源

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

文章

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

联系方式

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

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

你也可以使用：

• Reddit: r/scrcpy
• Twitter: @scrcpy_app

捐赠

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

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

• GitHub Sponsors
• Liberapay
• PayPal

许可证

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

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

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

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