这个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
用户文档
该应用程序提供了许多功能和配置选项。它们在以下页面中有所记录:
资源
文章
联系方式
您可以打开[问题]报告错误报告、功能请求或一般问题。
对于错误报告,请先阅读常见问题解答,您可能会立即找到解决问题的方法。
您还可以使用:
- Reddit:
r/scrcpy
- Twitter:
@scrcpy_app
捐赠
我是@rom1v,_scrcpy_的作者和维护者。
如果您欣赏这个应用程序,您可以支持我的开源工作: - GitHub赞助 - Liberapay - PayPal
许可证
© 2018 Genymobile
© 2018-2024 Romain Vimont
根据Apache许可证第2版("许可证")许可;
您可能无法使用此文件,除非遵守本许可证。 您可以在此处获取许可证的副本
http://www.apache.org/licenses/LICENSE-2.0
除非适用法律或根据书面协议要求,否则在许可证下分发软件 根据"现状"原则,此软件受到管辖,没有任何明示或暗示的保证或条件。 有关管辖和限制权限的具体语言,请参阅许可证。