【精选】开源投屏工具scrcpy（手机投屏到电脑）介绍

地址：https://github.com/Genymobile/scrcpy

Scrcpy可以显示并控制通过 USB (或 TCP/IP) 连接的安卓设备，且不需要任何 root 权限。本程序支持 GNU/Linux, Windows 和 macOS。

功能：

安卓设备最低需要支持 API 21 (Android 5.0)。

确保设备已开启 adb 调试。

在某些设备上，还需要开启额外的选项以使用鼠标和键盘进行控制。

也可以使用 Chocolatey：

或者 Scoop:

Scrcpy已发布到 Homebrew。直接安装即可：

你还需要在 PATH 内有 adb。如果还没有：

或者通过 MacPorts，该方法同时设置好 adb：

连接安卓设备，然后执行：

查看参数列表：

有时候，可以通过降低镜像的分辨率来提高性能。

要同时限制宽度和高度到某个值 (例如 1024)：

另一边会被按比例缩小以保持设备的显示比例。这样，1920×1080 分辨率的设备会以 1024×576 的分辨率进行镜像。

默认码率是 8 Mbps。改变视频码率 (例如改为 2 Mbps)：

要限制采集的帧率：

本功能从 Android 10 开始才被官方支持，但在一些旧版本中也能生效。

可以对设备屏幕进行裁剪，只镜像屏幕的一部分。

例如可以只镜像 Oculus Go 的一只眼睛。

如果同时指定了 --max-size，会先进行裁剪，再进行缩放。

要锁定镜像画面的方向：

只影响录制的方向。

一些设备内置了多种编码器，但是有的编码器会导致问题或崩溃。可以手动选择其它编码器：

要列出可用的编码器，可以指定一个不存在的编码器名称，错误信息中会包含所有的编码器：

可以在镜像的同时录制视频：

仅录制，不显示镜像：

录制时会包含“被跳过的帧”，即使它们由于性能原因没有实时显示。设备会为每一帧打上 时间戳 ，所以 包时延抖动 不会影响录制的文件。

在 Linux 上，可以将视频流发送至 v4l2 回环 (loopback) 设备，因此可以使用任何 v4l2 工具像摄像头一样打开安卓设备。

需安装 v4l2loopback 模块：

创建一个 v4l2 设备：

这样会在 /dev/videoN 创建一个新的视频设备，其中 N 是整数。 (更多选项 可以用来创建多个设备或者特定 ID 的设备)。

列出已启用的设备：

使用一个 v4l2 漏开启 scrcpy：

(将 N 替换为设备 ID，使用 ls /dev/video* 命令查看)

启用之后，可以使用 v4l2 工具打开视频流：

例如，可以在 OBS 中采集视频。

可以加入缓冲，会增加延迟，但可以减少抖动 (见 #2464)。

对于显示缓冲：

对于 V4L2 漏:

Scrcpy 使用 adb 与设备通信，并且 adb 支持通过 TCP/IP 连接到设备:

将设备和电脑连接至同一 Wi-Fi。

打开 设置 → 关于手机 → 状态信息，获取设备的 IP 地址，也可以执行以下的命令：

启用设备的网络 adb 功能： adb tcpip 5555。

断开设备的 USB 连接。

连接到您的设备：adb connect DEVICE_IP:5555 (将 DEVICE_IP 替换为设备 IP)。

正常运行 scrcpy。

可能降低码率和分辨率会更好一些：

如果 adb devices 列出了多个设备，您必须指定设备的 序列号 ：

如果设备通过 TCP/IP 连接：

您可以同时启动多个 scrcpy 实例以同时显示多个设备的画面。

您可以使用 AutoAdb:

要远程连接到设备，可以将本地的 adb 客户端连接到远程的 adb 服务端 (需要两端的 adb 协议版本相同)：

在另一个终端：

若要不使用远程端口转发，可以强制使用正向连接 (注意 -L 和 -R 的区别)：

在另一个终端:

类似地，对于无线连接，可能需要降低画面质量：

窗口的标题默认为设备型号。可以通过如下命令修改：

您可以指定初始的窗口位置和大小：

禁用窗口边框：

您可以通过如下命令保持窗口在最前面：

您可以通过如下命令直接全屏启动 scrcpy：

全屏状态可以通过 MOD+f 随时切换。

可以通过以下命令旋转窗口：

可选的值有：

也可以使用 MOD+← (左箭头) 和 MOD+→ (右箭头) 随时更改。

需要注意的是， scrcpy 中有三类旋转方向：

禁用电脑对设备的控制 (任何可与设备交互的方式：如键盘输入、鼠标事件和文件拖放)：

如果设备有多个显示屏，可以选择要镜像的显示屏：

可以通过如下命令列出所有显示屏的 id：

控制第二显示屏需要设备运行 Android 10 或更高版本 (否则将在只读状态下镜像)。

阻止设备在连接时一段时间后休眠：

scrcpy 关闭时会恢复设备原来的设置。

可以通过以下的命令行参数在关闭设备屏幕的状态下进行镜像：

或者在任何时候按 MOD+o。

要重新打开屏幕，按下 MOD+Shift+o。

在Android上，电源 按钮始终能把屏幕打开。为了方便，对于在 scrcpy 中发出的 电源 事件 (通过鼠标右键或 MOD+p)，会 (尽最大的努力) 在短暂的延迟后将屏幕关闭。设备上的 电源 按钮仍然能打开设备屏幕。

还可以同时阻止设备休眠：

scrcpy 退出时关闭设备屏幕：

在演示时，可能会需要显示 (在物理设备上的) 物理触摸点。

Android 在 开发者选项 中提供了这项功能。

Scrcpy 提供一个选项可以在启动时开启这项功能并在退出时恢复初始设置：

请注意这项功能只能显示 物理 触摸 (用手指在屏幕上的触摸)。

Scrcpy 默认不会阻止电脑上开启的屏幕保护。

关闭屏幕保护：

使用 MOD+r 在竖屏和横屏模式之间切换。

需要注意的是，只有在前台应用程序支持所要求的模式时，才会进行切换。

每次安卓的剪贴板变化时，其内容都会被自动同步到电脑的剪贴板上。

所有的 Ctrl 快捷键都会被转发至设备。其中：

大多数时候这些按键都会执行以上的功能。

但实际的行为取决于设备上的前台程序。例如，Termux 会在按下 Ctrl+c 时发送 SIGINT，又如 K-9 Mail 会新建一封邮件。

要在这种情况下进行剪切，复制和粘贴 (仅支持 Android >= 7)：

另外，MOD+Shift+v 会将电脑的剪贴板内容转换为一串按键事件输入到设备。在应用程序不接受粘贴时 (比如 Termux)，这项功能可以派上一定的用场。不过这项功能可能会导致非 ASCII 编码的内容出现错误。

警告： 将电脑剪贴板的内容粘贴至设备 (无论是通过 Ctrl+v 还是 MOD+v) 都会将内容复制到设备的剪贴板。如此，任何安卓应用程序都能读取到。您应避免将敏感内容 (如密码) 通过这种方式粘贴。

一些设备不支持通过程序设置剪贴板。通过 --legacy-paste 选项可以修改 Ctrl+v 和 MOD+v 的工作方式，使它们通过按键事件 (同 MOD+Shift+v) 来注入电脑剪贴板内容。

模拟“双指缩放”：Ctrl+按住并移动鼠标。

更准确的说，在按住鼠标左键时按住 Ctrl。直到松开鼠标左键，所有鼠标移动将以屏幕中心为原点，缩放或旋转内容 (如果应用支持)。

实际上，scrcpy 会在关于屏幕中心对称的位置上用“虚拟手指”发出触摸事件。

默认情况下，scrcpy 使用安卓按键或文本注入，这在任何情况都可以使用，但仅限于ASCII字符。

在 Linux 上，scrcpy 可以模拟为 Android 上的物理 USB 键盘，以提供更好地输入体验 (使用 USB HID over AOAv2)：禁用虚拟键盘，并适用于任何字符和输入法。

不过，这种方法仅支持 USB 连接以及 Linux平台。

启用 HID 模式：

如果失败了 (如设备未通过 USB 连接)，则自动回退至默认模式 (终端中会输出日志)。这即允许通过 USB 和 TCP/IP 连接时使用相同的命令行参数。

在这种模式下，原始按键事件 (扫描码) 被发送给设备，而与宿主机按键映射无关。因此，若键盘布局不匹配，需要在 Android 设备上进行配置，具体为 设置 → 系统 → 语言和输入法 → [实体键盘]。

打字的时候，系统会产生两种事件：

程序默认使用按键事件来输入字母。只有这样，键盘才会在游戏中正常运作 (例如 WASD 键)。

但这也有可能造成一些问题。如果您遇到了问题，可以通过以下方式避免：

(这会导致键盘在游戏中工作不正常)

该选项不影响 HID 键盘 (该模式下，所有按键都发送为扫描码)。

默认状态下，按住一个按键不放会生成多个重复按键事件。在某些游戏中这通常没有实际用途，且可能会导致性能问题。

避免转发重复按键事件：

该选项不影响 HID 键盘 (该模式下，按键重复由 Android 直接管理)。

默认状态下，右键会触发返回键 (或电源键开启)，中键会触发 HOME 键。要禁用这些快捷键并把所有点击转发到设备：

将 APK 文件 (文件名以 .apk 结尾) 拖放到 scrcpy 窗口来安装。

不会有视觉反馈，终端会输出一条日志。

要推送文件到设备的 /sdcard/Download/，将 (非 APK) 文件拖放至 scrcpy 窗口。

不会有视觉反馈，终端会输出一条日志。

在启动时可以修改目标目录：

在以下列表中, MOD 是快捷键的修饰键。 默认是 (左) Alt 或 (左) Super。

您可以使用 --shortcut-mod 来修改。可选的按键有 lctrl、rctrl、lalt、ralt、lsuper 和 rsuper。例如：

Super 键通常是指 Windows 或 Cmd 键。

¹双击黑边可以去除黑边。 ²点击鼠标右键将在屏幕熄灭时点亮屏幕，其余情况则视为按下返回键 。 ³鼠标的第4键和第5键。 ⁴需要安卓版本 Android >= 7。

有重复按键的快捷键通过松开再按下一个按键来进行，如“展开设置面板”：

所有的 Ctrl+按键 的快捷键都会被转发到设备，所以会由当前应用程序进行处理。

要使用指定的 adb 二进制文件，可以设置环境变量 ADB：

要覆盖 scrcpy-server 的路径，可以设置 SCRCPY_SERVER_PATH。

要覆盖图标，可以设置其路径至 SCRCPY_ICON_PATH。