IMPORTANT

Escrcpy基于以下开源项目构建。相关内容仅供参考，将定期更新。

scrcpy (v3.2)

发音为 "screen copy"

此应用通过USB或TCP/IP连接镜像Android设备（视频和音频），并支持使用计算机的键盘和鼠标进行控制。它不需要_root_权限，也无需在设备上安装应用。支持_Linux_、Windows_和_macOS。

其特点包括：

• 轻量：原生实现，仅显示设备屏幕
• 高性能：30~120fps，具体取决于设备
• 高质量：1920×1080或更高分辨率
• 低延迟：35~70毫秒
• 快速启动：约1秒显示首帧画面
• 无侵入性：不会在Android设备上留下任何痕迹
• 用户友好：无需账户、无广告、无需联网
• 自由：免费开源软件

功能亮点：

• 音频转发（Android 11+）
• 录制
• 虚拟显示
• 设备屏幕关闭时镜像
• 双向复制粘贴
• 可配置画质
• 摄像头镜像（Android 12+）
• 作为网络摄像头镜像（V4L2）（仅限Linux）
• 物理键盘和鼠标模拟（HID）
• 手柄支持
• OTG模式
• 更多功能…

前提条件

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.

此时，需启用额外选项control USB调试（安全设置）（与USB调试不同），才能使用键盘和鼠标控制设备。启用后需重启设备。

注意：OTG模式下无需开启USB调试。

获取应用

• Linux
• Windows（阅读运行方法）
• macOS

必知技巧

• 降低分辨率可显著提升性能（如scrcpy -m1024）
• 右键点击触发返回
• 中键点击触发主页
• Alt+f切换全屏
• 更多快捷键

使用示例

提供多种选项，详见文档。以下为常用示例：

• 以H.265格式捕获屏幕（更高画质），限制分辨率为1920，帧率60fps，禁用音频，并通过模拟物理键盘控制设备：

  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（与设备显示分离）：

  scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc

• 以H.265格式录制设备摄像头（及麦克风）到MP4文件，分辨率1920x1080：

  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

• 使用连接到计算机的手柄控制设备：

  scrcpy --gamepad=uhid
  scrcpy -G  # 简写版本

用户文档

应用提供丰富的功能和配置选项，详见以下页面：

• 连接
• 视频
• 音频
• 控制
• 键盘
• 鼠标
• 手柄
• 设备
• 窗口
• 录制
• 虚拟显示
• 隧道
• OTG
• 摄像头
• Video4Linux
• 快捷键

资源

• 常见问题
• 翻译（可能未及时更新）
• 构建指南
• 开发者

相关文章

• Scrcpy简介
• Scrcpy现已支持无线连接
• Scrcpy 2.0，支持音频

联系方式

可通过issue提交错误报告、功能请求或一般问题。

提交错误报告前，请先阅读常见问题，可能已包含解决方案。

其他渠道：

• Reddit: r/scrcpy
• BlueSky: @scrcpy.bsky.social
• Twitter: @scrcpy_app

捐赠

我是@rom1v，Scrcpy的作者和维护者。

如果您喜欢此应用，可以支持我的开源工作：

• GitHub赞助
• Liberapay
• PayPal

许可证

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

根据Apache许可证2.0版（"许可证"）授权；
除非符合许可证要求，否则不得使用此文件。
您可以在以下网址获取许可证副本：

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

除非适用法律要求或书面同意，按"原样"分发，
无任何明示或暗示的保证或条件。
详见许可证中特定语言规定的权限和限制。