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

scrcpy (v2.6.1)

图标

发音为“screen copy”**

这个应用程序镜像通过USB或TCP/IP连接的Android设备(视频和音频),并允许使用计算机的键盘和鼠标控制设备。它不需要任何_root_访问权限。它适用于_Linux_、Windows_和_macOS

截图

它的重点包括:

  • 亮度:仅显示设备屏幕
  • 性能:30~120fps,取决于设备
  • 质量:1920×1080或更高
  • 低延迟35~70ms
  • 低启动时间:约1秒显示第一张图片
  • 无侵入性:在Android设备上不留下任何安装内容
  • 用户好处:无需账户,无广告,无需互联网
  • 自由:免费且开源软件

它的功能包括: - 音频转发(Android 11+) - 录制 - 在手机屏幕关闭时镜像 - 双向复制粘贴 - 可配置的质量 - 摄像头镜像(Android 12+) - 作为网络摄像头的镜像(V4L2)(仅限Linux) - 物理键盘鼠标模拟(HID) - [OTG模式](doc/otg.md) - 等等……

先决条件

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 debugging (Security Settings)(这是一个与USB debugging不同的项目)来使用键盘和鼠标控制它。设置此选项后,设备需要重启。

请注意,在OTG模式下运行scrcpy不需要USB调试。

获取应用

使用示例

有很多选项,在单独的页面中有文档说明。 这里只是其中的一些常见示例。

  • 以H.265格式捕获屏幕(质量更好),限制大小为1920,限制帧率为60fps,禁用音频,并通过模拟物理键盘控制设备:

    bash 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格式(和麦克风)录制到MP4文件:

    bash scrcpy --video-source=camera --video-codec=h265 --camera-size=1920x1080 --record=file.mp4

  • 捕获设备前置摄像头并将其作为计算机上的网络摄像头暴露(在Linux上):

    bash scrcpy --video-source=camera --camera-size=1920x1080 --camera-facing=front --v4l2-sink=/dev/video2 --no-playback

  • 通过模拟物理键盘和鼠标(无需USB调试)控制设备:

    bash scrcpy --otg

用户文档

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

资源

文章

联系方式

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

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

您还可以使用:

捐赠

我是@rom1v,_scrcpy_的作者和维护者。

如果您欣赏这个应用程序,您可以支持我的开源工作: - GitHub赞助 - Liberapay - PayPal

许可证

© 2018 Genymobile
© 2018-2024 Romain Vimont

根据Apache许可证第2版("许可证")许可;

您可能无法使用此文件,除非遵守本许可证。 您可以在此处获取许可证的副本

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

除非适用法律或根据书面协议要求,否则在许可证下分发软件 根据"现状"原则,此软件受到管辖,没有任何明示或暗示的保证或条件。 有关管辖和限制权限的具体语言,请参阅许可证。