快速上手

scrcpy

读作 “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 模式
以及更多……

先决条件

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 debugging (Security Settings)（该选项不同于 USB debugging），以便可使用键盘和鼠标进行控制。设置该选项后需重启设备。

注意，以OTG 模式运行 scrcpy 不需要 USB 调试。

获取应用

必备技巧

降低分辨率可显著提升性能（scrcpy -m1024）
右键单击触发 BACK
中键单击触发 HOME
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  # short version

在新的虚拟显示（与设备显示分离）中启动 VLC：
Terminal window
```
scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc
```
以 H.265 在 1920x1080 分辨率下（以及麦克风）录制设备摄像头到 MP4 文件：
Terminal window
```
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 调试）：
Terminal window
```
scrcpy --otg
```
使用连接到电脑的游戏手柄控制设备：
Terminal window
```
scrcpy --gamepad=uhid
scrcpy -G  # short version
```

用户文档

本应用提供大量功能和配置选项，详见以下页面：

资源

常见问题
翻译（不一定最新）
构建说明
开发者

文章

联系

您可以提交[问题]用于漏洞报告、功能请求或一般问题。

对于漏洞报告，请先阅读常见问题，您可能会立即找到解决方案。

您还可以通过以下渠道：

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

捐赠

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

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

许可证

Copyright (C) 2018 Genymobile
Copyright (C) 2018-2025 Romain Vimont

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

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

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.