scrcpy一个可以显示和控制Android设备的程序

scrcpy


此应用程序镜像通过 USB 或 TCP/IP 连接的 Android 设备(视频和音频),并允许使用计算机的键盘和鼠标进行控制。它不需要 root 权限或在设备上安装应用程序。它适用于 Linux、Windows 和 macOS。

它专注于:

  • 轻量:原生,仅显示设备屏幕
  • 性能:30~120fps,取决于设备
  • 画质:1920×1080 或更高
  • 低延迟:[35~70ms][低延迟]
  • 低启动时间:显示第一张图片仅需约 1 秒
  • 非侵入性:Android 设备上无需安装任何程序
  • 用户优势:无需账户、无广告、无需网络连接
  • 自由:免费开源软件

其功能包括:

先决条件

Android 设备至少需要 API 21(Android 5.0)。

API >= 30(Android 11+)支持 音频转发

请确保您的设备上 启用 USB 调试

在某些设备上(尤其是小米),您可能会收到以下错误:

复制代码
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,禁用音频,并通过模拟物理键盘来控制设备:
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 # 简短版本
  • 在新的虚拟显示器(独立于设备显示器)中启动 VLC:
bash 复制代码
scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc
  • 将设备摄像头(以及麦克风)以 1920x1080 像素的 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
  • 使用插入电脑的游戏手柄控制设备:
bash 复制代码
scrcpy --gamepad=uhid
scrcpy -G # 简写版

用户文档

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

资源

文章

联系方式

您可以提交 [Issues] 来报告错误、提出功能请求或提出一般问题。提交错误报告前,请先阅读 FAQ,您可能会立即找到解决方案。

您也可以使用:

许可证

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

根据 Apache 许可证 2.0 版(以下简称“许可证”)授权;除非遵守许可证规定,否则您不得使用此文件。您可以在以下网址获取许可证副本:

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

除非适用法律要求或书面同意,否则,根据许可证分发的软件均按“原样”分发,不附带任何明示或暗示的保证或条件。请参阅许可证,了解特定语言的许可和限制规定。

关于项目

此应用程序镜像通过 USB 或 TCP/IP 连接的 Android 设备(视频和音频),并允许使用计算机的键盘和鼠标进行控制。它不需要 root 权限或在设备上安装应用程序。它适用于 Linux、Windows 和 macOS。
Apache-2.0
C
129,513
12139
1319
2017-11-22
2025-10-09

增长趋势 - stars