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调试。
获取应用
使用示例
有很多选项，在单独的页面中有文档。以下是一些常见示例。
-
以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 # 简短版本 -
使用设备摄像头录制1920x1080的H.265格式到MP4文件1920x1080（和麦克风）：
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 # 简短版本
用户文档
该应用程序提供了很多功能和配置选项。它们记录在以下页面中：
资源
文章
联系我们
你可以为bug报告、功能请求或一般问题打开一个issue。
对于bug报告，请先阅读FAQ，你可能会立即找到问题的解决方案。
你也可以使用以下方式联系我们：
- Reddit:
r/scrcpy - Twitter:
@scrcpy_app
捐赠
我是@rom1v，scrcpy的作者和维护者。
如果你喜欢这个应用程序，你可以支持我的开源工作：
许可证
版权所有 (C) 2018 Genymobile
版权所有 (C) 2018-2024 Romain Vimont
根据Apache许可证2.0版（“许可证”）授权；
除非符合许可证，否则你不能使用这个文件。
你可以在以下网址获取许可证副本：
http://www.apache.org/licenses/LICENSE-2.0
除非适用法律要求或书面同意，按许可证分发的软件
是按“原样”分发的，没有任何明示或暗示的担保。
参见许可证了解管理权限和限制的具体语言。