scrcpy 使用指南：高效的 Android 设备屏幕镜像与控制

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 调试（安全设置），以使用键盘和鼠标控制设备。
获取应用

• Linux 安装说明
  
• Windows 安装说明
  
• macOS 安装说明
  

使用示例

以下是一些常见的使用示例：

• 使用 H.265 编码捕捉屏幕，限定大小为 1920，帧率为 60fps，禁用音频，并通过模仿物理键盘控制设备：
  
  1. scrcpy --video-codec=h265 --max-size=1920 --max-fps=60 --no-audio --keyboard=uhid

  复制代码
• 录制设备前置摄像头，使用 H.265 编码，分辨率为 1920x1080，生存为 MP4 文件：
  
  1. scrcpy --video-source=camera --video-codec=h265 --camera-size=1920x1080 --record=file.mp4

  复制代码
• 捕捉设备前置摄像头，并将其作为网络摄像头输出（仅限 Linux）：
  
  1. scrcpy --video-source=camera --camera-size=1920x1080 --camera-facing=front --v4l2-sink=/dev/video2 --no-playback

  复制代码
• 不镜像设备，仅通过模仿物理键盘和鼠标控制设备（无需 USB 调试）：
  
  1. scrcpy --otg

  复制代码
• 使用计算机上的游戏手柄控制设备：
  
  1. scrcpy --gamepad=uhid

  复制代码

用户文档

以下是 scrcpy 的详细文档，涵盖了所有功能和配置选项：

• 毗连
  
• 视频设置
  
• 音频转发
  
• 控制方式
  
• 键盘设置
  
• 鼠标设置
  
• 游戏手柄设置
  
• 设备管理
  
• 窗口配置
  
• 录屏功能
  
• 隧道配置
  
• OTG 模式
  
• 摄像头设置
  
• Video4Linux
  
• 快捷键
  

其他资源

• FAQ
  
• 翻译（可能不是最新的）
  
• 构建说明
  
• 开发者文档
  

相干文章

• 先容 scrcpy
  
• Scrcpy 现在支持无线功能
  
• Scrcpy 2.0，带音频
  

联系

你可以通过以下途径与我们联系：

• 打开一个 [issue] 提出题目、错误报告或功能哀求。
  
• Reddit：r/scrcpy
  
• Twitter： @scrcpy_app
  

捐赠

我是 @rom1v，scrcpy 的作者和维护者。如果你喜好这个应用程序，接待支持我的开源工作：

• GitHub Sponsors
  
• Liberapay
  
• PayPal
  

允许证

1. 版权所有 (C) 2018 Genymobile
2. 版权所有 (C) 2018-2024 Romain Vimont
4. 根据 Apache 许可证，版本 2.0（以下简称“许可证”）许可；
5. 你不得在不遵守许可证的情况下使用此文件。
6. 你可以在以下网址获得许可证副本：
8.     http://www.apache.org/licenses/LICENSE-2.0
10. 除非适用法律要求或书面同意，软件在许可证下分发
11. 是以“按现状”提供的，没有任何明示或暗示的保证。
12. 请参阅许可证以了解有关权限和限制的具体内容。

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。