Escrcpy命令行帮助文档：参数说明与示例

Escrcpy是一款使用图形化界面显示和控制Android设备的工具，基于Scrcpy核心功能，由Electron驱动。本文档详细介绍Escrcpy的命令行参数、使用方法及示例，帮助用户高效配置设备镜像、连接方式和性能优化。

基础参数

设备选择

当多个设备连接时，需通过序列号指定目标设备：

# 通过序列号连接
scrcpy --serial=0123456789abcdef
scrcpy -s 0123456789abcdef  # 简写形式

# 通过TCP/IP连接（设备IP:端口）
scrcpy --serial=192.168.1.1:5555

设备序列号可通过adb devices命令获取，或设置环境变量ANDROID_SERIAL自动选择。详细连接方式参见连接文档。

视频配置

调整视频传输参数以平衡画质与性能：

# 限制最大分辨率（宽或高，保持比例）
scrcpy --max-size=1024
scrcpy -m 1024  # 简写

# 设置视频比特率（默认8Mbps）
scrcpy --video-bit-rate=2M
scrcpy -b 2M    # 简写

# 限制帧率
scrcpy --max-fps=30

视频参数配置逻辑可参考视频文档，包含编解码器选择、方向调整等高级选项。

连接方式

USB连接

直接通过USB连接设备（需开启USB调试）：

scrcpy  # 自动检测单个设备

无线连接

通过TCP/IP实现无线镜像，支持自动配置与手动连接：

# 自动发现并连接（需先USB连接）
scrcpy --tcpip

# 手动指定IP连接
scrcpy --tcpip=192.168.1.1:5555

详细步骤参见TCP/IP连接指南。

高级功能

快捷键自定义

修改默认快捷键修饰键（默认左Alt或左Super）：

# 使用右Ctrl作为修饰键
scrcpy --shortcut-mod=rctrl

# 同时支持左Ctrl和左Super
scrcpy --shortcut-mod=lctrl,lsuper

完整快捷键列表见快捷键文档，包含窗口控制、设备操作等常用功能。

视频录制

实时录制设备屏幕并保存为文件：

# 录制MP4格式
scrcpy --record=output.mp4

# 录制并禁用屏幕显示
scrcpy --record=output.mkv --no-playback

录制参数可配合视频比特率、帧率等选项调整，详见录制文档。

画面调整

裁剪、旋转或翻转视频画面：

# 裁剪屏幕区域（宽:高:x:y）
scrcpy --crop=1080:1920:0:0

# 旋转画面（顺时针90度）
scrcpy --orientation=90

# 水平翻转
scrcpy --orientation=flip0

画面变换参数说明参见视频方向配置。

实用示例

低延迟模式

优化参数以降低镜像延迟，适用于游戏等实时操作：

scrcpy --max-size=720 --video-bit-rate=4M --max-fps=60

多设备管理

同时连接多个设备并指定不同窗口位置：

scrcpy -s device1 --window-x=0 --window-y=0 &
scrcpy -s device2 --window-x=500 --window-y=0 &

无线投屏+录制

通过WiFi连接设备并后台录制：

scrcpy --tcpip=192.168.1.1 --record=meeting.mp4 --no-audio-playback

参数速查表

类别	参数	说明
连接	-s, --serial	设备序列号或IP:端口
视频	-m, --max-size	最大分辨率（如1024）
视频	-b, --video-bit-rate	比特率（如2M）
控制	--shortcut-mod	快捷键修饰键（如lctrl）
录制	--record=<file>	录制文件路径
显示	--window-x, --window-y	窗口位置坐标

完整参数列表可通过scrcpy --help命令查看，或参考官方参数文档。