此应用程序镜像通过 USB 或 TCP/IP 连接的 Android 设备(视频和音频),并允许使用计算机的键盘和鼠标进行控制。它不需要 root 权限或在设备上安装应用程序。它适用于 Linux、Windows 和 macOS。
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 调试(安全设置)”(此选项与“USB 调试”不同),以便使用键盘和鼠标控制设备。设置此选项后,需要重启设备。
请注意,在 OTG 模式 下运行 scrcpy 不需要 USB 调试。
有很多选项,文档 已单独列出。以下仅列举一些常见示例。
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 # 简短版本
scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc
scrcpy --video-source=camera --video-codec=h265 --camera-size=1920x1080 --record=file.mp4
scrcpy --video-source=camera --camera-size=1920x1080 --camera-facing=front --v4l2-sink=/dev/video2 --no-playback
scrcpy --otg
scrcpy --gamepad=uhid
scrcpy -G # 简写版
该应用程序提供许多功能和配置选项。它们在以下页面中进行了记录:
您可以提交 [Issues] 来报告错误、提出功能请求或提出一般问题。提交错误报告前,请先阅读 FAQ,您可能会立即找到解决方案。
您也可以使用:
r/scrcpy
@scrcpy.bsky.social
@scrcpy_app
版权所有 (C) 2018 Genymobile
版权所有 (C) 2018-2025 Romain Vimont
根据 Apache 许可证 2.0 版(以下简称“许可证”)授权;除非遵守许可证规定,否则您不得使用此文件。您可以在以下网址获取许可证副本:
http://www.apache.org/licenses/LICENSE-2.0
除非适用法律要求或书面同意,否则,根据许可证分发的软件均按“原样”分发,不附带任何明示或暗示的保证或条件。请参阅许可证,了解特定语言的许可和限制规定。