scrcpy控制Android

scrcpy是提供了通过USB或者TCP/IP连接Android设备的应用程序，可以工作在Linux, Windows, macOS上:

  • 请谅解(原生，只显示设备屏幕)

  • 性能(达到30~60fps)

  • 显示质量(1920x1080或更高)

  • 低延迟(35~70ms)

  • 快速启动(小于1s)

  • 无需root设备

scrcpy要求Android设备支持API 21(Android 5.0)，并确保设备激活了adb debugging

../../_images/scrcpy.jpg

安装scrcpy

Linux

在Debian(testing和sid)和Ubuntu(20.04):

apt install scrcpy

此外也可通过 snap 包方式安装 snap包scrcpy

Arch Linux需要通过 Arch Linux AUR 安装 scrcpy

甚至可以通过 源代码编译安装scrcpy

Windows

  • 可以直接下载 scrcpy-win64-v1.14.zip - 请在官网下载最新版本

  • 或者通过 Chocolatey 安装:

    choco install scrcpy
choco install adb

  • 或者通过 Scoop 安装:

    scoop install scrcpy
scoop install adb

macOS

  • 建议通过 Homebrew 安装:

    brew install scrcpy

  • 如果系统没有安装adb，则可以安装:

    brew cask install android-platform-tools

运行

  • 连接Android设备，然后执行:

    scrcpy

默认情况下，可以通过较低的分辨率来提高信工，例如限制高宽1024:

scrcpy --max-size 1024
scrcpy -m 1024

  • 修改bit率

默认bit率是8Mbps，也可以降低视频bit率，例如降低到2Mbps:

scrcpy --bit-rate 2M
scrcpy -b 2M

  • 限制帧数

例如限制帧数15fps:

scrcpy --max-fps 15

上述限制帧数需要Android 10支持

  • 截屏

    scrcpy –crop 1224:1440:0:0 # 1224x1440 at offset (0,0)

  • 锁定视频方向:

    scrcpy --lock-video-orientation 0   # natural orientation
scrcpy --lock-video-orientation 1   # 90° counterclockwise
scrcpy --lock-video-orientation 2   # 180°
scrcpy --lock-video-orientation 3   # 90° clockwise

  • 录屏

可以在镜像屏幕时候录屏:

scrcpy --record file.mp4
scrcpy -r file.mkv

要在录屏时候禁止镜像:

scrcpy --no-display --record file.mp4
scrcpy -Nr file.mkv
# interrupt recording with Ctrl+C

连接

scrcpy使用adb和设备通讯，而adb可以通过TCP/IP和设备连接

  • 将设备和电脑连接到相同Wi-Fi

  • 获取设备IP地址： Settings => About phone => Status

  • 在设备上激活adb over TCP/IP:

    adb tcpip 5555

  • 断开设备的USB连接

  • 通过以下命令以TCP/IP方式连接设备，注意这里DEVICE_IP需要替换成实际IP地址:

    adb connect DEVICE_IP:5555

  • 运行scrcpy，可能需要降低比特率:

    scrcpy --bit-rate 2M --max-size 800
scrcpy -b2M -m800  # short version

多设备连接

  • 如果adb显示多个是被，需要指定serial:

    scrcpy --serial 0123456789abcdef
scrcpy -s 0123456789abcdef  # short version

  • 如果设备通过TCP/IP:

    scrcpy --serial 192.168.0.1:5555
scrcpy -s 192.168.0.1:5555  # short version

  • 自动启动设备连接，需要使用 AutoAdb

    autoadb scrcpy -s '{}'

SSH tunnel

要连接远程设备，可以通过本地 adb 客户端连接远程 adb 服务器（需要使用相同的adb协议）:

adb kill-server    # kill the local adb server on 5037
ssh -CN -L5037:localhost:5037 -R27183:localhost:27183 your_remote_computer
# keep this open

然后在另一个终端窗口输入:

scrcpy

要避免激活远程端口转发，需要强制一个转发连接（注意使用 -L 替换 -R ):

adb kill-server    # kill the local adb server on 5037
ssh -CN -L5037:localhost:5037 -L27183:localhost:27183 your_remote_computer
# keep this open

然后在另一个窗口执行:

scrcpy --force-adb-forwrad

类似无线连接，可以降低图形质量提高性能:

scrcpy -b2M -m800 --max-fps 15

窗口配置

标题

默认窗口标题是设备型号，可以修改:

scrcpy --window-title 'My device'

位置和大小

初始窗口位置和大小可以指定:

scrcpy --window-x 100 --window-y 100 --window-width 800 --window-height 600

边框

可以关闭窗口边框:

scrcpy --window-borderless

始终在最上面

可以将scrcpy窗口始终保持在最上面:

scrcpy --window-borderless

全屏

可以在启动时就全屏:

scrcpy --fullscreen
scrcpy -f  # short version

或者通过快捷键切换全屏: Ctrl+f

旋转

窗口可以选装:

scrcpy --rotation 1

通过以下值指定选装:

0: no rotation
1: 90 degrees counterclockwise
2: 180 degrees
3: 90 degrees clockwise

可以通过 Ctrl + ← (左方向键) 和 Ctrl + → (右方向键)

只读

可以禁止控制，即不通过键盘鼠标操作:

scrcpy --no-control
scrcpy -n

显示

如果有多个显示器，可以指定显示屏幕:

scrcpy --display 1

以下命令可以显示屏幕id:

adb shell dumpsys display   # search "mDisplayId=" in the output

保持唤醒

防止设备进入睡眠:

scrcpy --stay-awake
scrcpy -w

关闭屏幕

可以在镜像屏幕时关闭设备屏幕:

scrcpy --turn-screen-off
scrcpy -S

或者通过 Ctrl + o 关闭。

也可以恢复屏幕 Ctrl + Shift + o

通常结合避免设备睡眠:

scrcpy --turn-screen-off --stay-awake
scrcpy -Sw

绘制过期帧

默认情况，为了降低延迟，scrcpy总是只绘制最后解码的帧，并丢弃之前的帧。为了强制绘制所有帧（会导致明显的延迟），则使用:

scrcpy --render-expired-frames

显示触摸

为了演示，通常显示物理触摸（在物理设备上操作）非常有用，这是Android提供的开发者选项:

scrcpy --show-touches
scrcpy -t

注意，这个只显示物理接触（即手指在设备上操作）。

输入控制

  • 旋转设备屏幕： 按下 Ctrl + r 旋转

  • 复制粘贴:

    Ctrl+c copies the device clipboard to the computer clipboard;
Ctrl+Shift+v copies the computer clipboard to the device clipboard (and pastes if the device runs Android >= 7);
Ctrl+v pastes the computer clipboard as a sequence of text events (but breaks non-ASCII characters).

文字输入

有两种输入文字的事件：

  • key events, signaling that a key is pressed or released;

  • text events, signaling that a text has been entered.

文件投递

安装APK

要安装APK，只需要将APK文件拖放到scrcpy窗口就可以。没有视觉反馈，只是在控制台打印日志。

推送文件到设备

要将文件传输到 /sdcard/ 目录，只需要将非APK文件拖放到scrcpy窗口。

音频转发

scrcpy不支持音频转发，需要使用 USBaudio （只支持Linux）。

参考