捕获配置
缩小尺寸
有时，以较低的清晰度镜像 Android 设备以提高性能很有用。
将宽度和高度限制为某个值（例如 1024）：
scrcpy --max-size 1024 scrcpy -m 1024 #短版
计算另一个维度以保留设备纵横比。这样，1920×1080 的设备将以 1024×576 镜像。
更改比特率
默认比特率为 8 Mbps。要更改视频比特率（例如，更改为 2 Mbps）：
scrcpy --bit-rate 2M scrcpy -b 2M #短版
限制帧率
可以限制捕获帧速率：
scrcpy --max-fps 15
自 Android 10 起正式支持此功能，但可能适用于较早版本。
庄稼
设备屏幕可能会被裁剪以仅镜像屏幕的一部分。
例如，这对于仅镜像 Oculus Go 的一只眼睛很有用：
scrcpy --crop 1224:1440:0:0 # 1224x1440 偏移 (0,0)
如果--max-size还指定了，则在裁剪后应用调整大小。
锁定视频方向
要锁定镜像的方向：
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° 顺时针
这会影响记录方向。
该窗口也可以被转动独立地。
编码器
有些设备有多个编码器，其中一些可能会导致问题或崩溃。可以选择不同的编码器：
scrcpy --encoder OMX.qcom.video.encoder.avc
要列出可用的编码器，您可以传递一个无效的编码器名称，错误将给出可用的编码器：
scrcpy --encoder _
捕获
记录
可以在镜像时录制屏幕：
scrcpy --record file.mp4 scrcpy -r 文件.mkv
要在录制时禁用镜像：
scrcpy --no-display --record file.mp4 scrcpy -Nr 文件.mkv #使用 Ctrl+C 中断录制
“跳过的帧”会被记录下来，即使它们不是实时显示的（出于性能原因）。帧在设备上带有时间戳，因此数据包延迟变化不会影响录制的文件。
v4l2环回
在 Linux 上，可以将视频流发送到 v4l2 环回设备，以便任何支持 v4l2 的工具都可以像网络摄像头一样打开 Android 设备。
v4l2loopback必须安装该模块：
sudo apt install v4l2loopback-dkms
创建 v4l2 设备：
须藤 modprobe v4l2loopback
这将在 中创建一个新的视频设备/dev/videoN，其中N是一个整数（更多选项可用于创建多个设备或具有特定 ID 的设备）。
列出启用的设备：
#需要 v4l-utils 包 v4l2-ctl --list-devices #简单但可能足够了 ls /dev/video *
要使用 v4l2 接收器启动 scrcpy：
scrcpy --v4l2-sink=/dev/videoN scrcpy --v4l2-sink=/dev/videoN --no-display #禁用镜像窗口 scrcpy --v4l2-sink=/dev/videoN -N #短版
（用N设备 ID替换，用 核对ls /dev/video*）
启用后，您可以使用支持 v4l2 的工具打开视频流：
ffplay -i /dev/videoN vlc v4l2:///dev/videoN # VLC 可能会增加一些缓冲延迟
例如，您可以在OBS 中捕获视频。
联系
无线的
Scrcpy用于adb与设备通信，adb可以通过 TCP/IP连接到设备：
-
将设备连接到与计算机相同的 Wi-Fi。
-
获取您的设备 IP 地址，在设置 → 关于手机 → 状态，或通过执行以下命令：
adb shell ip 路由| awk ' {打印 $9} ' -
您的设备上启用TCP / IP ADB：
adb tcpip 5555。 -
拔下您的设备。
-
连接到您的设备：
adb connect DEVICE_IP:5555(替换DEVICE_IP)。 -
scrcpy像往常一样跑。
降低比特率和定义可能很有用：
scrcpy --bit-rate 2M --max-size 800 scrcpy -b2M -m800 #短版
多设备
如果在 中列出了多个设备，则adb devices必须指定串行：
scrcpy --serial 0123456789abcdef scrcpy -s 0123456789abcdef #短版
如果设备通过 TCP/IP 连接：
scrcpy --serial 192.168.0.1:5555 scrcpy -s 192.168.0.1:5555 #短版
您可以为多个设备启动多个scrcpy实例。
设备连接时自动启动
您可以使用AutoAdb：
autoadb scrcpy -s ' {} '
SSH隧道
要连接到远程设备，可以将本地adb客户端连接到远程adb服务器（前提是它们使用相同版本的adb 协议）：
adb kill-server #杀死 5037 上的本地 adb 服务器 ssh -CN -L5037:localhost:5037 -R27183:localhost:27183 your_remote_computer #保持打开状态
从另一个终端：
scrcpy
为避免启用远程端口转发，您可以改为强制转发连接（注意-L代替-R）：
adb kill-server #杀死 5037 上的本地 adb 服务器 ssh -CN -L5037:localhost:5037 -L27183:localhost:27183 your_remote_computer #保持打开状态
从另一个终端：
scrcpy --force-adb-forward
与无线连接一样，降低质量可能很有用：
scrcpy -b2M -m800 --max-fps 15
窗口配置
标题
默认情况下，窗口标题是设备型号。它可以改变：
scrcpy --window-title '我的设备'
位置和尺寸
可以指定初始窗口位置和大小：
scrcpy --window-x 100 --window-y 100 --window-width 800 --window-height 600
无边界
要禁用窗口装饰：
scrcpy --window-borderless
总在最前面
要使 scrcpy 窗口始终在最上面：
scrcpy --always-on-top
全屏
该应用程序可以直接全屏启动：
scrcpy --fullscreen scrcpy -f #短版
然后可以使用MOD+动态切换全屏f。
回转
窗口可以旋转：
scrcpy --rotation 1
可能的值是：
-
0: 没有旋转 -
1: 逆时针 90 度 -
2: 180 度 -
3: 顺时针 90 度
旋转也可以通过MOD+ ← (left)和MOD+ → (right)动态改变。
请注意，scrcpy管理 3 种不同的旋转：
- MOD+r请求设备在纵向和横向之间切换（当前运行的应用程序可能会拒绝，如果它不支持请求的方向）。
-
--lock-video-orientation更改镜像方向（从设备发送到计算机的视频的方向）。这会影响录制。 -
--rotation（或MOD+ ←/ MOD+ →）仅旋转窗口内容。这仅影响显示，不影响录音。
其他镜像选项
只读
要禁用控件（可以与设备交互的所有内容：输入键、鼠标事件、拖放文件）：
scrcpy --no-control scrcpy -n
展示
如果有多个显示器可用，则可以选择要镜像的显示器：
scrcpy --display 1
可以通过以下方式检索显示 ID 列表：
adb shell dumpsys display #在输出中搜索“mDisplayId=”
只有在设备至少运行 Android 10 时才能控制辅助显示器（否则它会以只读方式镜像）。
保持清醒
为了防止设备在插入设备时延迟一段时间后进入睡眠状态：
scrcpy --保持清醒 scrcpy -w
scrcpy 关闭时恢复初始状态。
关闭屏幕
可以使用命令行选项在启动镜像时关闭设备屏幕：
scrcpy --turn-screen-off scrcpy -S
或者随时按MOD+ o。
要重新打开它，请按MOD+ Shift+ o。
在 Android 上，该POWER按钮始终打开屏幕。为方便起见，如果 POWER通过 scrcpy 发送（通过右键单击或MOD+ p），它将在一小段延迟后强制关闭屏幕（尽最大努力）。物理POWER按钮仍然会导致屏幕打开。
防止设备休眠也很有用：
scrcpy --turn-screen-off --stay-awake scrcpy -Sw
显示触摸
对于演示，显示物理接触（在物理设备上）可能很有用。
Android 在Developers options 中提供了此功能。
Scrcpy提供了一个选项，可以在启动时启用此功能并在退出时恢复初始值：
scrcpy --show-touches scrcpy -t
请注意，它仅显示物理触摸（手指在设备上）。
禁用屏幕保护程序
默认情况下，scrcpy 不会阻止屏幕保护程序在计算机上运行。
要禁用它：
scrcpy --disable-screensaver
输入控制
旋转设备屏幕
按MOD+r在纵向和横向模式之间切换。
请注意，只有在前台应用程序支持请求的方向时，它才会旋转。
复制粘贴
每当 Android 剪贴板发生变化时，它都会自动同步到计算机剪贴板。
任何Ctrl快捷方式都会转发到设备。特别是：
- Ctrl+c通常复制
- Ctrl+x通常削减
- Ctrl+v通常粘贴（在计算机到设备剪贴板同步之后）
这通常按您的预期工作。
但实际行为取决于活动应用程序。例如， Termux 会在Ctrl+上发送 SIGINT c，而K-9 Mail 会 撰写一条新消息。
在这种情况下复制、剪切和粘贴（但仅在 Android >= 7 上支持）：
-
MOD+c注射
COPY -
MOD+x注射
CUT -
MOD+v注入
PASTE（在计算机到设备剪贴板同步之后）
此外，MOD+ Shift+v允许注入计算机剪贴板中的文本为重点的一系列事件。当组件不接受文本粘贴（例如在Termux 中）时，这很有用，但它可以破坏非 ASCII 内容。
警告：将计算机剪贴板粘贴到设备（通过 Ctrl+v或MOD+ v）会将内容复制到设备剪贴板中。因此，任何 Android 应用程序都可以读取其内容。您应该避免以这种方式粘贴敏感内容（如密码）。
以编程方式设置设备剪贴板时，某些设备的行为不符合预期。--legacy-paste提供了一个选项来更改Ctrl+v和MOD+的行为，v以便它们也将计算机剪贴板文本作为关键事件序列（与MOD+ Shift+相同的方式v）注入。
双指缩放
模拟“双指缩放”：Ctrl+ click-and-move。
更准确地说，按住Ctrl左键单击按钮。在释放左键单击按钮之前，所有鼠标移动都会相对于屏幕中心缩放和旋转内容（如果应用程序支持）。
具体来说，scrcpy 在屏幕中心反转的位置从“虚拟手指”生成额外的触摸事件。
文本注入首选项
键入文本时会生成两种事件：
- 按键事件，表示按键被按下或释放；
- 文本事件，表示已输入文本。
默认情况下，使用按键事件注入字母，以便键盘在游戏中按预期运行（通常用于 WASD 键）。
但这可能会导致问题。如果遇到此类问题，可以通过以下方式避免：
scrcpy --prefer-text
（但这会破坏游戏中的键盘行为）
键重复
默认情况下，按住某个键会生成重复的键事件。这可能会在某些游戏中导致性能问题，而这些事件无论如何都是无用的。
为避免转发重复的关键事件：
scrcpy --no-key-repeat
右键单击和中键单击
默认情况下，右键单击触发 BACK（或开机），中键单击触发 HOME。要禁用这些快捷方式并将点击转发到设备，请执行以下操作：
scrcpy --forward-all-clicks
文件拖放
安装 APK
要安装 APK，请将 APK 文件（以 结尾.apk）拖放到scrcpy 窗口。
没有视觉反馈，日志打印到控制台。
推送文件到设备
要将文件推送到/sdcard/Download/设备上，请将（非 APK）文件拖放到scrcpy窗口。
没有视觉反馈，日志打印到控制台。
目标目录可以在启动时更改：
scrcpy --push-target=/sdcard/电影/
音频转发
scrcpy不转发音频。使用sndcpy。
另请参阅问题 #14。
快捷方式
在下面的列表中，MOD是快捷方式修饰符。默认情况下，它是 (left)Alt或 (left) Super。
可以使用 进行更改--shortcut-mod。可能的键lctrl，rctrl， lalt，ralt，lsuper和rsuper。例如：
#使用 RCtrl 作为快捷方式 scrcpy --shortcut-mod=rctrl #使用 LCtrl+LAlt 或 LSuper 作为快捷方式 scrcpy --shortcut-mod=lctrl+lalt,lsuper
Super通常是Windows或Cmd键。
| 行动 | 捷径 |
|---|---|
| 切换全屏模式 | MOD+f |
| 向左旋转显示 | MOD+ ← （左） |
| 向右旋转显示 | MOD+ → （右） |
| 将窗口大小调整为 1:1（像素完美） | MOD+g |
| 调整窗口大小以移除黑色边框 | MOD+ w| 双击左键¹ |
点击 HOME
|
MOD+ h| 中键单击 |
点击 BACK
|
MOD+ b| 右键单击² |
点击 APP_SWITCH
|
MOD+ s| 第四次点击³ |
点击MENU（解锁屏幕） |
MOD+m |
点击 VOLUME_UP
|
MOD+ ↑ （向上） |
点击 VOLUME_DOWN
|
MOD+ ↓ （下） |
点击 POWER
|
MOD+p |
| 打开 | 右键单击² |
| 关闭设备屏幕（保持镜像） | MOD+o |
| 打开设备屏幕 | MOD+ Shift+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+点击并移动 |
¹双击黑色边框将其删除。
²如果屏幕已关闭，则右键单击可打开屏幕，否则按 BACK。
³第 4 和第 5 个鼠标按钮（如果您的鼠标有这些按钮）。
⁴仅适用于 Android >= 7。
带有重复键的快捷方式通过松开并再次按下该键来执行。例如，要执行“扩展设置面板”：
- 按住MOD。
- 然后双击n。
- 最后，释放MOD。
所有Ctrl+键的快捷方式被转发到该设备，所以它们被激活的应用程序来处理。
自定义路径
要使用特定的adb二进制文件，请在环境变量中配置其路径 ADB：
ADB=/path/to/adb scrcpy
要覆盖scrcpy-server文件的路径，请在 SCRCPY_SERVER_PATH.