Genymobile/scrcpy
GitHub: Genymobile/scrcpy
通过 USB 或 WiFi 将 Android 设备屏幕高清低延迟地镜像到电脑，并用键鼠实时控制，无需 root 或安装任何手机端应用。
Stars: 136688 | Forks: 12731
**此 GitHub 仓库 () 是本项目的唯一官方来源。请勿从随机网站下载发布版，即使它们的名称包含 `scrcpy`。**
# scrcpy (v3.3.4)
_发音为 "**scr**een **c**o**py**"_
此应用程序通过 USB 或 [TCP/IP](doc/connection.md#tcpip-wireless) 镜像连接的 Android 设备（视频和音频），并允许使用计算机的键盘和鼠标进行控制。它不需要 _root_ 权限或在设备上安装任何应用。它可在 _Linux_、_Windows_ 和 _macOS_ 上运行。
它专注于：
- **轻量**：原生，仅显示设备屏幕
- **性能**：30~120fps，取决于设备
- **质量**：1920×1080 或更高
- **低延迟**：[35~70ms][lowlatency]
- **快速启动**：~1 秒显示第一张图像
- **非侵入性**：不会在 Android 设备上残留任何安装内容
- **用户利益**：无需账号，无广告，无需联网
- **自由**：免费且开源的软件
其功能包括：
- [音频转发](doc/audio.md) (Android 11+)
- [录制](doc/recording.md)
- [虚拟显示器](doc/virtual_display.md)
- [关闭 Android 设备屏幕](doc/device.md#turn-screen-off)进行镜像
- 双向[复制粘贴](doc/control.md#copy-paste)
- [可配置的质量](doc/video.md)
- [摄像头镜像](doc/camera.md) (Android 12+)
- [作为网络摄像头 (V4L2) 镜像](doc/v4l2.md) (仅限 Linux)
- 物理[键盘][hid-keyboard]和[鼠标][hid-mouse]模拟 (HID)
- [游戏手柄](doc/gamepad.md)支持
- [OTG 模式](doc/otg.md)
- 以及更多…
## 前置条件
Android 设备至少需要 API 21 (Android 5.0)。
[音频转发](doc/audio.md)支持 API >= 30 (Android 11+)。
请确保您已在设备上[启用了 USB 调试][enable-adb]。
在某些设备上（特别是 Xiaomi），您可能会遇到以下错误：
```
Injecting input events requires the caller (or the source of the instrumentation, if any) to have the INJECT_EVENTS permission.
```
在这种情况下，您需要启用[一个额外的选项][control] `USB debugging (Security Settings)`（这是一个不同于 `USB debugging` 的项目），以便使用键盘和鼠标进行控制。设置此选项后需要重启设备。
请注意，在[OTG 模式](doc/otg.md)下运行 scrcpy 不需要 USB 调试。
## 获取应用
- [Linux](doc/linux.md)
- [Windows](doc/windows.md) (阅读[如何运行](doc/windows.md#run))
- [macOS](doc/macos.md)
## 必知技巧
- [降低分辨率](doc/video.md#size)可能会大大提高性能
(`scrcpy -m1024`)
- [_右键单击_](doc/mouse.md#mouse-bindings)触发 `BACK`
- [_中键单击_](doc/mouse.md#mouse-bindings)触发 `HOME`
- Alt+f 切换[全屏](doc/window.md#fullscreen)
- 还有许多其他[快捷键](doc/shortcuts.md)
## 使用示例
有很多选项，在单独的页面中进行了[记录](#user-documentation)。
这里仅列举一些常见的示例。
- 以 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 格式录制 1920x1080 的设备摄像头（和麦克风）到 MP4 文件：
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 # 简写版本
## 用户文档
该应用程序提供了许多功能和配置选项。它们记录在以下页面中：
- [连接](doc/connection.md)
- [视频](doc/video.md)
- [音频](doc/audio.md)
- [控制](doc/control.md)
- [键盘](doc/keyboard.md)
- [鼠标](doc/mouse.md)
- [游戏手柄](doc/gamepad.md)
- [设备](doc/device.md)
- [窗口](doc/window.md)
- [录制](doc/recording.md)
- [虚拟显示器](doc/virtual_display.md)
- [隧道](doc/tunnels.md)
- [OTG](doc/otg.md)
- [摄像头](doc/camera.md)
- [Video4Linux](doc/v4l2.md)
- [快捷键](doc/shortcuts.md)
## 资源
- [常见问题解答](FAQ.md)
- [翻译][wiki] (不一定是最新的)
- [构建说明](doc/build.md)
- [开发者](doc/develop.md)
## 文章
- [介绍 scrcpy][article-intro]
- [Scrcpy 现已支持无线][article-tcpip]
- [Scrcpy 2.0，支持音频][article-scrcpy2]
## 联系方式
您可以针对错误报告、功能请求或一般问题提出 [issue]。
对于错误报告，请先阅读 [FAQ](FAQ.md)，您可能会立即找到解决问题的方法。
您也可以使用：
- Reddit: [`r/scrcpy`](https://www.reddit.com/r/scrcpy)
- BlueSky: [`@scrcpy.bsky.social`](https://bsky.app/profile/scrcpy.bsky.social)
- Twitter: [`@scrcpy_app`](https://twitter.com/scrcpy_app)
## 许可证
```
Copyright (C) 2018 Genymobile
Copyright (C) 2018-2026 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.
```
_发音为 "**scr**een **c**o**py**"_
此应用程序通过 USB 或 [TCP/IP](doc/connection.md#tcpip-wireless) 镜像连接的 Android 设备（视频和音频），并允许使用计算机的键盘和鼠标进行控制。它不需要 _root_ 权限或在设备上安装任何应用。它可在 _Linux_、_Windows_ 和 _macOS_ 上运行。
它专注于：
- **轻量**：原生，仅显示设备屏幕
- **性能**：30~120fps，取决于设备
- **质量**：1920×1080 或更高
- **低延迟**：[35~70ms][lowlatency]
- **快速启动**：~1 秒显示第一张图像
- **非侵入性**：不会在 Android 设备上残留任何安装内容
- **用户利益**：无需账号，无广告，无需联网
- **自由**：免费且开源的软件
其功能包括：
- [音频转发](doc/audio.md) (Android 11+)
- [录制](doc/recording.md)
- [虚拟显示器](doc/virtual_display.md)
- [关闭 Android 设备屏幕](doc/device.md#turn-screen-off)进行镜像
- 双向[复制粘贴](doc/control.md#copy-paste)
- [可配置的质量](doc/video.md)
- [摄像头镜像](doc/camera.md) (Android 12+)
- [作为网络摄像头 (V4L2) 镜像](doc/v4l2.md) (仅限 Linux)
- 物理[键盘][hid-keyboard]和[鼠标][hid-mouse]模拟 (HID)
- [游戏手柄](doc/gamepad.md)支持
- [OTG 模式](doc/otg.md)
- 以及更多…
## 前置条件
Android 设备至少需要 API 21 (Android 5.0)。
[音频转发](doc/audio.md)支持 API >= 30 (Android 11+)。
请确保您已在设备上[启用了 USB 调试][enable-adb]。
在某些设备上（特别是 Xiaomi），您可能会遇到以下错误：
```
Injecting input events requires the caller (or the source of the instrumentation, if any) to have the INJECT_EVENTS permission.
```
在这种情况下，您需要启用[一个额外的选项][control] `USB debugging (Security Settings)`（这是一个不同于 `USB debugging` 的项目），以便使用键盘和鼠标进行控制。设置此选项后需要重启设备。
请注意，在[OTG 模式](doc/otg.md)下运行 scrcpy 不需要 USB 调试。
## 获取应用
- [Linux](doc/linux.md)
- [Windows](doc/windows.md) (阅读[如何运行](doc/windows.md#run))
- [macOS](doc/macos.md)
## 必知技巧
- [降低分辨率](doc/video.md#size)可能会大大提高性能
(`scrcpy -m1024`)
- [_右键单击_](doc/mouse.md#mouse-bindings)触发 `BACK`
- [_中键单击_](doc/mouse.md#mouse-bindings)触发 `HOME`
- Alt+f 切换[全屏](doc/window.md#fullscreen)
- 还有许多其他[快捷键](doc/shortcuts.md)
## 使用示例
有很多选项，在单独的页面中进行了[记录](#user-documentation)。
这里仅列举一些常见的示例。
- 以 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 格式录制 1920x1080 的设备摄像头（和麦克风）到 MP4 文件：
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 # 简写版本
## 用户文档
该应用程序提供了许多功能和配置选项。它们记录在以下页面中：
- [连接](doc/connection.md)
- [视频](doc/video.md)
- [音频](doc/audio.md)
- [控制](doc/control.md)
- [键盘](doc/keyboard.md)
- [鼠标](doc/mouse.md)
- [游戏手柄](doc/gamepad.md)
- [设备](doc/device.md)
- [窗口](doc/window.md)
- [录制](doc/recording.md)
- [虚拟显示器](doc/virtual_display.md)
- [隧道](doc/tunnels.md)
- [OTG](doc/otg.md)
- [摄像头](doc/camera.md)
- [Video4Linux](doc/v4l2.md)
- [快捷键](doc/shortcuts.md)
## 资源
- [常见问题解答](FAQ.md)
- [翻译][wiki] (不一定是最新的)
- [构建说明](doc/build.md)
- [开发者](doc/develop.md)
## 文章
- [介绍 scrcpy][article-intro]
- [Scrcpy 现已支持无线][article-tcpip]
- [Scrcpy 2.0，支持音频][article-scrcpy2]
## 联系方式
您可以针对错误报告、功能请求或一般问题提出 [issue]。
对于错误报告，请先阅读 [FAQ](FAQ.md)，您可能会立即找到解决问题的方法。
您也可以使用：
- Reddit: [`r/scrcpy`](https://www.reddit.com/r/scrcpy)
- BlueSky: [`@scrcpy.bsky.social`](https://bsky.app/profile/scrcpy.bsky.social)
- Twitter: [`@scrcpy_app`](https://twitter.com/scrcpy_app)
## 许可证
```
Copyright (C) 2018 Genymobile
Copyright (C) 2018-2026 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.
```
标签：ADB, Android, Android开发工具, DSL, FFmpeg, FPS, Genymobile, H.264, HID模拟, JS文件枚举, LangChain, OTG模式, PE 加载器, scrcpy, TCP/IP, USB调试, V4L2, 二进制发布, 低延迟, 免Root, 免安装, 剪贴板同步, 反向控制, 客户端加密, 屏幕录制, 屏幕投屏, 屏幕镜像, 并发处理, 开源工具, 手机电脑互联, 技术支持工具, 摄像头镜像, 无线投屏, 桌面控制, 游戏手柄支持, 移动设备管理, 网络摄像头, 虚拟显示器, 轻量级, 远程控制, 键盘鼠标映射, 音频转发, 高帧率