本文转载自:android开源投屏工具scrcpy简介
1.初识scrcpy
1.1 scrcpy介绍
首先,我们来认识一下Scrcpy。Scrcpy 是一个开源的命令行工具软件,被设计用于使计算机用户能通过android adb或通过usb数据线控制其Android设备,支持通过鼠标和键盘对Android设备操作,更重要的是无需root权限。
开源地址:https://github.com/Genymobile/scrcpy
1.2 scrcpy特点
免费开源
无需root权限
可以运行在Linux,Window和Mac系统上
可以共享剪贴板
轻量(原生,仅显示设备屏幕)
性能(30~60fps)
质量(分辨率可达1920x1080或更高)
低延迟 (35-70ms)
快速启动(数秒内即能开始显示)
无侵入性(不需要在安卓设备上安装任何程序)
2.scrcpy指令说明
2.1 画面设置
2.1.1 缩小分辨率
有时候,将设备屏幕镜像分辨率降低可以有效地提升性能。我们可以将高度和宽度都限制在一定大小内(如 1024):
scrcpy --max-size 1024
scrcpy -m 1024 // short version
较短的一边会被按比例缩小以保持设备的显示比例。这样,1920x1080的设备会以1024x576的分辨率显示。
2.1.2 修改画面比特率
默认的比特率是8Mbps。如果要改变画面的比特率 (比如说改成2Mbps):
scrcpy --bit-rate 2M
scrcpy -b 2M // short version
2.1.3 限制画面帧率
画面的帧率可以通过下面的命令被限制:
scrcpy--max-fps15
这个功能仅在Android 10和以后的版本被Android官方支持,但也有可能在更早的版本可用。
2.1.4 画面裁剪
设备画面可在裁切后进行镜像,以显示部分屏幕。这项功能可以用于:例如,只显示Oculus Go的一只眼睛。
scrcpy --crop 1224:1440:0:0 // 1224x1440 at offset(0,0)
如果--max-size在同时被指定,分辨率的改变将在画面裁切后进行。
2.1.5 锁定屏幕朝向
scrcpy --lock-video-orientation 0 // 自然朝向
scrcpy --lock-video-orientation 1 // 90° 逆时针旋转
scrcpy --lock-video-orientation 2 // 180°
scrcpy --lock-video-orientation 3 // 90° 顺时针旋转
该设定影响录制。
2.2 屏幕录制
可以在屏幕镜像的同时录制视频:
scrcpy --record file.mp4
scrcpy -r file.mkv
在不开启屏幕镜像的同时录制:
scrcpy --no-display --record file.mp4
scrcpy -Nr file.mkv
// 按Ctrl+C以停止录制
在显示中“被跳过的帧”会被录制,虽然它们由于性能原因没有实时显示。在传输中每一帧都有时间戳 ,所以包时延变化 并不影响录制的文件。
2.3 连接方式
2.3.1 无线
Scrcpy使用adb来与安卓设备连接。同时,adb能够通过TCP/IP连接到安卓设备:
将您的安卓设备和电脑连接至同一Wi-Fi。
获取安卓设备的IP地址(在设置-关于手机-状态信息)。
打开安卓设备的网络adb功能adb tcpip 5555。
将您的设备与电脑断开连接。
连接到您的设备:adb connect DEVICE_IP:5555(用设备IP替换 DEVICE_IP)。
运行scrcpy。
降低比特率和分辨率可能有助于性能:
scrcpy --bit-rate 2M --max-size 800
scrcpy -b2M -m800 # short version
2.3.2 多设备
如果多个设备在执行adb devices后被列出,您必须指定设备的序列号 :
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
您可以同时启动多个scrcpy实例以同时显示多个设备的画面。
2.4 窗口设置
2.4.1 标题
窗口的标题默认为设备型号。您可以通过如下命令修改它:
scrcpy --window-title 'Mydevice'
2.4.2 位置和大小
您可以指定初始的窗口位置和大小:
scrcpy --window-x 100 --window-y 100 --window-width 800 --window-height 600
2.4.3 无边框
关闭边框:
scrcpy --window-borderless
2.4.4 保持窗口在最前面
您可以通过如下命令保持窗口在最前面:
scrcpy --always-on-top
2.4.5 全屏
您可以通过如下命令直接全屏启动scrcpy:
scrcpy --fullscreen
scrcpy -f // short version
全屏状态可以通过MOD+f实时改变。
2.4.6 旋转
通过如下命令,窗口可以旋转:
scrcpy --rotation 1
可选的值有:
0: 无旋转
1: 逆时针旋转90°
2: 旋转180°
3: 顺时针旋转90°
这同样可以使用MOD+← (左) 和 MOD+→ (右) 的快捷键实时更改。需要注意的是, scrcpy 控制三个不同的朝向:
MOD+r 请求设备在竖屏和横屏之间切换(如果前台应用程序不支持所请求的朝向,可能会拒绝该请求)。
--lock-video-orientation 改变镜像的朝向(设备镜像到电脑的画面朝向)。这会影响录制。
--rotation (或MOD+←/MOD+→) 只旋转窗口的画面。这只影响显示,不影响录制。
2.5 其它设置
2.5.1 只读
关闭电脑对设备的控制(如键盘输入、鼠标移动和文件传输):
scrcpy --no-control
scrcpy -n
2.5.2 显示屏
如果有多个显示屏可用,您可以选择特定显示屏进行镜像:
scrcpy --display 1
您可以通过如下命令找到显示屏的id:
adb shell dumpsys display //在回显中搜索“mDisplayId=”
第二显示屏可能只能在设备运行Android 10或以上的情况下被控制(它可能会在电脑上显示,但无法通过电脑操作)。
2.5.3 保持常亮
防止设备在已连接的状态下休眠:
scrcpy --stay-awake
scrcpy -w
程序关闭后,设备设置会恢复原样。
2.5.4 关闭设备屏幕
在启动屏幕镜像时,可以通过如下命令关闭设备的屏幕:
scrcpy --turn-screen-off
scrcpy -S
或者在需要的时候按MOD+o。
要重新打开屏幕的话,需要按MOD+Shift+o.
在Android上,电源按钮始终能把屏幕打开。
为了方便,如果按下电源按钮的事件是通过 scrcpy 发出的(通过点按鼠标右键或MOD+p),它会在短暂的延迟后将屏幕关闭。
物理的电源按钮仍然能打开设备屏幕。
同时,这项功能还能被用于防止设备休眠:
scrcpy --turn-screen-off --stay-awake
scrcpy -Sw
2.5.5 关闭屏保
Scrcpy不会默认关闭屏幕保护。关闭屏幕保护:
scrcpy --disable-screensaver
2.6 文件传输
2.6.1 安装APK
如果您要安装APK,请拖放APK文件(文件名以.apk结尾)到scrcpy窗口。该操作在屏幕上不会出现任何变化,而会在控制台输出一条日志。
2.6.2 将文件推送至设备
如果您要推送文件到设备的/sdcard/,请拖放文件至(不能是APK文件)scrcpy窗口。该操作没有可见的响应,只会在控制台输出日志。在启动时可以修改目标目录:
scrcpy --push-target /sdcard/foo/bar/