发音为“ screen copy ”
此应用程序镜像通过 USB 或TCP/IP连接的 Android 设备(视频和音频) ,并允许使用计算机的键盘和鼠标进行控制。它不需要root权限或在设备上安装应用程序。它适用于Linux、Windows和macOS。
其重点是:
- lightness:原生,仅显示设备屏幕
- 性能:30~120fps,取决于设备
- 画质:1920×1080或以上
- 低延迟:35~70ms
- 启动时间短:约 1 秒显示第一张图像
- 非侵入性:Android 设备上没有安装任何内容
- 用户利益:无需账户、无广告、无需互联网
- 自由:免费和开源软件
其特点包括:
- 音频转发(Android 11+)
- 记录
- 虚拟显示
- Android 设备屏幕关闭时镜像
- 双向复制粘贴
- 可配置质量
- 相机镜像(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 调试。
获取应用程序
必知秘诀
使用示例
有很多选项,分别在单独的页面中记录。以下仅列举一些常见示例。
-
以 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(与设备显示器分开):
scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc
-
将设备摄像头以 1920×1080 的 H.265 分辨率(和麦克风)录制到 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 # short version
用户文档
该应用程序提供了许多功能和配置选项。它们记录在以下页面中:
资源
文章
接触
您可以打开问题来报告错误、请求功能或提出一般问题。
对于错误报告,请先阅读常见问题解答,您可能会立即找到问题的解决方案。
您还可以使用:
- Reddit:
r/scrcpy
- 蓝天:
@scrcpy.bsky.social
- 叽叽喳喳:
@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.