scrcpy (v2.7)
pronounced “screen copy”
项目简介
scrcpy 是一个开源应用程序，可以通过 USB 或 TCP/IP 连接的 Android 设备进行屏幕镜像（视频和音频），并允许使用计算机的键盘和鼠标控制设备。它不需要任何 root 权限，支持 Linux、Windows 和 macOS 系统。
关键特点
- 轻量：原生应用，仅显示设备屏幕
- 高性能：30~120fps，取决于设备
- 高清：1920×1080 或更高
- 低延迟：35~70ms
- 快速启动：~1 秒显示第一帧图像
- 不干扰：设备上不留下任何痕迹
- 无广告、无需联网
- 自由：免费和开源软件
功能亮点
- 音频转发（Android 11+）
- 录屏
- 关闭设备屏幕时的镜像
- 双向 复制粘贴
- 可配置的视频质量
- 摄像头镜像（Android 12+）
- 作为网络摄像头镜像（V4L2）(仅限 Linux)
- 物理 键盘 和 鼠标 模拟（HID）
- 游戏手柄 支持
- OTG 模式
- 以及更多…
前置条件
- Android 设备至少需要 API 21（Android 5.0）。
- 音频转发 需要 API >= 30（Android 11+）。
- 启用设备的 [USB 调试][enable-adb]。
有些设备（如小米设备）可能会遇到以下错误：
java.lang.SecurityException: Injecting input events requires the caller (or the source of the instrumentation, if any) to have the INJECT_EVENTS permission.
在这种情况下，启用额外选项：USB 调试（安全设置），以使用键盘和鼠标控制设备。
获取应用
使用示例
以下是一些常见的使用示例：
-
使用 H.265 编码捕获屏幕，限制大小为 1920，帧率为 60fps，禁用音频，并通过模拟物理键盘控制设备：
scrcpy --video-codec=h265 --max-size=1920 --max-fps=60 --no-audio --keyboard=uhid -
录制设备前置摄像头，使用 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 -
使用计算机上的游戏手柄控制设备：
扫描二维码关注公众号，回复： 17523143 查看本文章
scrcpy --gamepad=uhid
用户文档
以下是 scrcpy 的详细文档，涵盖了所有功能和配置选项：
其他资源
相关文章
联系
你可以通过以下途径与我们联系：
- 打开一个 [issue] 提出问题、错误报告或功能请求。
- 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
除非适用法律要求或书面同意，软件在许可证下分发
是以“按现状”提供的，没有任何明示或暗示的保证。
请参阅许可证以了解有关权限和限制的具体内容。