GitHub:scrcpy

介绍

  • 轻量: 原生,仅显示设备屏幕
  • 性能: 30~120fps,取决于设备
  • 质量: 分辨率可达 1920×1080 或更高
  • 低延迟: 35~70ms
  • 快速启动: 最快 1 秒内即可显示第一帧
  • 无侵入性: 不会在设备上遗留任何程序
  • 用户利益: 无需帐号,无广告,无需联网
  • 自由: 自由和开源软件
  • 要求:
    • 安卓设备最低需要支持 API 21 (Android 5.0)。
    • 确保设备已开启 adb 调试

连接

1.有线连接电脑和手机

- 将下载的资源解压到任意目录

- 将手机与电脑用USB连接, USB连接方式选择传输文件

- 打开手机开发者模式,在设置内进入开发人员选项并打开USB调试功能

- 在资源解压目录进入cmd

- 输入命令 adb devices,可以看到已连接手机

- 输入命令 scrcpy.exe ,即可成功投屏

2.无线连接

- 确保你的电脑和手机在同一局域网中,查看手机ip信息(设置 ==》 关于手机 ==》 状态信息 ==》 IP地址 [若未找到,请根据手机品牌自行百度])

- 测试连接: 在命令行中输入 ping DEVICE_IP (DEVICE_IP 为设备 IP),若数据包发送成功,则说明在同一局域网下

- 输入命令 adb tcpip 5555 (设置监听端口),回车

- 输入命令 adb connect DEVICE_IP:5555 (将 DEVICE_IP 替换为设备 IP) 连接到您的设备,回车

- 输入命令 scrcpy.exe ,投屏成功
(1)自动配置
- 参数 --tcpip 允许自动配置连接。这里有两种方式

- 对于传入的 adb 连接,如果设备(示例ip:192.168.1.1)已经监听了一个端口(通常是5555),运行:
- scrcpy --tcpip=192.168.1.1       # 默认端口是5555
- scrcpy --tcpip=192.168.1.1:5555

- 如果adb TCP/IP(无线) 模式在某些设备上不被启用(或者你不知道IP地址),用USB连接设备,然后运行:
- scrcpy --tcpip    # 无需其他参数
- 这将会自动寻找设备IP地址,启用TCP/IP模式,然后在启动之前连接到设备。

其他

1.屏幕设置

降低分辨率

1
2
3
4
#通过降低镜像的分辨率来提高性能,要同时限制宽度和高度到某个值 (例如 1024):
scrcpy --max-size 1024
scrcpy -m 1024 # 简写
#另一边会被按比例缩小以保持设备的显示比例

修改码率

1
2
3
#默认码率是 8 Mbps。改变视频码率 (例如改为 2 Mbps):
scrcpy --bit-rate 2M
scrcpy -b 2M # 简写

限制帧率

1
2
#要限制采集的帧率:
scrcpy --max-fps 15

画面裁剪

1
2
3
4
#可以对设备屏幕进行裁剪,只镜像屏幕的一部分
#如果同时指定了 --max-size,会先进行裁剪,再进行缩放

scrcpy --crop 1224:1440:0:0 # 以 (0,0) 为原点的 1224x1440 像素

锁定屏幕方向

1
2
3
4
5
scrcpy --lock-video-orientation     # 初始(目前)方向
scrcpy --lock-video-orientation=0 # 自然方向
scrcpy --lock-video-orientation=1 # 逆时针旋转 90°
scrcpy --lock-video-orientation=2 # 180°
scrcpy --lock-video-orientation=3 # 顺时针旋转 90°

2.多设备

1
2
3
4
5
6
7
8
#如果 adb devices 列出了多个设备,您必须指定设备的 序列号
scrcpy --serial 0123456789abcdef
scrcpy -s 0123456789abcdef # 简写

#如果设备通过 TCP/IP 连接:
scrcpy --serial 192.168.0.1:5555
scrcpy -s 192.168.0.1:5555 # 简写

3.窗口设置

标题

1
2
#窗口的标题默认为设备型号。可以通过如下命令修改:
scrcpy --window-title "我的设备"

位置和大小

1
2
#指定初始的窗口位置和大小:
scrcpy --window-x 100 --window-y 100 --window-width 800 --window-height 600

窗口置顶

1
scrcpy --always-on-top

屏幕旋转

1
2
# 0: 无旋转 1: 逆时针旋转 90° 2: 旋转 180° 3: 顺时针旋转 90°
scrcpy --rotation 1

关闭设备屏幕

1
2
scrcpy --turn-screen-off
scrcpy -S

快捷键

在以下列表中, MOD 是快捷键的修饰键。 默认是 (左) Alt 或 (左) Super
(Super 键通常是指 Windows 或 Cmd 键)
您可以使用 –shortcut-mod 来修改。可选的按键有 lctrl、rctrl、lalt、ralt、lsuper 和 rsuper

1
2
3
4
5
# 使用右 Ctrl 键
scrcpy --shortcut-mod=rctrl

# 使用左 Ctrl 键 + 左 Alt 键,或 Super 键
scrcpy --shortcut-mod=lctrl+lalt,lsuper
操作 快捷键
全屏 MOD + f
向左旋转屏幕 MOD + ← (左箭头)
向右旋转屏幕 MOD + → (右箭头)
将窗口大小重置为1:1 (匹配像素) MOD + g
将窗口大小重置为消除黑边 MOD + w / 双击左键¹
点按 主屏幕 MOD + h / 中键
点按 返回 MOD + b / 右键²
点按 切换应用 MOD + s / 第4键³
点按 菜单 (解锁屏幕)⁴ MOD + m
点按 音量 + MOD + ↑ (上箭头)
点按 音量- MOD + ↓ (下箭头)
点按 电源 MOD + p
打开屏幕 鼠标右键²
关闭设备屏幕 (但继续在电脑上显示) MOD + o
旋转设备屏幕 MOD + r
展开通知面板 MOD + n / 第5键³
展开设置面板 MOD + n + n / 双击第5键³
收起通知面板 MOD + Shift + n
复制到剪贴板⁵ MOD + c
剪切到剪贴板⁵ MOD + x
同步剪贴板并粘贴⁵ MOD + v
注入电脑剪贴板文本 MOD + Shift + v
打开/关闭FPS显示 (至标准输出) MOD + i
捏拉缩放 Ctrl + 按住并移动鼠标
拖放 APK 文件 从电脑安装 APK 文件
拖放非 APK 文件 将文件推送至设备

¹双击黑边可以去除黑边。
²点击鼠标右键将在屏幕熄灭时点亮屏幕,其余情况则视为按下返回键 。
³鼠标的第4键和第5键。
⁴对于开发中的 react-native 应用程序,MENU 触发开发菜单。
⁵需要安卓版本 Android >= 7。

有重复按键的快捷键通过松开再按下一个按键来进行